Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string
required

Parameter defines the query you want to search. You can use anything that you would use in a regular Google search.

gl
string
default:us
required

Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Country List

hl
string
default:en
required

Parameter defines the language to use for the Google search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Languages List

location
string

This optional parameter determines where your Google search originates, allowing for more specific locations such as cities and neighborhoods.

Examples:

  • Country: United States
  • State: California, United States
  • Region: San Fransisco Bay Area, United States
  • City: London, England, United Kingdom
  • Neighborhood: SoHo, Ney York, United States
  • Airport: Dubai International Airport, Dubai, United Arab Emirates
tbs
string

Date range

  • Anytime leave empty
  • Past hour = qdr:h
  • Past 24 hours = qdr:d
  • Past week = qdr:w
  • Past month = qdr:m
  • Past year = qdr:y
autocorrect
boolean
default:true

true , false

num
number
default:10
required

This sets the maximum number of results per page. 10 , 100. Results more than 10 per page will count as 2 credits.

page
number
default:1
required

Requested page

api_key
string
required

This is your account API Key. You can easily locate it in your account dashboard.

Response

200

OK