Endpoints de la API de Google Search

Seleccione un tipo de búsqueda de Google y envíe la solicitud usando la API de Google Search. Esta guía se basa en el Inicio rápido y cubre los cinco tipos de búsqueda con entradas dedicadas en la referencia de la API de Scrapeless.

Los cinco tipos utilizan el mismo endpoint HTTP y el actor scraper.google.search. El valor de input.tbm selecciona el tipo de búsqueda.

Solicitud y autenticación

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

Reemplace YOUR_API_KEY con su clave de API de Scrapeless. Envíe un objeto JSON que contenga actor y input.

Elija un tipo de búsqueda

Tipo de búsqueda	`input.tbm`	Entrada de la solicitud
Google Search	Omitir	Consulta de búsqueda en `q`
Google Imágenes	`isch`	Consulta de búsqueda de imágenes en `q`
Google Local	`lcl`	Consulta de búsqueda local en `q`
Google Videos	`vid`	Consulta de búsqueda de videos en `q`
Google Shopping	`shop`	Consulta de búsqueda de Shopping en `q`

Estos son modos de búsqueda de un único endpoint. Mantenga la URL HTTP, el encabezado de autenticación y el actor sin cambios al cambiar entre modos.

Google Search

Omita tbm para búsquedas web regulares.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee",
    "hl": "en",
    "gl": "us"
  }
}'

El inicio rápido incluye una respuesta de búsqueda web con organic_results, pagination y otras secciones dependientes de la consulta. No asuma que cada consulta devuelve todas las secciones.

Referencia de Google Search

Google Images

Establezca tbm en isch para solicitar búsqueda de imágenes. La solicitud siguiente utiliza el dominio de Google predeterminado.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "Apple Iphone16",
    "hl": "en",
    "gl": "us",
    "tbm": "isch"
  }
}'

Referencia de Google Images

Google Local

Establezca tbm en lcl para solicitar búsqueda local.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee shops",
    "hl": "en",
    "gl": "us",
    "tbm": "lcl"
  }
}'

Para segmentación a nivel de ciudad, agregue location dentro de input, como en "Austin, Texas, United States". Use ya sea location o uule, nunca ambos en una misma solicitud.

Para la paginación en la búsqueda local, start debe ser múltiplo de 20: 0, 20, 40, y así sucesivamente.

Referencia de Google Local

Google Videos

Establezca tbm en vid. Este ejemplo conserva los campos de solicitud mostrados en la referencia de API específica.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "vid"
  }
}'

Referencia de Google Videos

Google Shopping

Establezca tbm en shop. Este ejemplo conserva los campos de solicitud mostrados en la referencia de API específica.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "shop"
  }
}'

Referencia de Google Shopping

Controles comunes de búsqueda

Establezca estos campos dentro de input:

Parámetro	Finalidad
`q`	Consulta de búsqueda requerida.
`gl`	País de búsqueda, por ejemplo `us`.
`hl`	Idioma de búsqueda, por ejemplo `en`.
`google_domain`	Dominio de Google; el valor predeterminado es `google.com`.
`location`	Origen de la búsqueda, preferiblemente especificado a nivel de ciudad.
`uule`	Ubicación codificada de Google; excluyente con `location`.
`start`	Desplazamiento de resultados. La búsqueda web usa `0`, `10`, `20`, y así sucesivamente.
`num`	Recuento máximo solicitado de resultados.
`tbs`	Filtros avanzados de búsqueda.

La referencia de parámetros advierte que num puede aumentar la latencia o afectar ciertos tipos de resultados especializados. Omita este parámetro a menos que sea necesario; un recuento solicitado no garantiza que se devuelva esa cantidad de resultados. Los ejemplos de Videos y Shopping anteriores conservan el valor documentado de 10.

Consulte parámetros de Google Search para obtener las descripciones completas de los parámetros. El soporte actual de dispositivos que se enumera allí es escritorio.

Lea el resultado

HTTP 200: lea el resultado en formato JSON.
HTTP 201: guarde taskId y recupere la tarea existente mediante el endpoint de resultados.

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

Reemplace YOUR_TASK_ID por el ID devuelto. Consulte Resultados y sondeo para conocer el flujo de trabajo completo.

Las secciones de la respuesta varían según el tipo de búsqueda y la consulta. Las especificaciones de API dedicadas declaran actualmente un objeto genérico para respuestas exitosas; el ejemplo de Google Search regular no es un esquema para Imágenes, Local, Vídeos o Compras.

Documentación relacionada

Inicio rápido Introducción