Search

{ "timestamp": 1778737930991, "apiStatus": "success", "apiCode": 200, "meta": { "query": "best running shoes", "count": 10, "source": [ "web" ], "location": "us", "time": "any", "scrape": false, "scrapeLimit": 3, "test": { "id": "abc123" } }, "data": [ { "title": "Best Running Shoes of 2026 — Tested & Reviewed", "url": "https://example.com/best-running-shoes", "snippet": "We tested over 100 pairs to find the best running shoes for every type of runner...", "date": "Jan 15, 2025", "position": 1 }, { "title": "Top 10 Running Shoes for 2026", "url": "https://example2.com/running-shoes", "snippet": "From track to trail, here are the top running shoes this year...", "position": 2 } ] }

Authorizations

x-api-key

string

header

required

API Key required for all endpoints

Body

application/json

query

string

required

Search query

Maximum string length: 2048

Example:

"best running shoes"

limit

number

default:10

Number of results

Required range: 1 <= x <= 100

Example:

10

time

string

default:any

Time filter (h, d, w, m, y or h2, d7, etc.)

Example:

"d"

location

string

default:us

Country code (ISO alpha-2). Can be combined with city for city-level targeting; when city is set, it takes priority.

Example:

"us"

device

enum<string>

default:desktop

Device to emulate when searching. Defaults to desktop.

Available options:

desktop,

mobile

Example:

"desktop"

source

enum<string>

default:web

Search source. SERP mode accepts one source per request.

Available options:

web,

news,

images

Example:

"web"

category

enum<string>

default:general

Category filter. Ignored in SERP mode.

Available options:

general,

code,

pdf,

research,

linkedin,

wiki

Example:

"code"

includeDomains

string[]

Include only these domains

Example:

["reddit.com", "stackoverflow.com"]

excludeDomains

string[]

Exclude these domains

Example:

["pinterest.com"]

format

enum<string>

default:json

Output format. Ignored in SERP mode.

Available options:

json,

markdown,

html

scrape

boolean

default:false

scrape and extract content from SERP result URLs. Ignored in SERP mode.

Example:

false

scrapeLimit

number

default:3

Number of URLs to scrape (requires scrape: true). Ignored in SERP mode.

Required range: 1 <= x <= 10

Example:

3

groundedAnswer

boolean

default:false

Use AI to synthesize a grounded answer from search results. Ignored in SERP mode.

Example:

false

serp

boolean

default:false

Return the full Google search results page (SERP) including organic results, AI Overviews, related searches, People Also Ask, pagination, and more. Supported in this mode: query, location, city, device, limit, source (one value), time, includeDomains, and excludeDomains. It returns the first page of results.

Example:

false

city

string

City to target for localized results, using the name exactly as listed in the supported cities file, e.g. London,England,United Kingdom. Works with standard search and with serp: true. When set, it takes priority over location. Supported cities: https://cdn.geekflare.com/api-assets/geotargets-2026-08-12.json

Example:

"London,England,United Kingdom"

Response

Search results (format depends on request)

timestamp

number

required

Timestamp of the request in milliseconds

Example:

1788851167291

apiStatus

enum<string>

required

API status message

Available options:

success,

failure

Example:

"success"

apiCode

number

required

API status code

Example:

200

Getting started

Endpoint

Authorizations

Body

Response