Todos os engines do Google compartilham o mesmo endpoint, basta trocar o parâmetro engine para alterar o que é retornado.
https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>Engines
Seção intitulada “Engines”engine | Retorna | Parâmetros principais |
|---|---|---|
google | SERP orgânico, anúncios, snippets, PAA, knowledge graph | q, location, gl, hl, device |
google_autocomplete | Sugestões para uma consulta parcial | q |
google_images | SERP de imagens | q, location |
google_maps | Empresas, avaliações e fotos do Maps | q, type=search|place|review, ll |
google_maps_reviews | Todas as avaliações de um local | data_id |
google_maps_photos | Todas as fotos de um local | data_id |
google_news | SERP de notícias com datas e fontes | q, gl, hl |
google_shopping | Listagens de produtos com preços | q, location |
google_product | Página de detalhes de um único produto | product_id |
google_jobs | Vagas de emprego | q, location |
google_jobs_listing | Detalhe completo de uma vaga | q (id da vaga em base64) |
google_trends | Dados de interesse ao longo do tempo | q, geo, date |
google_scholar | Resultados de artigos acadêmicos | q |
google_scholar_author | Perfil e artigos do autor | author_id |
google_scholar_cite | Citações formatadas de um artigo | q (id da citação) |
google_scholar_profiles | Descoberta de autores por nome | mauthors |
google_events | Eventos locais | q, location |
google_play | Apps, livros e filmes da Play Store | type, store, product_id |
google_finance | Dados de ações e mercado | q |
google_reverse_image | Páginas que hospedam uma imagem | image_url |
google_local_services | Listagens de serviços locais | q, location |
Parâmetros comuns
Seção intitulada “Parâmetros comuns”| Parâmetro | Finalidade |
|---|---|
q | A consulta de busca |
location | String de localização em texto livre (ex.: "New York, NY") |
gl | Código do país (ex.: us, de) |
hl | Idioma da interface (ex.: en, es) |
device | desktop ou mobile |
start | Deslocamento de resultados para paginação |
num | Resultados por página |
A referência completa de parâmetros para cada engine está na seção REST API → Google SERP.
Exemplo: busca no Google com localização
Seção intitulada “Exemplo: busca no Google com localização”curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"Exemplo: busca no Google Maps
Seção intitulada “Exemplo: busca no Google Maps”curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"Exemplo: Google Jobs
Seção intitulada “Exemplo: Google Jobs”curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"Próximos passos
Seção intitulada “Próximos passos”- Locations, segmentação geográfica precisa além da string de localização em texto livre.
- REST API → Google SERP, referência completa de parâmetros para cada engine.