api Google México Inc.
API de autocompletado de Google
La API de autocompletar de Google te permite obtener sugerencias para una palabra clave.
El punto final de la API es https://serpapi.com/search?engine=google_autocomplete
Dirígete al área de juegos para una demostración interactiva en vivo.
Plan gratuito · 250 búsquedas al mes
ComienceParámetros de la API
Localización
gl
Opcional
Este parámetro define el país que se utilizará para la búsqueda de Google. Se trata de un código de país de dos letras (por ejemplo, uspara Estados Unidos, ukReino Unido o frFrancia). Visita la página de países de Google para consultar la lista completa de países compatibles.
hl
Opcional
Este parámetro define el idioma que se utilizará para la función de autocompletar de Google. Se trata de un código de idioma de dos letras (por ejemplo, enpara inglés, esespañol o frfrancés). Consulta la página de idiomas de Google para ver la lista completa de idiomas compatibles.
Parámetros avanzados de autocompletado
cp
Opcional
El puntero del cursor define la posición del cursor para la consulta proporcionada. La posición comienza en 0, lo que significa que el cursor se coloca antes de la consulta |query. Si no se proporciona, el cursor se coloca al final de la consulta query|.
cliente
Opcional
Parámetro utilizado para definir el cliente para el autocompletado. Lista de clientes compatibles .
Parámetros de Serpapi
motor
Requerido
Establezca el parámetro para google_autocompleteusar el motor de la API de autocompletado de Google.
no_cache
Opcional
Este parámetro obligará a SerpApi a obtener los resultados de la función de autocompletar de Google incluso si ya existe una versión en caché. La caché solo se utiliza si la consulta y todos los parámetros son exactamente iguales. La caché caduca después de 1 hora. Las búsquedas en caché son gratuitas y no se contabilizan en el límite mensual de búsquedas. Se puede configurar en false(valor predeterminado) para permitir o truedenegar los resultados de la caché. Los parámetros `no_cache` y `async` no deben utilizarse conjuntamente.
asíncrono
Opcional
Este parámetro define cómo desea enviar su búsqueda a SerpApi. Puede configurarse como false(predeterminado) para abrir una conexión HTTP y mantenerla abierta hasta obtener los resultados de la búsqueda, o bien truepara enviar la búsqueda a SerpApi y recuperarlos posteriormente. En este caso, deberá utilizar nuestra API de archivo de búsquedas para recuperar los resultados. Los parámetros `async` y `no_cache` no deben utilizarse juntos. `async` no debe utilizarse en cuentas con la función Ludicrous Speed activada.
traza cero
Opcional
Solo para empresas. Este parámetro habilita el modo ZeroTrace . Puede configurarse como false(predeterminado) o true. Habilite este modo para omitir el almacenamiento de parámetros de búsqueda, archivos de búsqueda y metadatos de búsqueda en nuestros servidores. Esto puede dificultar la depuración.
Resultados de la API
Resultados JSON
La salida JSON incluye datos estructurados para suggestions- lista de autocompletados para la palabra clave proporcionada. chromey chrome-omnilos clientes también tienen metadatos relacionados con la omnibox - suggesttype, verbatim_relevance, clientdata.
Se puede acceder al estado de la búsqueda a través de search_metadata.status. Fluye de esta manera: Processing-> Success|| Error. Si una búsqueda ha fallado, errorcontendrá un mensaje de error. search_metadata.ides el ID de búsqueda dentro de SerpApi.
Resultados HTML
Esta API no tiene respuesta HTML, solo texto. search_metadata.prettify_html_fileContiene una versión formateada del resultado. Se muestra en el entorno de pruebas.
Ejemplos de API
Ejemplo con q : coffeeparámetro
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=coffee&hl=en&gl=us
{
"search_metadata": {
"id": "605881c3de9834001cb9a014",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/e577b8c1681b6153/605881c3de9834001cb9a014.json",
"created_at": "2021-03-22 11:38:43 UTC",
"processed_at": "2021-03-22 11:38:44 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=coffee&gl=us&hl=en&client=chrome",
"raw_html_file": "https://serpapi.com/searches/e577b8c1681b6153/605881c3de9834001cb9a014.html",
"prettify_html_file": "https://serpapi.com/searches/e577b8c1681b6153/605881c3de9834001cb9a014.prettify",
"total_time_taken": 0.26
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "coffee",
"gl": "us",
"hl": "en"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "coffee near me",
"relevance": 1250,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=coffee+near+me"
},
{
"value": "coffee nearby",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=coffee+nearby"
},
{
"value": "coffee shops near me",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=coffee+shops+near+me"
},
...
],
"verbatim_relevance": 886
}
Ejemplo con q : t scotty cp :1
El parámetro cp se puede usar para refinar el autocompletado. Significa " puntero del cursor ". En este caso, se establecería en 1, lo que significa que el cursor se colocaría justo después de la primera " t ".t| scott
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=t+scott&cp=1&hl=en&gl=us
{
"search_metadata": {
"id": "605882f5de98340020c8e942",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/ee108fda921ed872/605882f5de98340020c8e942.json",
"created_at": "2021-03-22 11:43:49 UTC",
"processed_at": "2021-03-22 11:43:50 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=t+scott&cp=1&gl=us&hl=en&client=chrome",
"raw_html_file": "https://serpapi.com/searches/ee108fda921ed872/605882f5de98340020c8e942.html",
"prettify_html_file": "https://serpapi.com/searches/ee108fda921ed872/605882f5de98340020c8e942.prettify",
"total_time_taken": 1.30
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "t scott",
"cp": "1",
"gl": "us",
"hl": "en"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "travis scott",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=travis+scott"
},
{
"value": "travis scott burger",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=travis+scott+burger"
},
{
"value": "tim scott",
"relevance": 555,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=tim+scott"
},
...
],
"verbatim_relevance": 851
}
Ejemplo con q : t scotty cp :7
El parámetro cp se puede usar para refinar el autocompletado. Significa " puntero del cursor ". En este caso, se establecería en 7, lo que significa que el cursor se colocaría después de la última " t ".t scott|
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=t+scott&cp=7&hl=en&gl=us
{
"search_metadata": {
"id": "60588431de9834001e2a3d72",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/9071926fbf9dad59/60588431de9834001e2a3d72.json",
"created_at": "2021-03-22 11:49:05 UTC",
"processed_at": "2021-03-22 11:49:05 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=t+scott&cp=7&gl=us&hl=en&client=chrome",
"raw_html_file": "https://serpapi.com/searches/9071926fbf9dad59/60588431de9834001e2a3d72.html",
"prettify_html_file": "https://serpapi.com/searches/9071926fbf9dad59/60588431de9834001e2a3d72.prettify",
"total_time_taken": 1.03
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "t scott",
"cp": "7",
"gl": "us",
"hl": "en"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "t scott jones",
"relevance": 1250,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=t+scott+jones"
},
{
"value": "t scott law",
"relevance": 700,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=t+scott+law"
},
{
"value": "t scott construction",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=t+scott+construction"
},
...
],
"verbatim_relevance": 1300
}
Ejemplo con q : pewdiepiey cliente :chrome
Cambiar el parámetro del cliente podría afectar los resultados de la finalización. Aquí hay un ejemplo para chrome.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie&client=chrome&hl=en&gl=us
{
"search_metadata": {
"id": "60588593de9834001e2a3d73",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/17723d4e141789e0/60588593de9834001e2a3d73.json",
"created_at": "2021-03-22 11:54:59 UTC",
"processed_at": "2021-03-22 11:54:59 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=pewdiepie&gl=us&hl=en&client=chrome",
"raw_html_file": "https://serpapi.com/searches/17723d4e141789e0/60588593de9834001e2a3d73.html",
"prettify_html_file": "https://serpapi.com/searches/17723d4e141789e0/60588593de9834001e2a3d73.prettify",
"total_time_taken": 1.15
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "pewdiepie",
"gl": "us",
"hl": "en",
"client": "chrome"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "pewdiepie net worth",
"relevance": 1050,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+net+worth"
},
{
"value": "pewdiepie merch",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+merch"
},
{
"value": "pewdiepie chair",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+chair"
},
...
],
"verbatim_relevance": 1300
}
Ejemplo con q : Coffeey cliente :gws-wiz
Cambiar el parámetro del cliente podría afectar los resultados de la finalización. Aquí hay un ejemplo para gws-wiz.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=Coffee&client=gws-wiz&hl=en&gl=us
{
"search_metadata": {
"id": "64fe624615afff16a04bf354",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/cbbccd07f13c20bf/64fe624615afff16a04bf354.json",
"created_at": "2023-09-11 00:41:42 UTC",
"processed_at": "2023-09-11 00:41:42 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=Coffee&hl=en&client=gws-wiz-serp&dpr=1",
"raw_html_file": "https://serpapi.com/searches/cbbccd07f13c20bf/64fe624615afff16a04bf354.html",
"prettify_html_file": "https://serpapi.com/searches/cbbccd07f13c20bf/64fe624615afff16a04bf354.prettify",
"total_time_taken": 0.54
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "Coffee",
"hl": "en"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "coffee near me",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee%3Cb%3E+near+me%3C%2Fb%3E",
"value_highlight": "near me"
},
{
"value": "coffee",
"title": "Coffee",
"subtitle": "Beverage",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQsWWsLtHHCkiTeIl_-9-5GiAAJveQ1nhcJzrPeKXIVuRKnmgQQEPGpANPEFg&s=10",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee"
},
{
"value": "coffee shop near me",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee%3Cb%3E+shop+near+me%3C%2Fb%3E",
"value_highlight": "shop near me"
},
{
"value": "coffee shop",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee%3Cb%3E+shop%3C%2Fb%3E",
"value_highlight": "shop"
},
{
"value": "coffee meets bagel",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee%3Cb%3E+meets+bagel%3C%2Fb%3E",
"value_highlight": "meets bagel"
},
{
"value": "coffee machine",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee%3Cb%3E+machine%3C%2Fb%3E",
"value_highlight": "machine"
},
{
"value": "coffee jelly",
"title": "Coffee jelly",
"subtitle": "Jelly dessert",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTheVfygTXPDVVsHZP9FUObBCShcMlybdM2mTQQVPvPsN2fZR2OuuDvbIWejg&s=10",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&hl=en&q=coffee+jelly"
},
...
]
}
Ejemplo con q : pewdiepiey cliente :safari
Cambiar el parámetro del cliente podría afectar los resultados de la finalización. Aquí hay un ejemplo para safari.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie&client=safari&hl=en&gl=us
{
"search_metadata": {
"id": "60588679de9834001e2a3d74",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/1909edfac7e1512d/60588679de9834001e2a3d74.json",
"created_at": "2021-03-22 11:58:49 UTC",
"processed_at": "2021-03-22 11:58:49 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=pewdiepie&gl=us&hl=en&client=safari",
"raw_html_file": "https://serpapi.com/searches/1909edfac7e1512d/60588679de9834001e2a3d74.html",
"prettify_html_file": "https://serpapi.com/searches/1909edfac7e1512d/60588679de9834001e2a3d74.prettify",
"total_time_taken": 1.13
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "pewdiepie",
"gl": "us",
"hl": "en",
"client": "safari"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "pewdiepie net worth",
"relevance": 1050,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+net+worth"
},
{
"value": "pewdiepie merch",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+merch"
},
{
"value": "pewdiepie chair",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+chair"
},
...
],
"verbatim_relevance": 1300
}
Ejemplo para Google Local
Cambiar el parámetro del cliente podría afectar los resultados de la finalización. Aquí hay un ejemplo para Google Localcon q : Coffeey client : gws-wiz-local.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=Coffee&client=gws-wiz-local&hl=en&gl=us
{
"search_metadata": {
"id": "6479b27815afff3cf45e2a1f",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/7aa6a786ba7778c7/6479b27815afff3cf45e2a1f.json",
"created_at": "2023-06-02 09:12:24 UTC",
"processed_at": "2023-06-02 09:12:24 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=Coffee&gl=us&hl=en&client=gws-wiz-local&pq=Coffee",
"raw_html_file": "https://serpapi.com/searches/7aa6a786ba7778c7/6479b27815afff3cf45e2a1f.html",
"prettify_html_file": "https://serpapi.com/searches/7aa6a786ba7778c7/6479b27815afff3cf45e2a1f.prettify",
"total_time_taken": 0.30
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "Coffee",
"gl": "us",
"hl": "en",
"client": "gws-wiz-local"
},
"suggestions": [
{
"value": "coffee",
"serpapi_link": "https://serpapi.com/search.json?client=gws-wiz-local&engine=google_autocomplete&gl=us&hl=en&q=coffee"
},
{
"value": "coffee near me",
"serpapi_link": "https://serpapi.com/search.json?client=gws-wiz-local&engine=google_autocomplete&gl=us&hl=en&q=coffee+near+me",
"value_highlight": "near me"
},
{
"value": "coffee nearby",
"serpapi_link": "https://serpapi.com/search.json?client=gws-wiz-local&engine=google_autocomplete&gl=us&hl=en&q=coffee+nearby",
"value_highlight": "nearby"
},
...
],
"search_information": {
"autocomplete_results_state": "Showing completion results."
}
}
Ejemplo con q : pewdiepiey gl :au
Cambiar el parámetro gl afecta los resultados de la finalización. Aquí hay un ejemplo para au.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie&client=chrome&hl=en&gl=au
{
"search_metadata": {
"id": "6058874ede98340020c8e943",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/bd1194ee7b29e346/6058874ede98340020c8e943.json",
"created_at": "2021-03-22 12:02:22 UTC",
"processed_at": "2021-03-22 12:02:22 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=pewdiepie&gl=au&hl=en&client=chrome",
"raw_html_file": "https://serpapi.com/searches/bd1194ee7b29e346/6058874ede98340020c8e943.html",
"prettify_html_file": "https://serpapi.com/searches/bd1194ee7b29e346/6058874ede98340020c8e943.prettify",
"total_time_taken": 1.21
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "pewdiepie",
"gl": "au",
"hl": "en",
"client": "chrome"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "pewdiepie net worth",
"relevance": 1100,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+net+worth"
},
{
"value": "pewdiepie sub count",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+sub+count"
},
{
"value": "pewdiepie merch",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+merch"
},
...
],
"verbatim_relevance": 1300
}
Ejemplo con q : pewdiepiey hl :ja
Cambiar el nivel de inglés (hl) afecta a los resultados de la prueba en cuanto al idioma utilizado.
CONSEGUIR
https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie&client=chrome&hl=ja
{
"search_metadata": {
"id": "6058882ede9834002292ab3a",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/5c2fb9ce14ffbd58/6058882ede9834002292ab3a.json",
"created_at": "2021-03-22 12:06:06 UTC",
"processed_at": "2021-03-22 12:06:06 UTC",
"google_autocomplete_url": "https://www.google.com/complete/search?q=pewdiepie&hl=ja&client=chrome",
"raw_html_file": "https://serpapi.com/searches/5c2fb9ce14ffbd58/6058882ede9834002292ab3a.html",
"prettify_html_file": "https://serpapi.com/searches/5c2fb9ce14ffbd58/6058882ede9834002292ab3a.prettify",
"total_time_taken": 1.04
},
"search_parameters": {
"engine": "google_autocomplete",
"q": "pewdiepie",
"hl": "ja",
"client": "chrome"
},
"search_information": {
"autocomplete_results_state": "Showing completion results."
},
"suggestions": [
{
"value": "pewdiepie net worth",
"relevance": 1000,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+net+worth"
},
{
"value": "pewdiepie なぜ人気",
"relevance": 601,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+なぜ人気"
},
{
"value": "pewdiepie 年収",
"relevance": 600,
"type": "QUERY",
"serpapi_link": "https://serpapi.com/search.json?engine=google_autocomplete&q=pewdiepie+年収"
},
...
],
"verbatim_relevance": 1290
}
Comentarios