Skip to main content
GET
Search Google

Authorizations

x-api-key
string
header
required

Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.

Query Parameters

query
string
required

The search text.

region
string

2-letter ISO country code — bias results to that country (e.g. us, gb, ng).

datePosted
enum<string>

Freshness filter — results from the last hour / day / week / month / year.

Available options:
hour,
day,
week,
month,
year
page
integer
default:1

Results page to retrieve, 1–11 (10 results per page). Default 1.

Required range: 1 <= x <= 11
cache_max_age
enum<string>

Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.

Available options:
1d,
3d,
7d,
14d,
30d

Response

The search results.

data
object
required
meta
object
required

requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt).