CrawlForge
SEODataForSEO5 credits

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
2 req/s en el plan Free
5 credits

Parameters

NameTypeRequiredDefaultDescription
keyword
stringRequired-
La consulta de búsqueda para la que comprobar la posición
Example: managed wordpress hosting
target
stringRequired-
Dominio o URL que se localizará en los resultados
Example: example.com
depth
numberOptional100
Cuántos resultados analizar (10-200; 100 = 1 página de costo)
Example: 100
device
stringOptionaldesktop
Dispositivo a emular: "desktop" o "mobile"
Example: mobile
location_name
stringOptionalUnited States
Ubicación, p. ej. 'United States' o 'London,England,United Kingdom'
Example: United States
location_code
numberOptional-
Código numérico de ubicación de DataForSEO (tiene prioridad sobre location_name)
Example: 2840
language_code
stringOptionalen
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.

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.