> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/api-targets/cn/e-commerce/amazon/search.md). # 搜索 使用网页爬虫API 抓取 Amazon 搜索结果。借助 JS 渲染、地理定位和示例获取产品标题、价格、评分等信息。 该 `amazon_search` 数据源旨在检索 Amazon 搜索结果页面。要查看包含检索数据的响应示例，请下载 [**此** **示例输出**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiwDdoZGfMbUe5cRL2417%2Fuploads%2Fyg8tdLTqrajAxhtjiuR5%2Famazon_search.json?alt=media\&token=f02b1ceb-70f6-45cd-9f7c-7247196b2bd6) HTML 格式的文件，或查看结构化数据输出 [**这里**](#structured-data). {% hint style="info" %} 查看输出 [**数据字典**](#data-dictionary) 适用于每个 Amazon Search 功能，提供简要说明、截图、解析后的 JSON 代码片段，以及定义每个解析字段的表格。可使用右侧导航或向下滚动页面查看详细信息。 {% endhint %} ## 请求示例 在下面的代码示例中，我们发送请求以从 `amazon.com`检索结果，其中包括 `2` 搜索结果页面，从第 `#2` 页开始，搜索词为 `nirvana tshirt`。此外，搜索将限制为分类 ID： `16391693031` 并且价格以 `USD` 货币显示。 {% tabs %} {% tab title="cURL" %} ```bash curl 'https://realtime.oxylabs.io/v1/queries' \ --user 'USERNAME:PASSWORD' \ -H 'Content-Type: application/json' \ -d '{ "source": "amazon_search", "domain": "com", "query": "nirvana tshirt", "start_page": 2, "pages": 2, "parse": true, "context": [ {"key": "category_id", "value": "16391693031"}, {"key": "currency", "value": "USD"}, {"key": "refinements", "value": ["p_123:256097"]}, {"key": "sort_by", "value": "featured"} ] }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # 构造载荷。 payload = { 'source': 'amazon_search', 'domain': 'com', 'query': 'nirvana tshirt', 'start_page': 2, 'pages': 2, 'parse': True, 'context': [ {'key': 'category_id', 'value': 16391693031}, {'key': 'currency', 'value': 'USD'}, {"key": "refinements", "value": ["p_123:256097"]}, {"key": "sort_by", "value": "featured"} ], } # 获取响应。 response = requests.request( 'POST', 'https://realtime.oxylabs.io/v1/queries', auth=('USERNAME', 'PASSWORD'), json=payload, ) # 将美化后的响应打印到标准输出。 pprint(response.json()) ``` {% endtab %} {% tab title="Node.js" %} ```javascript const https = require("https"); const username = "USERNAME"; const password = "PASSWORD"; const body = { source: "amazon_search", domain: "com", query: "nirvana tshirt", start_page: 2, pages: 2, parse: true, sort_by: "featured", refinements: "p_123:256097", context: [ { key: "category_id", value: "16391693031" }, { key: "currency", value: "USD" }, {"key": "refinements", "value": ["p_123:256097"]}, {"key": "sort_by", "value": "featured"}, ], }; const options = { hostname: "realtime.oxylabs.io", path: "/v1/queries", method: "POST", headers: { "Content-Type": "application/json", Authorization: "Basic " + Buffer.from(`${username}:${password}`).toString("base64"), }, }; const request = https.request(options, (response) => { let data = ""; response.on("data", (chunk) => { data += chunk; }); response.on("end", () => { const responseData = JSON.parse(data); console.log(JSON.stringify(responseData, null, 2)); }); }); request.on("error", (error) => { console.error("Error:", error); }); request.write(JSON.stringify(body)); request.end(); ``` {% endtab %} {% tab title="HTTP" %} ```http https://realtime.oxylabs.io/v1/queries?source=amazon_search&domain=com&query=nirvana%20tshirt&start_page=2&pages=2&sort_by=featured&refinements[0]=p_123:256097&parse=true&context[0][key]=category_id&context[0][value]=16391693031&context[1][key]=currency&context[1][value]=USD&access_token=12345abcde ``` {% endtab %} {% tab title="PHP" %} ```php 'amazon_search', 'domain' => 'com', 'query' => 'nirvana tshirt', 'start_page' => 2, 'pages' => 2, 'parse' => true, 'sort_by' => 'featured', 'refinements' => 'p_123:256097', 'context' => [ ['key' => 'category_id', 'value' => 16391693031], ['key' => 'currency', 'value' => 'USD'], ['key': 'refinements', 'value': ['p_123:256097']], ['key' => 'sort_by', 'value' => 'featured'] ] ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD"); $headers = array(); $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); ``` {% endtab %} {% tab title="Golang" %} ```go package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { const Username = "USERNAME" const Password = "PASSWORD" payload := map[string]interface{}{ "source": "amazon_search", "domain": "com", "query": "nirvana tshirt", "start_page": 2, "pages": 2, "parse": true, "context": []map[string]interface{}{ {"key": "category_id", "value": "16391693031"}, {"key": "currency", "value": "USD"}, {"key": "refinements", "value": []string{"p_123:256097"}}, {"key": "sort_by", "value": "featured"}, }, } jsonValue, _ := json.Marshal(payload) client := &http.Client{} request, _ := http.NewRequest("POST", "https://realtime.oxylabs.io/v1/queries", bytes.NewBuffer(jsonValue), ) request.SetBasicAuth(Username, Password) response, _ := client.Do(request) responseText, _ := ioutil.ReadAll(response.Body) fmt.Println(string(responseText)) } ``` {% endtab %} {% tab title="C#" %} ```csharp using System; using System.Collections.Generic; using System.Net.Http; using System.Net.Http.Json; using System.Threading.Tasks; namespace OxyApi { class Program { static async Task Main() { const string Username = "USERNAME"; const string Password = "PASSWORD"; var parameters = new { source = "amazon_search", domain = "com", query = "nirvana tshirt", start_page = 2, pages = 2, parse = true, sort_by: "featured", refinements: "p_123:256097", context = new dynamic [] { new { key = "category_id", value = 16391693031 }, new { key = "currency", value = "USD" }, new { key = "refinements", value = new object[] {"p_123:256097"}}, new { key = "sort_by", value = "featured"} } }; var client = new HttpClient(); Uri baseUri = new Uri("https://realtime.oxylabs.io"); client.BaseAddress = baseUri; var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries"); requestMessage.Content = JsonContent.Create(parameters); var authenticationString = $"{Username}:{Password}"; var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString)); requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString); var response = await client.SendAsync(requestMessage); var contents = await response.Content.ReadAsStringAsync(); Console.WriteLine(contents); } } } ``` {% endtab %} {% tab title="Java" %} ```java package org.example; import okhttp3.*; import org.json.JSONArray; import org.json.JSONObject; import java.util.concurrent.TimeUnit; public class Main implements Runnable { private static final String AUTHORIZATION_HEADER = "Authorization"; public static final String USERNAME = "USERNAME"; public static final String PASSWORD = "PASSWORD"; public void run() { JSONObject jsonObject = new JSONObject(); jsonObject.put("source", "amazon_search"); jsonObject.put("domain", "com"); jsonObject.put("query", "nirvana tshirt"); jsonObject.put("start_page", 2); jsonObject.put("pages", 2); jsonObject.put("parse", true); jsonObject.put("context", new JSONArray() .put(new JSONObject() .put("key", "category_id") .put("value", "16391693031")) .put(new JSONObject() .put("key", "currency") .put("value", "USD")) .put(new JSONObject() .put("key", "refinements") .put("value", new JSONArray() .put("p_123:256097"))) .put(new JSONObject() .put("key", "sort_by") .put("value", "featured")) ); Authenticator authenticator = (route, response) -> { String credential = Credentials.basic(USERNAME, PASSWORD); return response .request() .newBuilder() .header(AUTHORIZATION_HEADER, credential) .build(); }; var client = new OkHttpClient.Builder() .authenticator(authenticator) .readTimeout(180, TimeUnit.SECONDS) .build(); var mediaType = MediaType.parse("application/json; charset=utf-8"); var body = RequestBody.create(jsonObject.toString(), mediaType); var request = new Request.Builder() .url("https://realtime.oxylabs.io/v1/queries") .post(body) .build(); try (var response = client.newCall(request).execute()) { if (response.body() != null) { try (var responseBody = response.body()) { System.out.println(responseBody.string()); } } } catch (Exception exception) { System.out.println("Error: " + exception.getMessage()); } System.exit(0); } public static void main(String[] args) { new Thread(new Main()).start(); } } ``` {% endtab %} {% tab title="JSON" %} ```json { "source": "amazon_search", "domain": "com", "query": "nirvana tshirt", "start_page": 2, "pages": 2, "parse": true, "context": [ {"key": "category_id", "value": "16391693031"}, {"key": "currency", "value": "USD"}, {"key": "refinements", "value": ["p_123:256097"]}, {"key": "sort_by", "value": "featured"} ] } ``` {% endtab %} {% endtabs %} 我们在示例中使用同步 [**Realtime**](/products/cn/web-scraper-api/integration-methods/realtime.md) 集成方法。如果您想使用 [**Proxy Endpoint**](/products/cn/web-scraper-api/integration-methods/proxy-endpoint.md) 或异步 [**Push-Pull**](/products/cn/web-scraper-api/integration-methods/push-pull.md) 集成，请参阅 [**集成方法**](/products/cn/web-scraper-api/integration-methods.md) 部分。 ## 请求参数值 ### 通用 用于抓取 Amazon 搜索结果的基本设置和自定义选项。
参数说明默认值
source设置爬虫。amazon_search
query要搜索的关键词或短语。-
render启用 JavaScript 渲染，当设置为 html. 更多信息.-
parse返回解析后的数据，当设置为 true。查看输出 数据字典.false
callback_url指向您的回调端点的 URL。 更多信息.-
user_agent_type设备类型和浏览器。完整列表可在 这里.desktop
context:
currency		设置货币。可用值请查看 这里.-
\- 必需参数 ### 本地化 将结果适配到特定地理位置、域名和语言。 | 参数 | 说明 | 默认值 | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ----- | | `geo_location` | 该 *配送到* 位置。请参阅我们关于使用此参数的指南 [**这里**](/products/cn/web-scraper-api/features/localization/proxy-location.md#list-of-supported-geo_location-values). | - | | `domain` | Amazon 的域名本地化。可用域名完整列表可在 [**这里**](/products/cn/web-scraper-api/features/localization/domain-locale.md#domain). | `com` | | `locale` | `Accept-Language` 标头值，用于设置 Amazon 页面界面语言。 [**更多信息**](/products/cn/web-scraper-api/features/localization/domain-locale.md#amazon). | - | {% hint style="warning" %} **重要：** 在大多数页面类型中，Amazon 会根据客户的配送位置调整返回结果。因此，我们建议使用 `geo_location` 参数来设置您首选的配送位置。您可以进一步阅读如何使用 `geo_location` 与 Amazon 配合使用 [**这里**](broken://pages/8931e43529976f20d349248bd18bb7ad8c63a051). {% endhint %} ### 分页 用于管理搜索结果分页和检索的控制项。
参数说明默认值
start_page起始页码。1
pages要抓取的页数。1
### 排序和筛选 用于控制搜索结果页面的排序和筛选。
参数说明默认值
context:
sort_by		根据 Amazon 中可用值之一设置搜索结果页的排序类型：
"most_recent", "price_low_to_high", "price_high_to_low", "featured", "average_review", "bestsellers".		-
context:
refinements

