API Params
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
Search term to query Google for.
Example: coffee beans
Geographic Location
Google canonical location for the search. Full list available here
Example: Austin,Texas,United States
Encoded canonical location string (Google internal format).
Localization
Google domain to use.
The two-letter country code for the country you want to limit the search to.
Full list available here.
The two-letter language code for the language you want to use for the search.
Full list available here.
Advanced Filters
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.
Adult Content Filtering option.
Options: active
, off
.
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
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.
Number of results per page, ranging from 10 to 100.
Search Type
Type of search.
Options: isch
= images, vid
= videos, nws
= news, shop
= shopping, lcl
= local.
Device Type
Emulate Google results on a specific device.
Options: desktop
, mobile
, tablet
.
Advanced Parameters
The Google Place ID for a specific location.
Additional Google Place ID.
Google Knowledge Graph ID.
Google Cached Search Parameters ID.