> ## Documentation Index > Fetch the complete documentation index at: https://help.decodo.com/llms.txt > Use this file to discover all available pages before exploring further. # 参数 > /search 的请求参数和响应字段：查询、地理定位、UULE、语言和分页。 /search 是获取 SERP 结果最快捷的方式。 ## 输入参数 /search 可用的请求参数： | 参数 | 类型 | 必填 | 描述 | | :- | :- | :- | :- | | `query` | string | ✅ | 搜索查询。 | | `geo` | string | | 设置提交查询时使用的国家/地区。接受完整的国家/地区名称或 2 位字母国家/地区代码，不区分大小写。可用位置的完整列表请参见[**此处**](/docs/cn/web-data-api-scrape-localisation)。 | | `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 端点 ```text theme={null} https://data.decodo.com/v1/search ``` ### 请求示例 ```shellscript cURL theme={null} # 将 '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" } ' ``` ```javascript Node theme={null} 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() ``` ```python Python theme={null} 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`。 | #### 输出示例 ```json JSON expandable theme={null} { "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](mailto:support@decodo.com) 联系我们。 找不到您要找的内容？请求一篇文章！ \ 有反馈意见？分享您对我们如何改进的想法。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.