输入参数
/search 可用的请求参数：| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
query | string | ✅ | 搜索查询。 |
geo | string | 设置提交查询时使用的国家/地区。接受完整的国家/地区名称或 2 位字母国家/地区代码，不区分大小写。可用位置的完整列表请参见此处。 | |
uule | string | UULE（Universal URL Language Encoder，通用 URL 语言编码器）是添加到 Google 搜索 URL 中的特殊参数，可让用户模拟从特定地理位置进行搜索。 如果同时设置了 geo 和 uule 参数，将使用 uule 参数。 | |
gl | string | 2 位字母国家/地区代码。 如果同时设置了 geo 和 gl 参数，将使用 geo 参数。 | |
locale | string | 设置此值可更改 Google 搜索页面的网页界面语言。 | |
page | integer | 设置要返回的搜索结果页码。默认值为 1。 |
POST 端点
https://data.decodo.com/v1/search
请求示例
# 将 'TOKEN VALUE' 替换为您的 API 密钥
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" // 替换为您的 API 密钥
},
}).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" # 替换为您的 API 密钥
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
输出
响应是一个JSON 对象，包含以下字段。
| 结果键 | 描述 |
|---|---|
status | 作业状态，可能为 done 或 faulted。如果 Google 未返回自然搜索结果，状态将为 done，但 organic 数组为空。 |
url | 该查询对应的 Google 搜索 URL。可能为空字符串。 |
organic | 自然搜索结果数组。每条结果包含 rank、title、link、original_link、description 和 extensions。 |
top_stories | 当搜索查询与新闻相关时返回的文章数组。 |
people_also_ask | 来自 Google“相关问题”（People also ask）框的相关问题数组。每一项包含 question，并可能包含 link。当 Google 未显示该框时为空。 |
related_searches | 相关查询数组。每一项包含 query 和 link。 |
answer_box | Google 的精选答案，以对象形式返回。当 Google 未显示精选答案时为空（{}）。 |
search_parameters | 执行搜索时使用的参数，例如 query、gl、locale 和 page。 |
输出示例
{
"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@decodo.com 联系我们。
您也可以随时通过电子邮件 support@decodo.com 联系我们。
反馈
找不到您要找的内容？请求一篇文章！
有反馈意见？分享您对我们如何改进的想法。
有反馈意见？分享您对我们如何改进的想法。