API do Google SERP
Cada superfície do Google está a apenas um endpoint de distância. Altere o parâmetro engine para alternar entre Search, Maps, Jobs, Shopping, Trends, Scholar e os demais.
Endpoint
Seção intitulada “Endpoint” GET https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY
Autenticação
Seção intitulada “Autenticação”Passe sua chave de API como o parâmetro de consulta api_key. As chaves ficam no painel em SERP API.
Parâmetros comuns
Seção intitulada “Parâmetros comuns”Estes funcionam na maioria dos engines do Google. Cada engine também tem seus próprios parâmetros específicos, documentados em sua página.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
api_key | string | sim | Sua chave de API do SERP API |
engine | string | sim | Qual superfície do Google (veja a tabela abaixo) |
q | string | geralmente | A consulta de busca (não necessária para alguns endpoints de foto/autor) |
location | string | não | Localização em formato livre (por exemplo, "Chicago, Illinois") |
gl | código ISO | não | Filtro de país (por exemplo, us, de) |
hl | código ISO | não | Idioma da interface (por exemplo, en, es) |
device | desktop | mobile | tablet | não | Dispositivo simulado |
start | integer | não | Deslocamento de paginação |
num | integer | não | Resultados por página |
Engines
Seção intitulada “Engines”engine | O que retorna |
|---|---|
google | SERP orgânico da web com anúncios, snippets, PAA, knowledge graph |
google_autocomplete | Sugestões para uma consulta parcial |
google_images | SERP de imagens |
google_news | Notícias com datas e fontes |
google_shopping | Listagens de produtos |
google_product | Detalhe de um único produto |
google_maps | Locais, avaliações, fotos no Maps |
google_maps_reviews | Todas as avaliações de um local |
google_maps_photos | Todas as fotos de um local |
google_jobs | Listagens de vagas |
google_jobs_listing | Detalhe de uma única vaga |
google_trends | Interesse ao longo do tempo |
google_scholar | Artigos acadêmicos |
google_scholar_author | Perfil de autor |
google_scholar_cite | Citações formatadas |
google_scholar_profiles | Descoberta de autores |
google_finance | Dados de ações e mercado |
google_events | Eventos locais |
google_play | Apps, livros e filmes da Play Store |
google_reverse_image | Páginas que hospedam uma imagem |
google_local_services | Prestadores de serviços locais |
Páginas de endpoint
Seção intitulada “Páginas de endpoint” Google Search engine=google
Google Maps engine=google_maps
Google Maps Reviews engine=google_maps_reviews
Google Maps Photos engine=google_maps_photos
Google Product engine=google_product
Google Jobs engine=google_jobs
Google Jobs Listing engine=google_jobs_listing
Google Autocomplete engine=google_autocomplete
Google Trends engine=google_trends
Google Scholar engine=google_scholar
Google Scholar Author engine=google_scholar_author
Google Scholar Cite engine=google_scholar_cite
Google Scholar Profiles engine=google_scholar_profiles
Google Finance engine=google_finance
Google Events engine=google_events
Google Play engine=google_play
Google Reverse Image engine=google_reverse_image
Google Local Services engine=google_local_services