Google SERP API

Every Google surface is one endpoint away. Change the engine parameter to switch between Search, Maps, Jobs, Shopping, Trends, Scholar, and the rest.

Endpoint

GET https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY

Authentication

Pass your API key as the api_key query parameter. Keys live in the panel under SERP API.

Common parameters

These work across most Google engines. Each engine also has its own specific parameters, documented on its page.

Parameter	Type	Required	Description
api_key	string	yes	Your SERP API key
engine	string	yes	Which Google surface (see table below)
q	string	usually	The search query (not needed for some photo/author endpoints)
location	string	no	Free-form location (e.g. "Chicago, Illinois")
gl	ISO code	no	Country filter (e.g. us, de)
hl	ISO code	no	Interface language (e.g. en, es)
device	desktop | mobile | tablet	no	Simulated device
start	integer	no	Pagination offset
num	integer	no	Results per page

Engines

engine	What it returns
google	Organic web SERP with ads, snippets, PAA, knowledge graph
google_autocomplete	Suggestions for a partial query
google_images	Image SERP
google_news	News with dates and sources
google_shopping	Product listings
google_product	Single product detail
google_maps	Places, reviews, photos on Maps
google_maps_reviews	Every review for a place
google_maps_photos	Every photo for a place
google_jobs	Job listings
google_jobs_listing	Single job detail
google_trends	Interest-over-time
google_scholar	Academic papers
google_scholar_author	Author profile
google_scholar_cite	Formatted citations
google_scholar_profiles	Author discovery
google_finance	Stock and market data
google_events	Local events
google_play	Play Store apps, books, movies
google_reverse_image	Pages hosting an image
google_local_services	Local service providers

Endpoint pages

Google Search engine=google

Google Maps engine=google_maps

Google Maps Reviews engine=google_maps_reviews

Google Maps Photos engine=google_maps_photos

Google News engine=google_news

Google Shopping engine=google_shopping

Google Product engine=google_product

Google Images engine=google_images

Google Video engine=google_video

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

See also

• Response shape
• Products - SERP API