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>Engines
Section titled “Engines”engine | Returns | Key params |
|---|---|---|
google | Organic SERP, ads, snippets, PAA, knowledge graph | q, location, gl, hl, device |
google_autocomplete | Suggestions for a partial query | q |
google_images | Image SERP | q, location |
google_maps | Maps businesses, reviews, photos | q, type=search|place|review, ll |
google_maps_reviews | All reviews for a place | data_id |
google_maps_photos | All photos for a place | data_id |
google_news | News SERP with dates and sources | q, gl, hl |
google_shopping | Product listings with prices | q, location |
google_product | Single product detail page | product_id |
google_jobs | Job listings | q, location |
google_jobs_listing | Full detail of one job | q (base64 job id) |
google_trends | Interest-over-time data | q, geo, date |
google_scholar | Academic paper results | q |
google_scholar_author | Author profile and papers | author_id |
google_scholar_cite | Formatted citations for one paper | q (citation id) |
google_scholar_profiles | Author discovery by name | mauthors |
google_events | Local events | q, location |
google_play | Play Store apps, books, movies | type, store, product_id |
google_finance | Stock and market data | q |
google_reverse_image | Pages that host an image | image_url |
google_local_services | Local services listings | q, location |
Common parameters
Section titled “Common parameters”| Parameter | Purpose |
|---|---|
q | The search query |
location | Free-form location string (e.g. "New York, NY") |
gl | Country code (e.g. us, de) |
hl | Interface language (e.g. en, es) |
device | desktop or mobile |
start | Result offset for pagination |
num | Results per page |
Full parameter reference for each engine lives in the REST API → Google SERP section.
Example: Google Search with location
Section titled “Example: Google Search with location”curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"Example: Google Maps search
Section titled “Example: Google Maps search”curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"Example: Google Jobs
Section titled “Example: Google Jobs”curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"- Locations, precise geo-targeting beyond the free-form
locationstring. - REST API → Google SERP, full parameter reference for every engine.