serp_rank

Compruebe en qué posición se ubica un dominio en los resultados orgánicos de Google para una keyword: la posición real en la SERP, no el orden de Custom Search. Devuelve la posición orgánica del target, la URL que posiciona y todas las posiciones que ocupa. Con la tecnología de DataForSEO.

Casos de uso

Seguimiento de posiciones por keyword

Monitoree en qué posición se ubican sus páginas para sus keywords objetivo a lo largo del tiempo y detecte caídas de posición a tiempo

Monitoreo de la SERP de competidores

Rastree cómo se posicionan los dominios de la competencia para las keywords que importan a su negocio

Auditorías de posiciones SEO

Audite las posiciones orgánicas de una lista de keywords para priorizar el trabajo on-page y de contenido

Comprobaciones de SEO local y por dispositivo

Compare las posiciones por location y por desktop frente a mobile para detectar brechas geográficas o por dispositivo

Dashboards de seguimiento de posiciones

Alimente sus propios dashboards y pipelines de reporting con posiciones orgánicas diarias

Endpoint

POST/api/v1/tools/serp_rank

Auth Required

1 req/s en el plan Free

5 credits

Parameters

Name	Type	Required	Default	Description
keyword	string	Required	-	La consulta de búsqueda para la que comprobar la posición Example: managed wordpress hosting
target	string	Required	-	Dominio o URL que se localizará en los resultados Example: example.com
depth	number	Optional	100	Cuántos resultados analizar (10-200; 100 = 1 página de costo) Example: 100
device	string	Optional	desktop	Dispositivo a emular: "desktop" o "mobile" Example: mobile
location_name	string	Optional	United States	Ubicación, p. ej. 'United States' o 'London,England,United Kingdom' Example: United States
location_code	number	Optional	-	Código numérico de ubicación de DataForSEO (tiene prioridad sobre location_name) Example: 2840
language_code	string	Optional	en	Código de idioma (p. ej. 'en') Example: en

serp_rank mide la posición orgánica real, no el orden de Custom Search. depth controla cuántos resultados se analizan: 100 resultados equivalen a una página de costo. Use location_name/location_code y device para comprobar posiciones específicas por geografía y por dispositivo.

Ejemplos de solicitud

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "depth": 100,
    "device": "desktop",
    "location_name": "United States",
    "language_code": "en"
  }'

Ejemplo de respuesta

200 OK1,450ms

{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 100,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 100,
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1450
}

Field Descriptions

data.rankMejor posición orgánica (null si el target no se encuentra dentro de depth)

data.urlLa URL que ocupa la mejor posición

data.all_positionsTodas las posiciones orgánicas que ocupa el target dentro de la depth analizada

data.foundSi el target apareció dentro de la depth analizada

credits_used5 credits fijos por consulta (100 resultados = 1 página de costo)

processing_timeLas consultas normalmente se completan en 1-2 segundos

Manejo de errores

Falta keyword o target (400 Bad Request)

Tanto keyword como target son obligatorios. Proporcione una consulta de búsqueda y un dominio o URL.

Depth no válido (400 Bad Request)

depth debe estar entre 10 y 200. Los valores de depth más altos analizan más resultados.

Device no válido (400 Bad Request)

device debe ser "desktop" o "mobile".

Cuota excedida (429 Too Many Requests)

El proveedor de SERP aplica límites diarios. Actualice su plan para obtener cuotas más altas.

Tiempo de espera del proveedor (504 Gateway Timeout)

La consulta SERP se ejecuta en vivo en Google y puede superar el límite de tiempo con mucha carga. No se cobran créditos: vuelve a intentarlo.

Consulta no disponible (502 / 503)

El proveedor SERP no está disponible, ha alcanzado su límite de peticiones o no está configurado en este despliegue. No se cobran créditos.

Consejo profesional: Pase un dominio simple (example.com) como target para coincidir con todas las URLs que posicionan de ese dominio. Use location_code para una segmentación geográfica precisa cuando el nombre de una ubicación sea ambiguo.

Costo en credits

5 credits

5 credits por consulta

Costo fijo por analizar hasta 100 resultados. Los credits se cobran solo por las consultas exitosas.

Qué incluye:

Posición orgánica real en la SERP (no el orden de Custom Search)

URL que posiciona y todas las posiciones que ocupa el target

Segmentación por ubicación e idioma

Emulación de dispositivo desktop y mobile

depth de hasta 200 resultados

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = 200 consultas

