Search Google

Search query, up to 2,048 characters. Required unless ludocid or kgmid is supplied.

Example: coffee shops in Austin

Country restriction: one or more countryXX values joined with |, such as countryUS.

Example: countryUS

Lowercase two-letter country code used to localize results.

Example: us

Google interface and result language, such as en, en-US, or de. Defaults to en.

Example: en

Language restriction: one or more lang_xx values joined with |, such as lang_en.

Example: lang_en

Original query text from a Google URL, up to 2,048 characters; forwarded unchanged.

Opaque cached Google search context, up to 4,096 characters.

Google layout or expansion control, up to 4,096 characters.

Latitude between -90 and 90. Supply with lon; conflicts with location and uule.

Example: 30.2672

Longitude between -180 and 180. Supply with lat; conflicts with location and uule.

Example: -97.7431

Requested result count, 1 to 10. A best-effort hint: Google may return fewer rows, and results are never padded.

Google personalization flag: 0 or 1. 0 asks for non-personalized results.

Google vertical: lcl, vid, nws, shop, or pts. Google Images (isch) is rejected with 400 unsupported_search_vertical.

Google search-filter string, such as qdr:w, up to 4,096 characters.

Opaque Google filter token, up to 4,096 characters.

Additional terms that must all match, up to 2,048 characters.

Opaque Google local or Knowledge Graph signature, up to 4,096 characters.

Set 1 to disable Google spelling auto-correction, or 0 to allow it.

Google adult-content filtering: active or off.

Pre-encoded Google location token, up to 2,048 characters. Use only one of location, uule, or lat and lon.

Include (i) or exclude (e) the as_sitesearch host. Requires as_sitesearch.

Words the results must not contain, up to 2,048 characters.

Return pages that link to this complete HTTP(S) URL.

Additional terms of which any may match, up to 2,048 characters.

Return pages related to this complete HTTP(S) URL.

Opaque Google autocomplete-session value from a Google URL, up to 4,096 characters; forwarded unchanged.

Google Knowledge Graph machine ID, such as /m/0k8z. Can replace q.

Example: /m/0k8z

Result offset for pagination. Defaults to 0.

Example: 10

Exact phrase the results must contain, up to 2,048 characters.

Upper bound of a number range. Supply with as_nlo.

Lower bound of a number range. Supply with as_nhi.

Date range: d, w, m, or y with an optional positive count, such as m3 for the past three months.

Example: m3

Google returns its real layout for the selected device: desktop, tablet, or mobile.

Example: desktop

Google similar-results filtering: 0 or 1.

Search radius in meters around location or lat and lon, which it requires. 1 to 199 on desktop, 1 to 1,000 on tablet or mobile.

Decimal Google CID for a local entity search. Can replace q.

Example: 1234567890123456789

Google client label such as gws-wiz-serp: up to 64 letters, digits, dots, underscores, or hyphens.

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Human-readable search location, up to 512 characters. Use only one of location, uule, or lat and lon.

Example: Austin, Texas, United States

Google personalization companion flag: 0 or 1, forwarded to Google unchanged.

Set true to return only organic_results, search_metadata, and search_parameters, skipping AI Overview and all other result groups. Only lowercase true or false are accepted.

Google's light or dark result presentation.

Hostname to include or exclude, such as example.com. A hostname, not a URL.

Example: example.com

A Google domain from Google's supported list, such as google.com or google.co.uk.

Example: google.com