Google Organic SERP
Las páginas de resultados orgánicos de Google combinan enlaces posicionados con otros elementos visibles, como fragmentos destacados, preguntas, resultados locales y videos. Sus destinos, posiciones, tipos de elemento y detalles de presentación sirven para obtener instantáneas de posicionamiento, analizar el diseño y comparar dispositivos o mercados.
Funcionalidades de la Google Organic SERP API
- Instantánea de mercado para una consultaResuelve una consulta de búsqueda con un mercado, un idioma y un dispositivo (desktop o mobile) explícitos, para obtener una página de resultados comparable en un momento dado.
- Campos de posición y destinoDevuelve las URL de destino disponibles, los títulos visibles, las posiciones de grupo, las posiciones absolutas y los números de página de resultados en campos normalizados.
- Cobertura de elementos mixtos de la SERPConserva los enlaces orgánicos y los demás tipos de resultado devueltos, con extra.type para identificar el tipo de elemento que representa cada registro.
- Contexto completo de cada elementoRetiene en extra el objeto completo propio de cada elemento, de modo que dominios, fragmentos, rutas de navegación, imágenes y atributos de resultados enriquecidos sigan disponibles cuando existan.
Parámetros de la Google Organic SERP API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Consulta de búsqueda obligatoria y no vacía. Cada tarea acepta una sola consulta. |
location_code | Opcional | Código numérico positivo del mercado. El Playground usa 2840 (Estados Unidos) de forma predeterminada. |
location_name | Opcional | Nombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code. |
language_code | Opcional | Código del idioma de búsqueda, de 2 a 10 caracteres. El Playground usa en de forma predeterminada. |
language | Opcional | Nombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code. |
device | Opcional | Contexto del dispositivo de búsqueda: desktop o mobile. |
results_limit | Opcional | Profundidad de posicionamiento solicitada, de 1 a 700. Es un tope y no garantiza la misma cantidad de elementos aplanados. |
Cómo usar la Google Organic SERP API
Envíe una consulta con la configuración de mercado basada en códigos y una profundidad acotada, y luego lea cada elemento normalizado de la SERP en la tarea asíncrona completada.
- Elija una consulta no vacía, un location_code, un language_code, un device y un results_limit de 1 a 200.
- Envíe el contenido por POST a /v1/seo/google-organic-serp y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- Lea data.results.items y luego solicite el next_cursor devuelto mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/seo/google-organic-serp" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Google Organic SERP API
- Instantáneas de posicionamiento actual: Use las URL de destino junto con rank.group, rank.absolute, rank.page y collected_at para registrar dónde aparecen las páginas devueltas para una consulta definida.
- Comparación de dispositivos y mercados: Envíe consultas equivalentes con valores controlados de device, location_code y language_code para comparar destinos y posiciones de los resultados entre distintos contextos.
- Análisis del diseño de la SERP: Revise extra.type y los campos propios de cada elemento para distinguir los enlaces posicionados de las preguntas, los fragmentos, los resultados locales, los videos y otras funciones de página devueltas.
Consejos de expertos para la Google Organic SERP API
- Mantenga sin cambios query, location_code y language_code al comparar desktop y mobile, de modo que el dispositivo sea la única variable planeada.
- Use un results_limit no mayor a 200, aunque la validación de la ruta acepte valores más altos, porque la profundidad de los resultados avanzados en vivo está limitada a 200.
- Bifurque la lógica según extra.type antes de leer las claves propias de cada elemento, y admita que url y los valores de rank puedan faltar en elementos que no los exponen.
- Trate rank.page como el número de página de resultados de búsqueda; use next_cursor por separado para paginar los registros de resultados almacenados en SocQ.
- Almacene extra como un objeto flexible, porque sus claves disponibles varían según el tipo de elemento de la SERP y pueden cambiar con el tiempo.
APIs relacionadas
Además de la Google Organic SERP API, use estas APIs cuando necesite otro tipo de datos públicos de SEO.
- Keyword Difficulty API — Compara la dificultad de posicionamiento orgánico de un lote de palabras clave enviado, y devuelve cada palabra clave disponible con su puntuación normalizada.
- Keyword Overview API — Enriquece un lote de palabras clave enviado con el contexto disponible de demanda, competencia de pago, dificultad, búsquedas mensuales e intención.
- Keyword Search Volume API — Mide palabras clave conocidas con el volumen de búsqueda, el CPC, la competencia de pago y el historial mensual de búsquedas disponibles.
- Related Keywords API — Sigue rutas de búsquedas relacionadas a partir de una consulta semilla con controles de profundidad, mediciones de palabras clave disponibles, contexto de intención y filas de origen completas.
- Search Intent API — Clasifica la intención de búsqueda principal y secundaria de un lote de palabras clave enviado, conservando las probabilidades de origen y los registros completos.
- Google News API — Recopila artículos de Google News para una consulta, destacados primero, con titular, medio, enlace directo al artículo, extracto y hora de publicación.
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API