Tous les moteurs Google partagent le même endpoint, il suffit de modifier le paramètre engine pour changer ce qui est retourné.
https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>engine | Retourne | Paramètres clés |
|---|---|---|
google | SERP organique, annonces, extraits, PAA, knowledge graph | q, location, gl, hl, device |
google_autocomplete | Suggestions pour une requête partielle | q |
google_images | SERP images | q, location |
google_maps | Entreprises, avis, photos sur Maps | q, type=search|place|review, ll |
google_maps_reviews | Tous les avis d’un lieu | data_id |
google_maps_photos | Toutes les photos d’un lieu | data_id |
google_news | SERP d’actualités avec dates et sources | q, gl, hl |
google_shopping | Listes de produits avec prix | q, location |
google_product | Page de détail d’un seul produit | product_id |
google_jobs | Offres d’emploi | q, location |
google_jobs_listing | Détail complet d’une offre | q (base64 job id) |
google_trends | Données d’intérêt dans le temps | q, geo, date |
google_scholar | Résultats d’articles académiques | q |
google_scholar_author | Profil d’auteur et articles | author_id |
google_scholar_cite | Citations formatées pour un article | q (citation id) |
google_scholar_profiles | Découverte d’auteurs par nom | mauthors |
google_events | Événements locaux | q, location |
google_play | Applications, livres, films du Play Store | type, store, product_id |
google_finance | Données boursières et de marché | q |
google_reverse_image | Pages hébergeant une image | image_url |
google_local_services | Listes de services locaux | q, location |
Paramètres communs
Section intitulée « Paramètres communs »| Paramètre | Utilité |
|---|---|
q | La requête de recherche |
location | Chaîne de localisation libre (par exemple "New York, NY") |
gl | Code pays (par exemple us, de) |
hl | Langue de l’interface (par exemple en, es) |
device | desktop ou mobile |
start | Décalage des résultats pour la pagination |
num | Résultats par page |
La référence complète des paramètres pour chaque moteur se trouve dans la section REST API → Google SERP.
Exemple : Recherche Google avec localisation
Section intitulée « Exemple : Recherche Google avec localisation »curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"Exemple : Recherche Google Maps
Section intitulée « Exemple : Recherche 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"Exemple : Google Jobs
Section intitulée « Exemple : Google Jobs »curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"- Locations, ciblage géographique précis au-delà de la chaîne
locationlibre. - REST API → Google SERP, référence complète des paramètres pour chaque moteur.