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. Full list available here

Example: Austin,Texas,United States

uule
string

Encoded canonical location string (Google internal format).

Localization

domain
string
default:"google.com"

Google domain to use.

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.