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/jsonReemplaza 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úsqueda | input.tbm | Entrada de la solicitud |
|---|---|---|
| Google Search | Omitir | Consulta de búsqueda en q |
| Google Images | 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 compras en q |
| Google Web | web | Consulta de búsqueda web en q |
| Google Jobs | jobs | Consulta de búsqueda de empleo en q |
| Google News | nws | Consulta de búsqueda de noticias en q |
| Google Short Videos | svid | Consulta 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.
Google Search
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.
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"
}
}'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.
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"
}
}'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"
}
}'Controles de búsqueda comunes
Establece estos campos dentro de input:
| Parámetro | Propósito |
|---|---|
q | Consulta de búsqueda obligatoria. |
gl | País de búsqueda, como us. |
hl | Idioma de búsqueda, como en. |
google_domain | Dominio de Google; por defecto es google.com. |
location | Origen de la búsqueda, preferiblemente especificado a nivel de ciudad. |
uule | Ubicación de Google codificada; mutuamente excluyente con location. |
start | Desplazamiento de resultados. La búsqueda web usa 0, 10, 20, etc. |
tbs | Filtros 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: guardataskIdy 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.