Skip to main content
GET
Google Light web search
A successful request costs 10 credits. Failed requests are free. Check X-Credits-Used for the actual charge and /api/public/pricing for current prices and promotions.
The JSON response contains search_information, organic_results, related_searches and pagination. Light skips ads, AI Overviews, Knowledge Graph, People Also Ask, local results, news, inline videos and shopping. No mode parameter is required. Passing mode=full or ai_overview=true cannot enable rich SERP features. Use start=10, 20, and so on for later pages. Google may return fewer results than requested by num; a page commonly contains about ten organic results. Set output=html to receive the raw Google response instead of parsed JSON. search_information.organic_results_state is Results for exact spelling, Results for spelling correction (Google showed results for a corrected spelling), Results with suggested correction (Google suggested a spelling with “Did you mean” but kept your query) or no_results. total_results and time_taken are filled only when Google prints them. Light usually gets Google’s basic page, which shows no result count or search time, so both are often null on Light. Use regular Search when you need them. Light attempts to resolve every organic result URL within one short lookup budget, without waiting for Google’s verification timers. If Google delays a link or changes its response, that link can remain a google.com/goto redirect. Every result keeps its position. Treat a redirect as an unresolved destination when tracking rankings; do not count google.com as the ranking website. Light has a 12-second processing budget, including fetching, fallback and parsing. If the budget expires, the response is 503 with Retry-After. The CLI command is scrapebadger google light-search "vinted api". The MCP tool is google_light_search, with start for pagination. See the Light overview or regular Search.

Location and request controls

Light resolves location into Google UULE, like full Search. It also accepts uule, paired lat/lon, radius, color_scheme and advanced as_* filters. Every request is fetched fresh. Its response includes search_parameters and search_metadata to distinguish requested targeting from observed fetch details. See location and request controls for validation rules and examples. Light remains a web-only API and cannot enable other search types or rich result blocks.

Google request fields

Search sends oq=q, sourceid=chrome, and ie=UTF-8 by default. Override them with the same-named parameters. An explicit empty string omits that field from the Google request. These are Google query parameters; sourceid does not change the browser User-Agent, and ie is an encoding hint.
string
Original query sent to Google. Defaults to q; an empty string omits it.
string
default:"chrome"
Google source identifier. Defaults to chrome; an empty string omits it.
string
default:"UTF-8"
Google input encoding hint. Defaults to UTF-8; an empty string omits it.
The udm=web alias is accepted and sent to Google as udm=14. Inspect search_parameters.google_parameters to see the actual request. Matching these fields does not guarantee identical rankings across separate sessions.

Authorizations

x-api-key
string
header
required

Query Parameters

q
string
required

Search query (supports Google operators)

gl
string
default:us

Country code

hl
string
default:en

Language code

num
integer
default:10
Required range: 1 <= x <= 100
start
integer
default:0

Page offset (0, 10, 20...)

Required range: x >= 0
domain
string
default:google.com

Google domain

location
string | null

City-level geo-targeting

uule
string | null

Encoded location

lr
string | null

Language restrict (e.g. lang_en)

tbs
string | null

Time filter (e.g. qdr:d)

safe
string
default:off

Safe search: off or active

filter
integer | null
Required range: 0 <= x <= 1
nfpr
integer
default:0

Disable auto-correction

output
enum<string>
default:json
Available options:
json,
html
google_domain
string | null

Alias for domain; Google requests use google.com with country targeting.

lat
number | null

Latitude; supply together with lon instead of location or uule.

Required range: -90 <= x <= 90
lon
number | null

Longitude; supply together with lat.

Required range: -180 <= x <= 180
radius
number | null

Location accuracy in meters; requires lat/lon or a named city with a known center.

Required range: 1 <= x <= 1000
color_scheme
enum<string> | null

Google color scheme.

Available options:
light,
dark
tbm
enum<string> | null

Google search type. Use output=html for verticals; dedicated APIs provide parsed vertical results.

Available options:
isch,
lcl,
vid,
nws,
shop,
pts,
bks
udm
string

Google result filter: web or 14 for web, 18 for forums. Other verticals require output=html.

Pattern: ^(web|[0-9]{1,3})$
no_cache
boolean
default:false

Ignored: responses are never cached, so every request is fetched fresh. Accepted for compatibility.

as_dt
string | null

Site restriction mode: i includes, e excludes as_sitesearch.

Pattern: ^[ie]$
as_epq
string | null

Exact phrase.

as_eq
string | null

Words to exclude.

as_lq
string | null

Find pages linking to this URL; availability depends on Google.

as_nlo
string | null

Numeric range minimum.

as_nhi
string | null

Numeric range maximum.

as_oq
string | null

Match any of these words.

as_q
string | null

Additional query words.

as_qdr
string | null

Time range, such as d, w, m or y1.

as_rq
string | null

Related URL; availability depends on Google.

as_sitesearch
string | null

Restrict results to a site.

device
string | null

Device target.

user_agent
string | null

Custom User-Agent.

cr
string | null

Country restrict.

ludocid
string | null

Place CID.

lsig
string | null

Map view ID.

kgmid
string | null

Knowledge Graph entity ID.

si
string | null

Cached Google parameters.

ibp
string | null

Layout control.

uds
string | null

Google filter string.

oq
string | null

Original query sent to Google. Defaults to q; an empty string omits it.

sourceid
string | null
default:chrome

Google source identifier. Defaults to chrome; an empty string omits it.

ie
string | null
default:UTF-8

Google input encoding hint. Defaults to UTF-8; an empty string omits it.

Response

Successful Response

Essential SERP data returned by GET /api/v1/light/search.

search_information
SearchInformation · object
required

Metadata about the search query.

pagination
Pagination · object
required

Pagination metadata.

organic_results
OrganicResult · object[]