API de resultados de búsqueda de Google (GOOGLE_SERP) - querying.ai

GOOGLE_SERP carga una página de resultados de google.com y devuelve sus resultados orgánicos y paneles. No espera a un AI Overview, así que responde más rápido que GOOGLE y cuesta menos. Úsalo para seguir posiciones o para encontrar páginas que leer con WEB_SCRAPE.


`taskType`	`GOOGLE_SERP`
Entrada	`query` (obligatorio); `page`, `country`, `location`, `include`
Créditos	1 por tarea
País	`US` por defecto. Cualquier código ISO 3166-1 alfa-2.
Ubicación	Admitida. Consulta Regiones y ubicación.

Solicitud

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en Tareas asíncronas.

Parámetros

Campo	Obligatorio	Descripción
`query`	Sí	La consulta de búsqueda, de 1 a 100.000 caracteres. Se acepta `prompt` si falta `query`.
`page`	No	Página de resultados, un entero de 1 a 10. `1` por defecto. Cada página contiene diez resultados orgánicos. Otros valores devuelven `422 VALIDATION_ERROR`.
`country`	No	El mercado de Google en el que buscar. `US` por defecto.
`location`	No	`{ "latitude", "longitude" }` en grados decimales. Google responde como a un usuario situado en ese punto, y el resultado lo devuelve como `location`.
`include.rawResponse`	No	`true` añade el HTML de la página de resultados como `rawContent`. La página es grande, a menudo cerca de un megabyte.

Respuesta

Por ejemplo, la página 2 de una consulta:

{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}

Campo	Descripción
`organicResults`	Siempre presente. `position` cuenta a través de las páginas, así que el primer resultado de la página 2 es `11`. Cada fila lleva la `page` de la que procede.
`page`	La página que se cargó.
`peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph`	Los paneles de Google, cuando la página los muestra.
`ads`	Anuncios superiores e inferiores, cuando la página los muestra.
`map`	El paquete local: lugares con `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` y más, cuando la página muestra uno.
`serp`	Otros paneles si existen: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`location`	El punto que enviaste, si enviaste uno.
`rawContent`	El HTML de la página de resultados, con `include.rawResponse: true`.

Los paneles que la página no muestra se omiten, en lugar de devolverse como null o []. Trata todos los campos salvo organicResults y page como opcionales. No hay aioverview, text ni sources; usa GOOGLE para obtener el AI Overview.

Límites y errores

Un organicResults vacío en una tarea completada significa que el propio Google no devolvió resultados para la consulta. Se confirma en un segundo navegador antes de devolverlo.
Un page fuera de 1-10 devuelve 422 VALIDATION_ERROR.
Un location mal formado devuelve 400 VALIDATION_ERROR.
Los demás errores de solicitud se enumeran en Errores.

Relacionado

Google AI Overviews para la misma página con su AI Overview
Web scrape para leer la página de un resultado en Markdown
Regiones y ubicación