Endpoints de la API de Google Search

Elige un tipo de búsqueda de Google y envía su solicitud mediante 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 utilizan el mismo endpoint HTTP y el actor scraper.google.search. El valor 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

Reemplaza YOUR_API_KEY con tu clave de API de Scrapeless. Envía un único objeto JSON que contenga actor e input.

Elige un tipo de búsqueda

Tipo de búsquedainput.tbmEntrada de la solicitud
Google SearchOmitirConsulta de búsqueda en q
Google ImagesischConsulta de búsqueda de imágenes en q
Google LocallclConsulta de búsqueda local en q
Google VideosvidConsulta de búsqueda de videos en q
Google ShoppingshopConsulta de búsqueda de compras en q
Google WebwebConsulta de búsqueda web en q
Google JobsjobsConsulta de búsqueda de empleo en q
Google NewsnwsConsulta de búsqueda de noticias en q
Google Short VideossvidConsulta de búsqueda de videos cortos en q

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

Omite tbm para la búsqueda web estándar.

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 asumas que cada consulta devolverá todas las secciones.

Referencia de Google Search

Google Images

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

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

Establece tbm en lcl para solicitar una 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 segmentar a nivel de ciudad, añade location dentro de input, como "Austin, Texas, United States". Usa location o uule, nunca ambos en una misma solicitud.

Para la paginación de la búsqueda Local, start debe ser un múltiplo de 20: 0, 20, 40, etc.

Referencia de Google Local

Google Videos

Establece tbm en vid. Este ejemplo conserva los campos de solicitud que se muestran en la referencia dedicada de la API.

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,
    "tbm": "vid"
  }
}'

Referencia de Google Videos

Google Shopping

Establece tbm en shop. Este ejemplo conserva los campos de solicitud que se muestran en la referencia dedicada de la API.

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,
    "tbm": "shop"
  }
}'

Referencia de Google Shopping

Controles de búsqueda comunes

Establece estos campos dentro de input:

ParámetroPropósito
qConsulta de búsqueda obligatoria.
glPaís de búsqueda, como us.
hlIdioma de búsqueda, como en.
google_domainDominio de Google; por defecto es google.com.
locationOrigen de la búsqueda, preferiblemente especificado a nivel de ciudad.
uuleUbicación de Google codificada; mutuamente excluyente con location.
startDesplazamiento de resultados. La búsqueda web usa 0, 10, 20, etc.
tbsFiltros de búsqueda avanzados.

Consulta Parámetros de Google Search para ver las descripciones completas de los parámetros. El soporte de dispositivos listado actualmente es de escritorio.

Leer el resultado

  • HTTP 200: lee el resultado JSON.
  • HTTP 201: guarda taskId y recupera 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'

Reemplaza YOUR_TASK_ID con el ID devuelto. Consulta 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 dedicadas de la API declaran actualmente un objeto genérico para respuestas exitosas; el ejemplo estándar de Google Search no es un esquema para Images, Local, Videos o Shopping.

Documentación relacionada