Input Parameters
Request parameters available for /search:| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | ✅ | Search query. |
geo | string | Set the country to use when submitting the query. The full list of locations available can be found here. | |
uule | string | UULE (Universal URL Language Encoder) is a special parameter added to Google search URLs that lets users simulate searching from a specific geographic location. If both geo and uule parameters are set, the uule parameter will be used. | |
gl | string | 2-letter country code. If both geo and gl parameters are set, the geo parameter will be used. | |
locale | string | Set the value to change your Google search page web interface language. | |
page | integer | Set which page of search results should be returned. Default value is 1. |
POST Endpoint
https://data.decodo.com/v1/search
Request Examples
# update 'TOKEN VALUE' with your API KEY
curl --request 'POST' \
--url 'https://data.decodo.com/v1/search' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer TOKEN VALUE' \
--header 'Content-Type: application/json' \
--data '
{
"query": "laptop"
}
'
const scrape = async() => {
const response = await fetch("https://data.decodo.com/v1/search", {
method: "POST",
body: JSON.stringify({
"query": "laptop"
}),
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer TOKEN VALUE" // update with your API KEY
},
}).catch(error => console.log(error));
console.log(await response.json())
}
scrape()
import requests
url = "https://data.decodo.com/v1/search"
payload = {
"query": "laptop"
}
headers = {
"accept": "application/json",
"content-type": "application/json",
"authorization": "Bearer TOKEN VALUE" # update with your API KEY
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
Output
Descriptions for fields in the parsedJSON results section are provided in the table below.
| Results key | Description |
|---|---|
organic | An array of organic search results with their detailed information. |
top_stories | An array of articles with their detailed information, when search query is news related. |
status | Job status can be one of done or faulted. If Google returns no organic results status will be done, but organic array will be empty. |
Output Example
{
"status": "done",
"url": "https://www.google.com/search?hl=en&gl=US&q=laptop",
"organic": [
{
"link": "https://www.bestbuy.com/site/laptop-computers/all-laptops/pcmcat138500050001.c?id=pcmcat138500050001",
"title": "PC Laptop, Notebook - Best Buy",
"description": "4.6 2.1K · 15-day returns Shop all new laptops at Best Buy. Compare and read reviews on the vast selection of laptop computers, notebooks and new PC and Mac laptops.",
"extensions": [],
"rank": 1
},
{
"link": "https://www.nytimes.com/wirecutter/reviews/best-laptops/",
"title": "The 14 Best Laptops of 2026 | Reviews by Wirecutter",
"description": "Mar 23, 2026 · From budget-friendly options to thin-and-light ultrabooks to powerful gaming laptops, we've spent hundreds of hours finding the best laptops ...",
"extensions": [],
"rank": 2
},
{
"link": "https://www.walmart.com/cp/computers-laptops-tablets/1089430",
"title": "Computer Laptops and Tablets - Walmart.com",
"description": "4.2 3.9K · Free 90-day returns Shop laptops, desktops, tablets, and accessories from top brands at Walmart. Great prices for work, school, gaming, and home.",
"extensions": [],
"rank": 3
},
{
"link": "https://www.amazon.com/Notebooks-Laptop-Computers/b?ie=UTF8&node=565108",
"title": "Amazon.com: Laptops - Computers & Tablets: Electronics",
"description": "Shop a wide selection of Laptops including 2 in 1 and traditional laptops at Amazon.com. Free shipping and free returns on eligible items.",
"extensions": [],
"rank": 4
},
{
"link": "https://www.hp.com/us-en/shop/cat/laptops",
"title": "Laptops - HP® Store",
"description": "Shop HP laptops for work or play. Discover powerful ENVY, OMEN, and more. Find the perfect laptop for your needs. Shop now!",
"extensions": [],
"rank": 5
},
{
"link": "https://www.laptopmag.com/",
"title": "Laptop Mag: Find the Perfect Laptop, Tablet or 2-in-1 for You",
"description": "Laptop Mag reviews and benchmarks the latest laptops, tablets and 2-in-1s; takes you hands-on with new products; and helps you save time with smart tips.",
"extensions": [],
"rank": 6
},
{
"link": "https://www.dell.com/en-us/shop/dell-laptops/scr/laptops",
"title": "Shop Laptops for Business, Gaming & Student | Dell USA",
"description": "4.7 243 · Free delivery Whether for work, entertainment, or gaming, Dell laptops consistently strive to offer a harmonious blend of performance, design, and reliability.",
"extensions": [],
"rank": 7
},
{
"link": "https://www.lenovo.com/us/en/d/deals/laptops/?srsltid=AfmBOorgmZEsO2m-OON76gYSqnMBjrSSTlE7N28ecGdAWhSWBULYtY6p",
"title": "Laptops Deal: Find Great Laptop Computers on Sale | Lenovo US",
"description": "4.0 517 · Free delivery · 30-day returns Find Lenovo's best laptop deals today! We offers a wide range of laptops on sale, including Yoga, Ideapad, ThinkPad, Legion, and Thinkbook.",
"extensions": [],
"rank": 8
},
{
"link": "https://www.bhphotovideo.com/laptops",
"title": "Laptops | Notebooks and Laptop Computers - B&H Photo",
"description": "B&H stocks a comprehensive array of portable computing solutions, from Apple to VAIO laptops, touch-screen 2 in 1 models to top-rated laptops for students.",
"extensions": [],
"rank": 9
},
{
"link": "https://www.pcmag.com/picks/the-best-laptops",
"title": "The Best Laptops We've Tested (May 2026) | PCMag",
"description": "May 1, 2026 · Our Top Tested Picks · HP OmniBook 5 14 · Dell XPS 14 (2026) · Apple MacBook Air 13-Inch (2026, M5) · Apple MacBook Neo · MSI Prestige 14 Flip ...",
"extensions": [],
"rank": 10
}
],
"top_stories": [],
"people_also_ask": [],
"related_searches": [
{
"query": "Laptop Apple",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+Apple&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAI"
},
{
"query": "Laptop for gaming",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+for+gaming&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAQ"
},
{
"query": "Laptop HP",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+HP&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAY"
},
{
"query": "Laptop Best Buy",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+Best+Buy&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAg"
},
{
"query": "Laptop touch screen",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+touch+screen&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAo"
},
{
"query": "Laptop Windows",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+Windows&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEAw"
},
{
"query": "Laptop for school",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+for+school&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEA4"
},
{
"query": "Laptop Walmart",
"link": "https://www.google.com/search?sca_esv=2fd5b39ab3b9e7c8&hl=en&gl=US&q=Laptop+Walmart&sa=X&ved=2ahUKEwik0t3IrtaUAxXGVKQEHZA6FTIQ1QJ6BAgMEBA"
}
],
"answer_box": {}
}
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.