Skip to main content
POST
Search Google

Authorizations

Authorization
string
header
required

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

Body

application/json
query
string
required

What to search Google for.

Example:

"best screen recording software for mac"

types
enum<string>[]

Which blocks of the results page to return. Everything else Google showed is dropped before the response is built. Ask for what you will actually read: ai_overview and people_also_ask carry the full text of every answer and are many times the size of the organic results.

Available options:
ai_overview,
organic,
people_also_ask,
discussions_and_forums,
video,
related_searches

Response

query
string
required
Example:

"best screen recorder mac"

location
string
required

Resolved from the workspace's settings.

Example:

"United States"

language
string
required

Resolved from the workspace's settings.

Example:

"en"

items
object[]
required

The blocks Google showed, in page order, filtered to the types asked for. Empty when Google returned nothing, or nothing of those types.