Skip to main content
GET
SERP

Authorizations

Authorization
string
header
required

A bearer token that will be supplied within an Authorization header as bearer <token>.

Query Parameters

query
string
required

The query to search

search_engine
string

The search engine to use. Supported values: google, bing, yahoo and duckduckgo. Default to duckduckgo.

country
string

The country to search from. Default to us.

pages_number
integer

The number of pages to search (1-30). Default to 1.

resolve_urls
boolean

Google only. Resolve Google redirect links (google.com/goto) to their destination URLs. Default to true. When false, url is null for redirect links and domain/display_url are still returned.

device
string

Google only. desktop or mobile. Default to desktop.

location
string

Google only. Where the search is made from: "lat,lng" in decimal degrees (e.g. 40.6782,-73.9442), or a place name: city, neighborhood, county, state or postal code (e.g. "Brooklyn, NY", "Austin TX", "11216", "SW1A 1AA, UK"). Names are resolved to coordinates and a time zone; the resolved place is echoed in location. Look names up with /api/v1/locations. Default: the exit IP's location.

timezone
string

Google only, with location. IANA time zone id (e.g. America/New_York). Default: the named location's time zone.

strict
boolean

Google only. Return 422 instead of results when the page looks poisoned (see quality). Default to false.

samples
integer

Google only. Take 1-5 independent captures of page 1 and return a per-domain retrieval distribution. Implies pages_number=1. Default to 1.

max_resamples
integer

Google only. Extra captures (0-3) to take when page 1 looks poisoned; the best is returned. Each one is a fresh browser identity (often a captcha solve, tens of seconds). Default to 1.

Response

success

data
object