Skip to main content
GET
Get Google search results for a keyword

Authorizations

X-API-Key
string
header
required

API key passed as the X-API-Key request header. Recommended for server-to-server calls.

Query Parameters

keyword
string
required
Minimum string length: 1
Example:

"shopify apps"

location
string

ISO 3166-1 alpha-2 country code

Example:

"US"

language
string

ISO 639-1 language code

Example:

"en"

device
enum<string>
Available options:
desktop,
mobile
depth
integer

Number of results to return (default 10, max 200)

Required range: 0 < x <= 200

Response

Get Google search results for a keyword

keyword
string
required
searchEngine
enum<string>
required
Available options:
google,
bing
location
string
required
language
string
required
device
enum<string>
required
Available options:
desktop,
mobile
totalResults
integer | null
required
checkedAt
string
required
features
enum<string>[]
required

Which SERP sections appeared for this keyword — e.g. spot when a keyword gets absorbed into an AI Overview instead of organic clicks

Available options:
organic,
paid,
featured_snippet,
people_also_ask,
ai_overview,
local_pack,
shopping,
video,
image,
news,
knowledge_panel,
other
organic
object[]
required
paid
object[]
required
aiOverview
object | null
required