This page lists all parameters for the Google SERP API. You must include at least the q parameter (search query). Everything else is optional.

​
Search Query

​
q
string
required
Search term to query Google for.Example: coffee beans

​
Geographic Location

​
location
string
Google canonical location for the search.Example: Austin,Texas,United StatesFull list available here.
​
uule
string
Encoded canonical location string (Google internal format).

​
Localization

​
domain
string
default:"google.com"
Google domain to use.Full list available here.
​
gl
string
The two-letter country code for the country you want to limit the search to.Full list available here.
​
hl
string
The two-letter language code for the language you want to use for the search.Full list available here.
​
lr
string
Filters results based on the language of the web content.Full list available here.

​
Advanced Filters

​
tbs
string
This parameter supports various filters that can be combined by separating them with a comma. Here are examples of these filters:
  • Specific Time Range: cdr:1,cd_min:10/17/2018,cd_max:3/8/2021 - Filter results to show only those within the defined date range.
  • Sort by Date: sbd:1 - Results are sorted by date, from the most recent to the oldest.
  • Sort by Relevance: sbd:0 - Results are sorted by relevance to the search query.
  • Sites with Images: img:1 - Only show results from webpages that contain images.
Quick Date Range (qdr):
  • qdr:h - Show results from the past hour.
  • qdr:d - Limit results to the past day.
  • qdr:w - Filter results from the week.
  • qdr:m - Display results from the past month.
  • qdr:y - Show results from the past year.
  • qdr:h10, qdr:d10, qdr:w10, qdr:m10, qdr:y10 - Specify a number to show results from the last 10 hours, days, weeks, months, or years respectively.
These filters enhance the control over search results, allowing for precise retrieval of information based on specific criteria.
​
safe
enum
Adult Content Filtering option.Options: active, off.
​
filter
number
Defines whether to enable or disable the filters for ‘Similar Results’ and ‘Omitted Results’. Set to 1 (default) to enable these filters, or 0 to disable them.

​
Pagination

​
start
number
default:0
This parameter specifies the number of search results to skip and is used for implementing pagination. For example, a value of 0 (default) indicates the first page of results, 10 refers to the second page, and 20 to the third page.For Google Local Results(tmb=lcl), the start value must be in multiples of 20, such as 20 for the second page, 40 for the third page, etc.
​
num
number
default:10
Number of results per page, ranging from 10 to 100.

​
Search Type

​
tbm
enum
Type of search.Options: isch = images, vid = videos, nws = news, shop = shopping, lcl = local.

​
Device Type

​
deviceType
string
Emulate Google results on a specific device.Options: desktop, mobile, tablet.

​
Advanced Parameters

​
ludocid
string
The Google Place ID for a specific location.
​
lsig
string
Additional Google Place ID.
​
kgmid
string
Google Knowledge Graph ID.
​
si
string
Google Cached Search Parameters ID.