seo/
google-organic-serp

Obtenga una página de resultados de Google en vivo para una consulta y un mercado, con URL de destino, títulos, posiciones, tipos de elemento y detalles del resultado en registros normalizados.

Google Organic SERP API

Instantánea de SERP en vivo
Selección de dispositivo
Elementos de resultado mixtos
0.1 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioConsulta de búsqueda obligatoria y no vacía. Cada tarea acepta una sola consulta.
location_codeOpcionalCódigo numérico positivo del mercado. El Playground usa 2840 (Estados Unidos) de forma predeterminada.
location_nameOpcionalNombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code.
language_codeOpcionalCódigo del idioma de búsqueda, de 2 a 10 caracteres. El Playground usa en de forma predeterminada.
languageOpcionalNombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code.
deviceOpcionalContexto del dispositivo de búsqueda: desktop o mobile.
results_limitOpcionalProfundidad 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.

  1. Elija una consulta no vacía, un location_code, un language_code, un device y un results_limit de 1 a 200.
  2. Envíe el contenido por POST a /v1/seo/google-organic-serp y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de SEO con datos públicos de otras plataformas sociales compatibles.

Google Organic SERP API — FAQ

Google Organic SERP API es una interfaz programática que obtiene una página de resultados de Google en vivo a partir de una consulta, un código de mercado, un código de idioma y un dispositivo. Devuelve destinos, títulos, posiciones, tipos de elemento y los detalles completos de cada elemento, todo normalizado.

El Playground acepta una consulta obligatoria junto con location_code, language_code, device y results_limit. Usa selectores de mercado e idioma basados en códigos para evitar combinaciones ambiguas con las alternativas basadas en nombres.

No. Una página de resultados avanzados en vivo puede contener enlaces orgánicos, fragmentos destacados, preguntas, resultados locales, videos y otros elementos visibles; revise extra.type en cada registro.

Sí. Algunos elementos de la página de resultados no exponen una URL de destino ni todos los valores de posición, por lo que los clientes deben tratar url, rank.group, rank.absolute y rank.page como valores que pueden ser nulos.

Cada elemento de SERP normalizado devuelto cuesta 0.1 créditos de SocQ. Un conjunto de resultados vacío no genera cargo por resultados, y la profundidad solicitada es una estimación, no una cantidad devuelta garantizada.