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. Coincide por host, no por URL exacta: una URL se reduce a su host, y cuenta cualquier página de ese host o de sus subdominios Example: example.com
depth	number	Optional	30	Cuántos resultados analizar (10-200, 30 por defecto); un análisis más profundo tarda más. Siempre cuesta 5 credits, a cualquier profundidad 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; el cobro es de 5 credits a cualquier profundidad. Use location_name/location_code y device para comprobar posiciones específicas por geografía y por dispositivo. Cada consulta es una muestra: Google puede devolver otro conjunto de resultados para la misma búsqueda minutos después, así que compare varias consultas, idealmente en días distintos, antes de interpretar un cambio de posición.

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 OK6,200ms

{
  "success": true,
  "data": {
    "keyword": "managed wordpress hosting",
    "target": "example.com",
    "location": "United States",
    "language": "en",
    "device": "desktop",
    "depth": 30,
    "found": true,
    "rank": 3,
    "url": "https://example.com/",
    "all_positions": [
      3,
      27
    ],
    "results_scanned": 30,
    "se_results_count": 1370000,
    "check_url": "https://www.google.com/search?q=managed+wordpress+hosting&num=30&hl=en&gl=US",
    "checked_at": "2026-07-01T14:30:00Z"
  },
  "credits_used": 5,
  "credits_remaining": 995,
  "processing_time": 6200
}

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

data.se_results_countEl número de resultados que Google da para la consulta. Dos consultas con cifras muy distintas vienen de conjuntos de resultados distintos

data.check_urlLa página de resultados de Google que consultó DataForSEO, para que usted vea la SERP

credits_used5 credits fijos por consulta, a cualquier profundidad

processing_timeLas consultas normalmente tardan entre 5 y 15 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:

target coincide por host, no por URL exacta: https://example.com/pricing informa la mejor posición de cualquier página de example.com o de sus subdominios, y url indica la página que la ocupa. Pase un subdominio (blog.example.com) para acotar la coincidencia. Use location_code para una segmentación geográfica precisa cuando el nombre de una ubicación sea ambiguo.