Plan Hobby: 5,000 credits = 1,000 consultas ($19/mo)

Plan Professional: 50,000 credits = 10,000 consultas ($99/mo)

Herramientas relacionadas

search_web

Busque en Google y obtenga resultados estructurados de la SERP (5 credits)

track_changes

Monitoree cambios en las páginas que posicionan a lo largo del tiempo (3 credits)

analyze_content

Analice las páginas que posicionan en busca de temas y legibilidad (3 credits)

deep_research

Investigación multifuente con análisis de IA (10 credits)

¿Listo para probar serp_rank? Regístrese gratis y obtenga 1,000 credits para empezar a rastrear sus posiciones.

Casos de uso

Seguimiento de posiciones por keyword

Monitoree en qué posición se ubican sus páginas para sus keywords objetivo a lo largo del tiempo y detecte caídas de posición a tiempo

Monitoreo de la SERP de competidores

Rastree cómo se posicionan los dominios de la competencia para las keywords que importan a su negocio

Auditorías de posiciones SEO

Audite las posiciones orgánicas de una lista de keywords para priorizar el trabajo on-page y de contenido

Comprobaciones de SEO local y por dispositivo

Compare las posiciones por location y por desktop frente a mobile para detectar brechas geográficas o por dispositivo

Dashboards de seguimiento de posiciones

Alimente sus propios dashboards y pipelines de reporting con posiciones orgánicas diarias

Parameters

Name	Type	Required	Default	Description
keyword	string	Required	-	La consulta de búsqueda para la que comprobar la posición Example: managed wordpress hosting
target	string	Required	-	Dominio o URL que se localizará en los resultados Example: example.com
depth	number	Optional	100	Cuántos resultados analizar (10-200; 100 = 1 página de costo) Example: 100
device	string	Optional	desktop	Dispositivo a emular: "desktop" o "mobile" Example: mobile
location_name	string	Optional	United States	Ubicación, p. ej. 'United States' o 'London,England,United Kingdom' Example: United States
location_code	number	Optional	-	Código numérico de ubicación de DataForSEO (tiene prioridad sobre location_name) Example: 2840
language_code	string	Optional	en	Código de idioma (p. ej. 'en') Example: en

Ejemplos de solicitud

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "depth": 100,
    "device": "desktop",
    "location_name": "United States",
    "language_code": "en"
  }'

Ejemplo de respuesta

200 OK1,450ms

{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 100,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 100,
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 1450
}

Field Descriptions

data.rankMejor posición orgánica (null si el target no se encuentra dentro de depth)

data.urlLa URL que ocupa la mejor posición

data.all_positionsTodas las posiciones orgánicas que ocupa el target dentro de la depth analizada

data.foundSi el target apareció dentro de la depth analizada

credits_used5 credits fijos por consulta (100 resultados = 1 página de costo)

processing_timeLas consultas normalmente se completan en 1-2 segundos

Manejo de errores

Falta keyword o target (400 Bad Request)

Tanto keyword como target son obligatorios. Proporcione una consulta de búsqueda y un dominio o URL.

Depth no válido (400 Bad Request)

depth debe estar entre 10 y 200. Los valores de depth más altos analizan más resultados.

Device no válido (400 Bad Request)

device debe ser "desktop" o "mobile".

Cuota excedida (429 Too Many Requests)

El proveedor de SERP aplica límites diarios. Actualice su plan para obtener cuotas más altas.

Tiempo de espera del proveedor (504 Gateway Timeout)

La consulta SERP se ejecuta en vivo en Google y puede superar el límite de tiempo con mucha carga. No se cobran créditos: vuelve a intentarlo.

Consulta no disponible (502 / 503)

El proveedor SERP no está disponible, ha alcanzado su límite de peticiones o no está configurado en este despliegue. No se cobran créditos.

Costo en credits

5 credits

5 credits por consulta

Costo fijo por analizar hasta 100 resultados. Los credits se cobran solo por las consultas exitosas.

Qué incluye:

Posición orgánica real en la SERP (no el orden de Custom Search)

URL que posiciona y todas las posiciones que ocupa el target

Segmentación por ubicación e idioma

Emulación de dispositivo desktop y mobile

depth de hasta 200 resultados

Recomendaciones de plan:

Plan Free: 1,000 credits de prueba por única vez = 200 consultas

Plan Hobby: 5,000 credits = 1,000 consultas ($19/mo)

Plan Professional: 50,000 credits = 10,000 consultas ($99/mo)