一个 列表 Amazon 搜索细化参数，用于对搜索结果应用特定筛选。这些参数对应 Amazon 的动态筛选选项（例如品牌、价格范围、功能），并遵循 Amazon 的内部参数格式，例如 p_123:256097 或 p_n_feature_twenty-eight_browse-bin:98209020031.

由于筛选选项因类目而异，并由 Amazon 动态生成，推荐的工作流程是：

  1. 首先，使用 parse: true 来发现可用的筛选项
  2. 从解析后的响应中提取所需的筛选参数
  3. 在后续请求中通过 refinements 该字段应用特定筛选
-
context:
min_price / max_price		按价格区间筛选结果。两个值均以分为单位，而不是主货币单位： min_price: 5000 与 max_price: 10000 可返回 $50.00 到 $100.00 之间的商品。必须为正整数。任一参数都可单独使用。
context:
category_id		搜索特定 Amazon 节点（产品类目）中的商品。-
context:
merchant_id		搜索由特定卖家销售的商品。-
## 结构化数据
amazon_search 结构化输出 ```json { "results": [ { "content": { "url": "https://www.amazon.com/s?k=nirvana+tshirt&page=2&rh=n:9056987011,p_123:798807,p_36:2000-3000&dc=&s=featured-rank&language=en_US", "page": 2, "query": "nirvana tshirt", "results": { "paid": [], "organic": [ { "asin": "B081WPY1MC", "best_seller": false, "brand": "Nirvana", "currency": "USD", "is_amazons_choice": false, "is_prime": false, "is_sponsored": false, "manufacturer": "", "pos": 1, "price": 21.32, "price_upper": 21.32, "pricing_count": 1, "rating": 4.6, "reviews_count": 45, "shipping_information": "$4.99 于 9月8日 周二送达", "title": "白色笑脸乐队标志 Nevermind 官方男士黑色 M 码 T 恤", "url": "/Nirvana-Shirt-Smiley-Nevermind-Official/dp/B081WPY1MC/ref=sr_1_49?dib=eyJ2IjoiMSJ9.oPbaPBBwR_sTyNSNbEE--crmbW5quxaAceWmMnxOLMqN2FQrV8D6aywToGuZC6bNGF...", "url_image": "https://m.media-amazon.com/images/I/5146N-pAY1L._AC_UL320_.jpg" }, { "asin": "B07WDDL9MQ", "best_seller": false, "brand": "Nirvana", "currency": "USD", "is_amazons_choice": false, "is_prime": false, "is_sponsored": false, "manufacturer": "", "pos": 2, "price": 24.95, "price_upper": 24.95, "pricing_count": 1, "rating": 4.4, "reviews_count": 18, "shipping_information": "$4.95 于 9月8日 周二送达", "title": "男士吉他现场照片 T 恤，黑色，XXL 码", "url": "/Nirvana-Guitar-Photo-T-Shirt-XX-Large/dp/B07WDDL9MQ/ref=sr_1_50?dib=eyJ2IjoiMSJ9.oPbaPBBwR_sTyNSNbEE--crmbW5quxaAceWmMnxOLMqN2FQrV8D6aywToGuZC6bNGF7N...", "url_image": "https://m.media-amazon.com/images/I/61mqEopXqeL._AC_UL320_.jpg" }, { "...": "..." }, { "asin": "B07VYLQDY4", "best_seller": false, "brand": "Nirvana", "currency": "USD", "is_amazons_choice": false, "is_prime": false, "is_sponsored": false, "manufacturer": "", "pos": 48, "price": 24, "price_upper": 24, "pricing_count": 1, "rating": 4.6, "reviews_count": 3, "shipping_information": "$4.95 于 9月8日 周二送达", "title": "男士纯色 T 恤，中号，黑色", "url": "/Nirvana-Colour-T-Shirt-Medium-Black/dp/B07VYLQDY4/ref=sr_1_96?dib=eyJ2IjoiMSJ9.oPbaPBBwR_sTyNSNbEE--crmbW5quxaAceWmMnxOLMqN2FQrV8D6aywToGuZC6bNGF7N9s...", "url_image": "https://m.media-amazon.com/images/I/61CD7D+wZmL._AC_UL320_.jpg" } ], "suggested": [], "amazons_choices": [] }, "refinements": { "brands": [ { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_36%3A2000-3000&s=featured-rank&dc&language=en...", "name": "Nirvana", "refinement_display_name": "品牌", "value": "n:9056987011,p_123/798807" }, { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_123%3A3898204%257C798807%2Cp_36%3A2000-3000&s...", "name": "Rock Off 官方授权产品", "refinement_display_name": "品牌", "value": "n:9056987011,p_123/3898204" } ], "price_20_30_reset_price_range": [ { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_123%3A798807%2Cp_36%3A-2500&s=featured-rank&d...", "name": "最高 $25", "refinement_display_name": "价格", "value": "n:9056987011,p_36/dynamic-picker-0" }, { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_123%3A798807%2Cp_36%3A2500-&s=featured-rank&d...", "name": "$25 及以上", "refinement_display_name": "价格", "value": "n:9056987011,p_36/dynamic-picker-1" }, { "...": "..." } ], "color": [ { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_123%3A798807%2Cp_36%3A2000-3000%2Cp_n_g-10042...", "name": "应用白色筛选以缩小结果范围", "refinement_display_name": "颜色", "value": "n:9056987011,p_n_g-1004232833091/2343363011" }, { "link": "/s?k=nirvana+tshirt&i=fashion-novelty&rh=n%3A9056987011%2Cp_123%3A798807%2Cp_36%3A2000-3000%2Cp_n_g-10042...", "name": "应用蓝色筛选以缩小结果范围", "refinement_display_name": "颜色", "value": "n:9056987011,p_n_g-1004232833091/2343350011" }, { "...": "..." } ], "...": "..." }, "total_results_count": 119, "last_visible_page": 3, "parse_status_code": 12000, "delivery_postcode": "10017" }, "created_at": "2026-08-31 12:50:01", "updated_at": "2026-08-31 12:50:05", "page": 2, "url": "https://www.amazon.com/s?k=nirvana+tshirt&page=2&rh=n:9056987011,p_123:798807,p_36:2000-3000&dc=&s=featured-rank&language=en_US", "job_id": "7335269853705561089", "is_render_forced": false, "status_code": 200, "parser_type": "", "parser_preset": null }, { "...": "..." } ], "job": { "callback_url": null, "client_id": 100420, "context": [ { "key": "category_id", "value": "9056987011" }, { "key": "merchant_id", "value": null }, { "key": "currency", "value": "USD" }, { "key": "sort_by", "value": "featured" }, { "key": "refinements", "value": [ "p_123:798807" ] }, { "key": "min_price", "value": 2000 }, { "key": "max_price", "value": 3000 } ], "created_at": "2026-08-31 12:50:01", "domain": "com", "geo_location": null, "id": "7335269853705561089", "locale": null, "pages": 2, "parse": true, "query": "nirvana tshirt", "source": "amazon_search", "start_page": 2, "status": "done", "...": "..." } } ``` {% hint style="info" %} 输出示例已缩短。 {% endhint %}
## 输出数据字典 API 返回一个 HTML 或 JSON 对象，其中包含从 Amazon 获取的搜索结果。 #### HTML 示例
#### JSON 结构 所有搜索结果都包含在 `results` JSON 数组中。每个搜索结果包含以下内容的组合： `paid`, `organic`, `suggested`, `amazons_choices`,`instant_recommendations` 列表。此外，可能还会存在变体，这些变体会被捕获在 `variations` 键中，提供不同类型或类别商品的详细信息，例如各种型号、版本或款式。
键说明类型
urlAmazon 搜索页面的 URL。字符串
page当前页码。整数
pages总页数。整数
query所使用的搜索查询。字符串
results包含搜索结果的字典。对象
results.paid包含各自详情的赞助商品列表。数组
results.organic包含各自详情的自然商品列表。数组
results.suggested包含各自详情的推荐商品列表。数组
results.amazons_choices包含各自详情的 Amazon 精选商品列表。数组
refinements此搜索页面可用的筛选项列表。数组
parse_status_code解析任务的状态码。你可以查看所描述的解析器状态码 这里.整数
total_results_count该搜索查询找到的结果总数。整数
created_at抓取任务创建时的时间戳。字符串
updated_at抓取任务完成时的时间戳。字符串
job_id与抓取任务关联的任务 ID。字符串
status_code抓取任务的状态码。你可以查看所描述的抓取器状态码 这里.整数
parser_type用于解析数据的解析器类型。字符串
{% hint style="info" %} 在以下章节中，当某种结果类型有多个项目可用时，解析后的 JSON 代码片段会被缩短。 {% endhint %} ### 付费 该 `paid` 搜索结果中的“付费”部分指在 Amazon 搜索结果中显示的内嵌广告内容。
```json ... "paid": [ { "pos": 1, "url": "/sspa/click?ie=UTF8&spc=MTo3ODk3NzcxNTI0MDAzNjk1OjE3MDEwODYyODI6c3BfYXRmOjMwMDA5Mjg4ODc1NTcwMjo6MDo6&url=/IOGEAR-KeyMander-Controller-Crossover-GE1337P2/dp/B08541QCKJ/ref=sr_1_1_sspa?keywords=nintendo&qid=1701086282&sr=8-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1", "asin": "B08541QCKJ", "price": 69.99, "title": "IOGEAR KeyMander 2 键盘/鼠标适配器 Plus 控制器转换器，适用于 PS4、PS5、Xbox Series X/S、Xbox One、Nintendo Switch、GE1337P2、FPS、鼠标控制", "rating": 3.7, "currency": "USD", "is_prime": true, "url_image": "https://m.media-amazon.com/images/I/41-AZ8CCl1L._AC_UY218_.jpg", "best_seller": false, "price_upper": 69.99, "is_sponsored": true, "manufacturer": "", "pricing_count": 1, "reviews_count": 1229, "is_amazons_choice": false, "price_strikethrough": 99.95, "shipping_information": "免费送货 12月3日 周日送达，或最快 11月30日 周四送达" }, ... ] ```
键说明类型
url商品的 URL。字符串
asinAmazon 标准识别号。字符串
price商品价格。浮点数
title商品标题。字符串
rating商品评分。浮点数
rel_pos

