Google Light web search
curl --request GET \
--url https://scrapebadger.com/v1/google/light/search \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/google/light/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/google/light/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/google/light/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/google/light/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/google/light/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/google/light/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"search_information": {
"query_displayed": "<string>",
"total_results": 123,
"time_taken": 123,
"organic_results_state": "<string>",
"url": "<string>"
},
"pagination": {
"current": 1,
"next": "<string>",
"total_results": 123,
"total_pages": 123,
"page_no": {}
},
"organic_results": [
{
"position": 123,
"title": "<string>",
"link": "<string>",
"displayed_link": "<string>",
"snippet": "<string>",
"highlighted_keywords": [
"<string>"
],
"source": "<string>",
"favicon": "<string>",
"sitelinks": [
{
"title": "<string>",
"link": "<string>",
"snippet": "<string>"
}
],
"inline_sitelinks": [
{
"title": "<string>",
"date": "<string>"
}
],
"date": "<string>",
"rich_snippet": {
"top": {
"extensions": [
"<string>"
],
"detected_extensions": {}
}
},
"read_more_link": "<string>",
"rank": 123,
"page_rank": 123
}
],
"related_searches": [
{
"query": "<string>",
"link": "<string>"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Search
Google Light Search
Organic results and related searches through a dedicated lightweight endpoint.
GET
/
v1
/
google
/
light
/
search
Google Light web search
curl --request GET \
--url https://scrapebadger.com/v1/google/light/search \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/google/light/search"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/google/light/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/google/light/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/google/light/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/google/light/search")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/google/light/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"search_information": {
"query_displayed": "<string>",
"total_results": 123,
"time_taken": 123,
"organic_results_state": "<string>",
"url": "<string>"
},
"pagination": {
"current": 1,
"next": "<string>",
"total_results": 123,
"total_pages": 123,
"page_no": {}
},
"organic_results": [
{
"position": 123,
"title": "<string>",
"link": "<string>",
"displayed_link": "<string>",
"snippet": "<string>",
"highlighted_keywords": [
"<string>"
],
"source": "<string>",
"favicon": "<string>",
"sitelinks": [
{
"title": "<string>",
"link": "<string>",
"snippet": "<string>"
}
],
"inline_sitelinks": [
{
"title": "<string>",
"date": "<string>"
}
],
"date": "<string>",
"rich_snippet": {
"top": {
"extensions": [
"<string>"
],
"detected_extensions": {}
}
},
"read_more_link": "<string>",
"rank": 123,
"page_rank": 123
}
],
"related_searches": [
{
"query": "<string>",
"link": "<string>"
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}A successful request costs 10 credits. Failed requests are free. Check
The JSON response contains
X-Credits-Used for the actual charge and /api/public/pricing for current
prices and promotions.
curl --get 'https://scrapebadger.com/v1/google/light/search' \
--header 'X-API-Key: YOUR_API_KEY' \
--data-urlencode 'q=vinted api' \
--data-urlencode 'gl=us' \
--data-urlencode 'hl=en'
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 resolveslocation 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 sendsoq=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.
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.Query Parameters
Response
Successful Response
Essential SERP data returned by GET /api/v1/light/search.

