Google Light Search API
A fast and lightweight Google Search API designed for high-speed retrieval of essential SERP data. Ideal for real-time monitoring tools and simple ranking checks where speed is critical.
Tags: Google API
Parameters
| Name | Required | Type | Default | Description |
|---|---|---|---|---|
| query | Yes | string | The search query for Google Search (e.g., 'coffee shops', 'how to bake a cake'). | |
| page | No | integer | 0 | The results page number. Use 0 for the first page, 1 for the second, and so on. |
| html | No | boolean | false | Set to true to return the raw HTML of the Google search results page alongside the structured data. |
| language | No | string | en | Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language. |
| lr | No | string | Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See Google LR Language. | |
| domain | No | string | google.com | The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See Google Domains. |
| country | No | string | us | Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries. |
| cr | No | string | Limits results to search results from specific countries. Format: 'countryXX'. See Google CR Countries. | |
| uule | No | string | Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it. | |
| location | No | string | The textual location name (e.g., 'New York, NY') to localize the search results. | |
| ludocid | No | string | Google local business CID (place identifier). Used to target a specific Google Business Profile / local listing. Advanced parameter — if you don’t know it, you can omit it. | |
| lsig | No | string | Signature parameter (lsig) sometimes required for certain Knowledge Graph / local map view features. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty. | |
| kgmid | No | string | Knowledge Graph entity/listing ID (KGMID) used to retrieve details for a specific entity. This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty. | |
| si | No | string | Cached search context parameter (si) used to reproduce specific Google search result views/context (e.g. some Knowledge Graph tabs). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty. | |
| ibp | No | string | Parameter (ibp) used to control certain Google UI expansions or rendering modes (commonly in local/business result views). This is an advanced technical parameter — if you’re not familiar with it, you can leave it empty. | |
| uds | No | string | Advanced filter token (uds) used for specific Google search sub-filters. This is an advanced technical parameter, usually provided by Google in filter options/results — if you’re not familiar with it, you can leave it empty. | |
| tbs | No | string | Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty. | |
| safe | No | string | off | SafeSearch filter setting. Set to 'active' to filter adult content, or 'off' to disable it. |
| nfpr | No | string | 0 | Controls Google's auto-correction. Set to '1' to exclude corrected results, '0' to include them. |
| filter | No | string | Toggle 'Similar Results' and 'Omitted Results' filters. Set to '1' (default) to enable, '0' to disable. |
Copy Request
bash
curl -X GET "https://api.justserpapi.com/api/v1/google/search/light?query=coffee" \
-H "X-API-Key: YOUR_API_KEY"js
const res = await fetch("https://api.justserpapi.com/api/v1/google/search/light?query=coffee", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);python
import requests
url = "https://api.justserpapi.com/api/v1/google/search/light"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
"query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())php
<?php
$url = "https://api.justserpapi.com/api/v1/google/search/light?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/search/light?query=coffee", nil)
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}Response
Example:
json
{
"code": 200,
"message": "success",
"data": {
"search_information": {
"query_displayed": "coffee",
"organic_results_state": "Results for exact spelling"
},
"menu_items": [
{
"title": "Maps",
"link": "https://www.google.com/url?q=http://maps.google.com/maps%3Fq%3Dcoffee%26gl%3Dus%26hl%3Den%26gbv%3D1%26um%3D1%26ie%3DUTF-8%26ved%3D1t:200713%26ictx%3D111&opi=89978449&sa=U&ved=0ahUKEwin-8z31PGSAxWkDkQIHdxnFaIQiaAMCAYoAQ&usg=AOvVaw1zgfyvCeJtD4MMV1VJNTqH",
"position": 1
},
{
"title": "Images",
"link": "https://www.google.com/search?q=coffee&sca_esv=977e0bbde19a8b17&gl=us&hl=en&gbv=1&tbm=isch&source=lnms&sa=X&ved=0ahUKEwin-8z31PGSAxWkDkQIHdxnFaIQ_AUIBygC",
"position": 2
},
{
"title": "Videos",
"link": "https://www.google.com/search?q=coffee&sca_esv=977e0bbde19a8b17&gl=us&hl=en&gbv=1&tbm=vid&source=lnms&sa=X&ved=0ahUKEwin-8z31PGSAxWkDkQIHdxnFaIQ_AUICCgD",
"position": 3
},
{
"title": "News",
"link": "https://www.google.com/search?q=coffee&sca_esv=977e0bbde19a8b17&gl=us&hl=en&gbv=1&tbm=nws&source=lnms&sa=X&ved=0ahUKEwin-8z31PGSAxWkDkQIHdxnFaIQ_AUICSgE",
"position": 4
},
{
"title": "Books",
"link": "https://www.google.com/search?q=coffee&sca_esv=977e0bbde19a8b17&gl=us&hl=en&gbv=1&udm=36&source=lnms&sa=X&ved=0ahUKEwin-8z31PGSAxWkDkQIHdxnFaIQ_AUICigF",
"position": 5
}
],
"local_results": [
{
"position": 1,
"title": "Flying Horse Cafe",
"place_id": "409109394382565426",
"rating": "4.6",
"reviews": "675",
"description": ""
},
{
"position": 2,
"title": "Tierra a Taza Coffee Co.",
"place_id": "11595788720473303886",
"rating": "4.7",
"reviews": "52",
"description": ""
},
{
"position": 3,
"title": "Weekend Coffee",
"place_id": "13569179437802901556",
"rating": "4.5",
"reviews": "405",
"description": ""
}
],
"peopleAlsoAskedFor": [
{}
],
"organic_results": [
{
"title": "Coffee - Wikipedia",
"displayed_link": "https://en.wikipedia.org › wiki › Coffee",
"snippet": "Coffee is a beverage brewed from roasted, ground coffee beans. Darkly colored, bitter, and slightly acidic, coffee has a stimulating effect on humans",
"date": "",
"missing": [],
"link": "https://en.wikipedia.org/wiki/Coffee",
"favicon": "https://www.google.com/s2/favicons?domain=en.wikipedia.org",
"rank": 1,
"page_rank": 1
},
{
"title": "Lavazza Coffee: Beans, Capsules, Pods and Ground",
"displayed_link": "https://www.lavazzausa.com › coffee",
"snippet": "4–7 day delivery 30-day returnsExplore Lavazza Coffee, featuring a selection of whole beans, ground coffee, and capsules. Experience authentic Italian espresso at home with every cup.",
"date": "4–7 day delivery",
"missing": [],
"link": "https://www.lavazzausa.com/en/coffee",
"favicon": "https://www.google.com/s2/favicons?domain=www.lavazzausa.com",
"rank": 2,
"page_rank": 2
},
{
"title": "Couplet Coffee | Fresh Coffee Made Fun & Approachable",
"displayed_link": "https://coupletcoffee.com",
"snippet": "We're making specialty coffee you can can drink and enjoy without pretentiousness and bluff. Think fun and approachable. Inclusivity is at the core of what we ...",
"date": "",
"missing": [],
"link": "https://coupletcoffee.com/?srsltid=AfmBOoomppOQa6grSHJ1G01f_kFD7414DaZTqPFzAIU47dm9eKOtnqk2",
"favicon": "https://www.google.com/s2/favicons?domain=coupletcoffee.com",
"rank": 3,
"page_rank": 3
},
{
"title": "Peet's Coffee | The Original Craft Coffee Since 1966",
"displayed_link": "https://www.peets.com",
"snippet": "Since 1966, Peet's Coffee has sourced and offered superior coffees and teas adhered to strict high-quality and taste standards. Shop online today.",
"date": "",
"missing": [],
"link": "https://www.peets.com/",
"favicon": "https://www.google.com/s2/favicons?domain=www.peets.com",
"rank": 4,
"page_rank": 4
},
{
"title": "Ground & Whole Bean Coffee - Community Coffee",
"displayed_link": "https://www.communitycoffee.com › products › coffee",
"snippet": "Free delivery over $45 30-day returnsShop and find your perfect Community Coffee roast. Our premium coffee blends use 100% select Arabica coffee beans roasted Medium-Dark to ...",
"date": "Free delivery over $45",
"missing": [],
"link": "https://www.communitycoffee.com/products/coffee?srsltid=AfmBOopEgVWYujAEv72z0GmhfPzxLCPX8VQUnJ9xwDBpQfVtdglqXunP",
"favicon": "https://www.google.com/s2/favicons?domain=www.communitycoffee.com",
"rank": 5,
"page_rank": 5
},
{
"title": "Coffee - The Nutrition Source",
"displayed_link": "https://nutritionsource.hsph.harvard.edu › food-features › coffee",
"snippet": "A plain “black” cup of coffee is a very low calorie drink—8 ounces only contains 2 calories! However, adding sugar, cream, and milk can quickly bump up the ...",
"date": "",
"missing": [],
"link": "https://nutritionsource.hsph.harvard.edu/food-features/coffee/",
"favicon": "https://www.google.com/s2/favicons?domain=nutritionsource.hsph.harvard.edu",
"rank": 6,
"page_rank": 6
},
{
"title": "Finally understand why people care about coffee - Reddit",
"displayed_link": "https://www.reddit.com › Coffee › comments › finally_understand_why_people_...",
"snippet": "I reset my standards by drinking Folgers coffee brewed in a poorly maintained Bunn machine at work.",
"date": "14 hours ago",
"missing": [],
"link": "https://www.reddit.com/r/Coffee/comments/1rcnzem/finally_understand_why_people_care_about_coffee/",
"favicon": "https://www.google.com/s2/favicons?domain=www.reddit.com",
"rank": 7,
"page_rank": 7
},
{
"title": "Coffee Basics: Varieties - Counter Culture Coffee",
"displayed_link": "https://counterculturecoffee.com › blogs › coffee-basics-varieties",
"snippet": "Free delivery over $30The genus of coffee is Coffea, and under that, there are at least 129 species. These include the two most commonly grown species: coffea arabica and coffea ...",
"date": "Free delivery over $30",
"missing": [],
"link": "https://counterculturecoffee.com/blogs/counter-culture-coffee/coffee-basics-varieties?srsltid=AfmBOoq3gvMMnqnWDye6QFceec6kb3xHrSOYp7saHrh1HSpri6kUBVXv",
"favicon": "https://www.google.com/s2/favicons?domain=counterculturecoffee.com",
"rank": 8,
"page_rank": 8
},
{
"title": "What is coffee? - NCA - About Coffee",
"displayed_link": "https://www.aboutcoffee.org › Origins",
"snippet": "What is coffee made of? Learn about the coffee tree, its lifespan, how it produces coffee beans, and the two most common coffee species, arabica and ...",
"date": "",
"missing": [],
"link": "https://www.aboutcoffee.org/origins/what-is-coffee/",
"favicon": "https://www.google.com/s2/favicons?domain=www.aboutcoffee.org",
"rank": 9,
"page_rank": 9
},
{
"title": "Starbucks Coffee Company",
"displayed_link": "https://www.starbucks.com",
"snippet": "Explore our winter menu of handcrafted drinks, order ahead, sign up for Starbucks® Rewards, manage your gift card and more.",
"date": "",
"missing": [],
"link": "https://www.starbucks.com/",
"favicon": "https://www.google.com/s2/favicons?domain=www.starbucks.com",
"rank": 10,
"page_rank": 10
}
],
"relatedSearches": [
{
"query": "Coffee types",
"link": "https://google.com/search?gl=us&q=Coffee+types"
},
{
"query": "Coffee nearby",
"link": "https://google.com/search?gl=us&q=Coffee+nearby"
},
{
"query": "Coffee brands",
"link": "https://google.com/search?gl=us&q=Coffee+brands"
},
{
"query": "Coffee beans",
"link": "https://google.com/search?gl=us&q=Coffee+beans"
},
{
"query": "Coffee benefits",
"link": "https://google.com/search?gl=us&q=Coffee+benefits"
},
{
"query": "Coffee powder",
"link": "https://google.com/search?gl=us&q=Coffee+powder"
},
{
"query": "Coffee name",
"link": "https://google.com/search?gl=us&q=Coffee+name"
},
{
"query": "Coffee Starbucks",
"link": "https://google.com/search?gl=us&q=Coffee+Starbucks"
}
],
"pagination": {
"page_no": {}
}
},
"requestId": "b53febfd-ccde-497f-ae1f-74c19a511a48",
"timestamp": 1771920147927
}