商品在搜索结果中的相对位置。

（以下二者之一 pos 或 rel_pos 存在）

整数
pos表示列表中位置的唯一标识。（以下二者之一 pos 或 rel_pos 存在）整数
currency价格所使用的货币。字符串
url_image商品图片的 URL。字符串
best_seller表示该商品是否为畅销商品。布尔值
price_upper如果适用，则为价格上限。浮点数
is_sponsored表示该商品是否为赞助内容。布尔值
manufacturer商品制造商名称。字符串
pricing_count商品定价项数量。整数
reviews_count商品评论数量。整数
coupon_discount折扣金额。整数（可选）
coupon_discount_type折扣类型： 固定金额 或 百分比.字符串（可选）
is_amazons_choice表示该商品是否标记为“Amazon 精选”。布尔值
no_price_reason如果价格为 0.0，则说明未显示价格的原因字符串（可选）
sales_volume某个商品的销量或售出数量。字符串（可选）
is_prime表示该商品是否符合 Amazon Prime 资格。布尔值
shipping_information关于商品配送详情的信息字符串
### 自然 该 `organic` 搜索结果中的“自然”部分指根据 Amazon 搜索算法自然出现的非赞助内容。
```json ... "organic": [ ... { "pos": 5, "url": "/Purifiers-2200sq-ft-MOOKA-purifier-PR1/dp/B0DCBC8KKV/ref=sr_1_5?dib=eyJ2IjoiMSJ9.Qoe5cUAPMM1voliSq4zLfiJ0JVl_hsy805T9yDeoZdvRcrqICV-PjwCg0I67jvJVJ_PSunMweX8SvSH3-M-pI2-ugdCQ85ZkACZeyo0mFA_x-tDj-q1JTf8V3SdCA7KJlxMyHDeIT2N6NHGk7cyVsOpK-UlfWiNJ-dnu6KUIZcC82Zm0ugL-vdGTf8Qj-uDJJcWp35jlmA3m6N3XV3l8BuJVNVIXrsniboQa_FpLjLY.o9cWjzsvdrHpX_CV82v3VY104qfYcK7CkfXDFYuwlC8&dib_tag=se&keywords=air+purifier&qid=1753104496&sr=8-5", "asin": "B0DCBC8KKV", "price": 99.99, "title": "适用于家庭大房间（最多 2200 平方英尺）的空气净化器，MOOKA 家用/宠物空气净化器，带可清洗滤网、PM 2.5 显示和空气质量传感器，适用于卧室、宿舍、宠物和办公室，PR1", "rating": 4.6, "currency": "USD", "is_prime": false, "url_image": "https://m.media-amazon.com/images/I/81spn7Ork+L._AC_UY218_.jpg", "best_seller": false, "price_upper": 99.99, "is_sponsored": false, "manufacturer": "", "sales_volume": "过去一个月购买 1万+ 件", "pricing_count": 1, "reviews_count": 1431, "coupon_discount": 15, "is_amazons_choice": false, "price_strikethrough": 105.97, "coupon_discount_type": "固定金额", "shipping_information": "免费送货 7月26日 周六送达，或最快 7月23日 周三送达" }, ... ] ```
名称说明类型
pos表示列表中位置的唯一标识。整数
url商品的 URL。字符串
asinAmazon 标准识别号。字符串
price商品价格。浮点数
title商品标题。字符串
rating商品评分。浮点数
currency价格所使用的货币。字符串
is_prime表示该商品是否符合 Amazon Prime 资格。布尔值
url_image商品图片的 URL。字符串
best_seller表示该商品是否为畅销商品。布尔值
price_upper如果适用，则为价格上限。浮点数
is_sponsored表示该商品是否为赞助内容。布尔值
manufacturer商品制造商名称。字符串
sales_volume某个商品的销量或售出数量。字符串（可选）
pricing_count商品定价项数量。整数
reviews_count商品评论数量。整数
coupon_discount折扣金额。整数（可选）
coupon_discount_type折扣类型： 固定金额 或 百分比.字符串（可选）
is_amazons_choice表示该商品是否为 Amazon 精选。布尔值
price_strikethrough任何折扣前的原价。浮点数
shipping_information送达日期和运费详情。字符串
no_price_reason如果价格为 0.0，则说明未显示价格的原因字符串（可选）
variations产品不同版本或型号的列表数组
### 推荐 该 `suggested` 搜索结果中的“推荐”部分通常包含平台根据用户搜索查询、浏览历史或购买行为推荐的商品列表。
```json ... "suggested": [ { "pos": 3, "asin": "B07L4ZRJ7P", "best_seller": false, "is_sponsored": false, "is_amazons_choice": false, "manufacturer": "", "pricing_count": 1, "rating": 4.0, "reviews_count": 1, "title": "超级跑车故事", "url": "/Supercar-Story-Patrick-Mark/dp/B07L4ZRJ7P/ref=sr_1_fkmr0_1?keywords=details about mercedes benz head unit e-class w213 comand navi gps unit a21390050813&qid=1636460216&sr=8-1-fkmr0", "url_image": "https://m.media-amazon.com/images/I/81uC-IclZqL._AC_UY218_.jpg", "is_prime": false, "price": 0.0, "price_upper": 0.0, "no_price_reason": "unknown", "pos": 1, "currency": "USD", "suggested_query": "details benz head" }, ... ] ```
键说明类型
url商品的 URL。字符串
asinAmazon 标准识别号。字符串
price商品价格。浮点数
title商品标题。字符串
rating商品评分。浮点数
currency价格所使用的货币。字符串
url_image商品图片的 URL。字符串
best_seller表示该商品是否为畅销商品。布尔值
price_upper如果适用，则为价格上限。浮点数
is_sponsored表示该商品是否为赞助内容。布尔值
manufacturer商品制造商名称。字符串
pricing_count商品定价项数量。整数
reviews_count商品评论数量。整数
coupon_discount折扣金额。整数（可选）
coupon_discount_type折扣类型： 固定金额 或 百分比.字符串（可选）
is_amazons_choice表示该商品是否为 Amazon 精选。布尔值
pos表示列表中位置的唯一标识。整数
is_prime表示该商品是否符合 Amazon Prime 资格。布尔值
shipping_information关于商品配送详情的信息字符串
sales_volume某个商品的销量或售出数量。字符串（可选）
no_price_reason如果价格为 0.0，则说明未显示价格的原因字符串（可选）
suggested_queryAmazon 在搜索结果中提供的建议查询。字符串
### 亚马逊精选 该 `amazons_choices` 该版块展示带有“Amazon's Choice”徽章的产品，并因其被认为具有较高的质量和价值而获得平台推荐。
```json ... "amazons_choices": [ { "asin": "B07STGGQ18", "best_seller": false, "is_sponsored": false, "is_amazons_choice": true, "manufacturer": "", "pricing_count": 1, "rating": 4.8, "reviews_count": 9, "title": "AMD Ryzen 5 3600 4, 2GHz AM4 35MB 缓存 Wraith Stealth", "url": "/AMD-Ryzen-3600-Wraith-Stealth/dp/B07STGGQ18/ref=sr_1_3?dchild=1&keywords=0730143309936&qid=1600153905&sr=8-3", "url_image": "https://m.media-amazon.com/images/I/71WPGXQLcLL._AC_UY218_.jpg", "is_prime": true, "price": 179.0, "price_upper": 179.0, "shipping_information": "送达时间为周五，9月18日，亚马逊免费配送", "pos": 3, "currency": "EUR" }, ... ] ```
键说明类型
url商品的 URL。字符串
asinAmazon 标准识别号。字符串
price商品价格。浮点数
title商品标题。字符串
rating商品评分。浮点数
currency价格所使用的货币。字符串
url_image商品图片的 URL。字符串
best_seller表示该商品是否为畅销商品。布尔值
price_upper如果适用，则为价格上限。浮点数
is_sponsored表示该商品是否为赞助内容。布尔值
manufacturer商品制造商名称。字符串
pricing_count商品定价项数量。整数
reviews_count商品评论数量。整数
coupon_discount折扣金额。整数（可选）
coupon_discount_type折扣类型： 固定金额 或 百分比.字符串（可选）
is_amazons_choice表示该商品是否为 Amazon 精选。布尔值
pos表示列表中位置的唯一标识。整数
is_prime表示该商品是否符合 Amazon Prime 资格。布尔值
shipping_information关于商品配送详情的信息字符串
sales_volume某个商品的销量或售出数量。字符串（可选）
no_price_reason如果价格为 0.0，则说明未显示价格的原因字符串（可选）
variations产品不同版本或型号的列表数组
### 变体 该 `variations` 该版块列出产品的不同版本或型号，提供指定类别中可用选项的详细概览。
```json ... "variations": [ { "asin": "B08KXB6SZH", "title": "PlayStation 5", "price": 29.99, "not_available": false }, { "asin": "B08L6FZM6D", "title": "PlayStation 4", "not_available": false, "no_price_reason": "unknown" }, { "asin": "B08N766Q9W", "title": "Xbox 数字代码", "not_available": true, "no_price_reason": "当前不可用。" } ], ... ```
键说明类型
asin亚马逊标准识别编号字符串
title变体标题字符串
price变体价格浮点数
price_strikethrough任何折扣或促销前的原价浮点数
not_available指示该变体当前是否不可用布尔值
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developers.oxylabs.io/api-targets/cn/e-commerce/amazon/search.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.