Skip to content
Login Sign up

Google

All Google engines share the same endpoint, swap the engine parameter to change what you get back.

https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>
engineReturnsKey params
googleOrganic SERP, ads, snippets, PAA, knowledge graphq, location, gl, hl, device
google_autocompleteSuggestions for a partial queryq
google_imagesImage SERPq, location
google_mapsMaps businesses, reviews, photosq, type=search|place|review, ll
google_maps_reviewsAll reviews for a placedata_id
google_maps_photosAll photos for a placedata_id
google_newsNews SERP with dates and sourcesq, gl, hl
google_shoppingProduct listings with pricesq, location
google_productSingle product detail pageproduct_id
google_jobsJob listingsq, location
google_jobs_listingFull detail of one jobq (base64 job id)
google_trendsInterest-over-time dataq, geo, date
google_scholarAcademic paper resultsq
google_scholar_authorAuthor profile and papersauthor_id
google_scholar_citeFormatted citations for one paperq (citation id)
google_scholar_profilesAuthor discovery by namemauthors
google_eventsLocal eventsq, location
google_playPlay Store apps, books, moviestype, store, product_id
google_financeStock and market dataq
google_reverse_imagePages that host an imageimage_url
google_local_servicesLocal services listingsq, location
ParameterPurpose
qThe search query
locationFree-form location string (e.g. "New York, NY")
glCountry code (e.g. us, de)
hlInterface language (e.g. en, es)
devicedesktop or mobile
startResult offset for pagination
numResults per page

Full parameter reference for each engine lives in the REST API → Google SERP section.

Terminal window
curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"
Terminal window
curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"
Terminal window
curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"