> 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.md).

# Amazon

使用网页爬虫API 轻松收集 Amazon 数据。通过现成示例和灵活参数获取产品、价格和卖家详情。

使用网页爬虫API，你可以抓取和解析各种类型的 **Amazon** 页面；以下是所有支持的抓取器及其各自对应的 `来源` 值。

| 来源                   | 描述                                                                             | 专用解析器                                                                                             |
| -------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| `amazon_product`     | [**商品页面**](/api-targets/cn/e-commerce/amazon/product.md) ，对应你选择的 ASIN。         | 是。                                                                                                |
| `amazon_search`      | [**搜索结果**](/api-targets/cn/e-commerce/amazon/search.md) ，对应你选择的搜索词。            | 是。                                                                                                |
| `amazon_pricing`     | [**报价列表**](/api-targets/cn/e-commerce/amazon/pricing.md) ，可用于你选择的 ASIN。        | 是。                                                                                                |
| `amazon_sellers`     | [**卖家信息**](/api-targets/cn/e-commerce/amazon/sellers.md) ，对应你选择的卖家。            | 是。                                                                                                |
| `amazon_bestsellers` | 列表 [**畅销商品**](/api-targets/cn/e-commerce/amazon/best-sellers.md) ，位于你选择的分类节点中。 | 是                                                                                                 |
| `amazon`             | 提交任意 [**Amazon 网址**](/api-targets/cn/e-commerce/amazon/url.md) 即可。             | 仅限特定 [**Amazon 页面类型的 URL**](/products/cn/web-scraper-api/features/localization/domain-locale.md). |

## 入门

**创建你的 API 用户凭证**：注册免费试用或在 [**Oxylabs 控制面板**](https://dashboard.oxylabs.io/en/registration) 以创建你的 API 用户凭证（`USERNAME` 和 `PASSWORD`).

{% hint style="warning" %}
如果你的账户需要多个 API 用户，请联系我们的 [**客户支持**](mailto:support@oxylabs.io) 或通过我们 24/7 在线聊天支持联系我们。
{% endhint %}

### 请求示例

{% tabs %}
{% tab title="cURL" %}

```bash
curl 'https://realtime.oxylabs.io/v1/queries' \\
--user "USERNAME:PASSWORD" \\
-H "Content-Type: application/json" \\
-d '{
        "source": "amazon_product",
        "query": "B00MNV8E0C",
        "geo_location": "90210",
        "parse": true
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'amazon_product',
    'query': 'B00MNV8E0C',
    'geo_location': '90210',
    'parse': True
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "amazon_product",
    query: "B00MNV8E0C",
    geo_location: "90210",
    parse: true,
};

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="PHP" %}

```php
<?php

$params = array(
    'source' => 'amazon_product',
    'query' => 'B00MNV8E0C',
    'geo_location' => '90210',
    'parse' => true,
);

$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="C#" %}

```csharp
using System;
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_product",
                query = "B00MNV8E0C",
                geo_location = "90210",
                parse = true
            };

            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.Encoding.ASCII.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="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_product",
		"query":        "B00MNV8E0C",
		"geo_location": "90210",
		"parse":        true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	request.Header.Set("Content-Type", "application/json")
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}
```

{% endtab %}

{% tab title="HTTP" %}

```http
https://realtime.oxylabs.io/v1/queries?source=amazon_product&query=B00MNV8E0C&geo_location=90210&parse=true&access_token=12345abcde
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
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_product");
        jsonObject.put("query", "B00MNV8E0C");
        jsonObject.put("geo_location", "90210");
        jsonObject.put("parse", true);

        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_product",
    "query": "B00MNV8E0C",
    "geo_location": "90210",
    "parse": true
}
```

{% endtab %}
{% endtabs %}

<details>

<summary>输出示例</summary>

```json
{
    "results": [
        {
            "content": {
                "ads": [
                    {
                        "asin": "B00LH3DMUO",
                        "images": [
                            "https://images-na.ssl-images-amazon.com/images/I/81Apg8B6+0L._AC_UL165_SR165,165_.jpg",
                            "https://m.media-amazon.com/images/I/01GK70BG4uL.svg",
                            "https://m.media-amazon.com/images/I/019h+CPo68L.svg",
                            "https://m.media-amazon.com/images/I/51-5llWa4LL._SS180_.png",
                            "https://m.media-amazon.com/images/I/51-5llWa4LL._SS180_.png",
                            "https://m.media-amazon.com/images/I/51-5llWa4LL._SS180_.png",
                            "https://m.media-amazon.com/images/I/51-5llWa4LL._SS180_.png",
                            "https://m.media-amazon.com/images/I/21AGu0JFvKL.svg"
                        ],
                        "is_prime_eligible": false,
                        "location": "carousel",
                        "pos": 1,
                        "price": 13.7,
                        "price_upper": 13.7,
                        "rating": 0,
                        "reviews_count": 47,
                        "title": "Amazon Basics AAA Long-Lasting Alkaline Batteries, 36-Count, 1.5 Volt, Reliable Performance, 10-Year Shelf Life, Emergency Storage",
                        "type": "organic_also_viewed"
                    },
                    ...
                ],
                "amazon_choice": true,
                "answered_questions_count": 0,
                "asin": "B00MNV8E0C",
                "asin_in_url": "B00MNV8E0C",
                "brand": "Amazon Basics",
                "bullet_points": "IN THE BOX: 48-pack of 1.5 volt AA alkaline batteries for reliable performance across a wide range of devices\nDEVICE COMPATIBLE: Ideal battery for game controllers, toys, flashlights, digital cameras, clocks, and more\nDESIGNED TO LAST: 10-year leak-free shelf life; store for emergencies or use ri...",
                "buy_it_with": [
                    {
                        "asin": "B00LH3DMUO",
                        "price": 13.7,
                        "title": "Amazon Basics AAA Long-Lasting Alkaline Batteries, 36-Count, 1.5 Volt, Reliable Performance, 10-Year Shelf Life, Emergency Storage"
                    },
                    ...
                ],
                "buybox": [
                    {
                        "condition": " One-time purchase ",
                        "delivery_details": [
                            {
                                "date": {
                                    "by": "Tuesday, September 22"
                                },
                                "type": "FREE delivery"
                            },
                            {
                                "date": {
                                    "by": "Tuesday, September 22"
                                },
                                "type": "FREE delivery"
                            },
                            {
                                "date": {
                                    "by": "Today, 2 PM - 6 PM"
                                },
                                "type": "Prime members"
                            }
                        ],
                        "offer_listing_id": "%2BG7L8AqCBfyuqVpnXPAEaqxnc1DeC3pmbGiw8XlXTWigOKPT8Qosdx3Am%2FzCIIovR9r3TI9dx7C7MQw3lMrfwaInbhXJjjZB%2BlQCORSr6f0QjTqJiE%2BMksCqHGt23I8S6LnMgl4%2BJd7V812eWl8uNw%3D%3D",
                        "price": 15.29,
                        "returns": "FREE 30-day refund/replacement",
                        "seller_id": "ATVPDKIKX0DER",
                        "seller_name": "Amazon.com",
                        "stock": "In Stock"
                    },
                    ...
                ],
                "category": [
                    {
                        "ladder": [
                            {
                                "name": "Health & Household",
                                "url": "/health-personal-care-nutrition-fitness/b/ref=dp_bc_1?ie=UTF8&node=3760901"
                            },
                            {
                                "name": "Household Supplies",
                                "url": "/Household-Supplies-Products/b/ref=dp_bc_2?ie=UTF8&node=15342811"
                            },
                            {
                                "name": "Household Batteries",
                                "url": "/Household-Batteries/b/ref=dp_bc_3?ie=UTF8&node=15745581"
                            },
                            {
                                "name": "AA",
                                "url": "/AA-Batteries/b/ref=dp_bc_4?ie=UTF8&node=389577011"
                            }
                        ]
                    }
                ],
                "coupon": "Save 15%:  Coupon available when you select",
                "coupon_discount_percentage": 15,
                "coupon_type": "percentage",
                "currency": "USD",
                "delivery": [
                    {
                        "date": {
                            "by": "Tuesday, September 22"
                        },
                        "type": "FREE delivery"
                    },
                    ...
                ],
                "description": "Product Description Amazon Basics 48 Pack AA High-Performance Alkaline Batteries, 10-Year Shelf Life, Easy to Open Battery Value Pack From the Manufacturer Amazon Basics",
                "description_images": [
                    "https://m.media-amazon.com/images/S/aplus-media/sota/bf9530e7-742c-4e03-b705-f0138c82cf9b.__CR0,0,1464,600_PT0_SX1464_V1___.jpg",
                    ...
                ],
                "developer_info": {},
                "discount_percentage": 5,
                "featured_merchant": {
                    "is_amazon_fulfilled": true,
                    "link": "",
                    "name": "Amazon.com",
                    "seller_id": "",
                    "shipped_from": "Amazon.com"
                },
                "frequently_bought_together": [
                    {
                        "asin": "B00MNV8E0C"
                    },
                    ...
                ],
                "has_videos": false,
                "images": [
                    "https://m.media-amazon.com/images/I/81iJ+tnLADL._AC_SL1500_.jpg",
                    ...
                ],
                "important_information": [
                    {
                        "description": "Statements regarding dietary supplements have not been evaluated by the FDA and are not intended to diagnose, treat, cure, or prevent any disease or health condition.",
                        "title": "Legal Disclaimer"
                    }
                ],
                "is_prime_eligible": true,
                "manufacturer": "AmazonBasics",
                "max_quantity": 30,
                "page": 1,
                "page_type": "Product",
                "parent_asin": "B0CQMQ6XDB",
                "parse_status_code": 12000,
                "price": 15.29,
                "price_buybox": 15.29,
                "price_initial": 0,
                "price_per_unit": {
                    "currency": "USD",
                    "price": 0.32,
                    "unit": "count"
                },
                "price_shipping": 0,
                "price_sns": 14.53,
                "price_strikethrough": 15.29,
                "price_upper": 15.29,
                "pricing_count": 1,
                "pricing_str": "",
                "pricing_url": "https://www.amazon.com/gp/offer-listing/B00MNV8E0C?startIndex=0",
                "prime_savings": "4个精选商品可节省10%",
                "product_details": {
                    "asin": "B00MNV8E0C",
                    "best_sellers_rank": "AA 电池类第 1 名",
                    "date_first_available": "2020年8月1日",
                    "item_model_number": "ALK AA48FFP-U AMZ",
                    "manufacturer": "Amazon",
                    "product_dimensions": "5.98 x 2.29 x 0.98 英寸；0.82 盎司"
                },
                "product_dimensions": "5.98 x 2.29 x 0.98 英寸；0.82 盎司",
                "product_name": "Amazon Basics 48件装 AA 碱性高性能电池，1.5伏，10年保质期，持久耐用，不漏液",
                "rating": 4.7,
                "rating_stars_distribution": [
                    {
                        "percentage": 82,
                        "rating": 5
                    },
                    ...
                ],
                "reviews": [
                    {
                        "author": "RT",
                        "content": "6星。我从来——从来——没有遇到过 Amazon Basics 电池的问题。而且它们没有次品，电量保持时间很长，这让我可以放心购买48件装，确信它们能一直好用到最后一节电池。我把它们放在车库冰箱里的可重复密封袋中，和所有...",
                        "helpful_count": 38,
                        "id": "R1PGPSQ2HEXA0A",
                        "images": [
                            "https://m.media-amazon.com/images/I/81VoYH-xMmL.jpg"
                        ],
                        "is_verified": true,
                        "product_attributes": "Size: 48件装（1包）",
                        "rating": 5,
                        "timestamp": "2026年3月11日在美国评论",
                        "title": "没有次品。品质扎实。首选品牌。"
                    },
                    ...
                ],
                "reviews_count": 953875,
                "sales_rank": [
                    {
                        "ladder": [
                            {
                                "name": "Health & Household",
                                "url": "/gp/bestsellers/hpc/ref=pd_zg_ts_hpc"
                            }
                        ],
                        "rank": 1
                    },
                    ...
                ],
                "sales_volume": "已购买10万+",
                "sns_discounts": [],
                "stock": "有货",
                "store_url": "/stores/AmazonBasics/page/947C6949-CF8E-4BD3-914A-B411DD3E4433?lp_asin=B00MNV8E0C&ref_=ast_bln&store_ref=bl_ast_dp_brandlogo_sto",
                "title": "Amazon Basics 48件装 AA 碱性高性能电池，1.5伏，10年保质期，持久耐用，不漏液",
                "url": "https://www.amazon.com/dp/B00MNV8E0C?lv=shuf&language=en_US&channelId=520&plpRedirect=mhFallback",
                "variation": [
                    {
                        "asin": "B07KWYGTC6",
                        "dimensions": {
                            "Size": "12件装（AA/LR6）"
                        },
                        "selected": false
                    },
                    ...
                ]
            },
            "created_at": "2026-09-17 13:27:10",
            "updated_at": "2026-09-17 13:27:14",
            "page": 1,
            "url": "https://www.amazon.com/dp/B00MNV8E0C?lv=shuf&language=en_US&channelId=520&plpRedirect=mhFallback",
            "job_id": "7506342992362373121",
            "is_render_forced": false,
            "status_code": 200,
            "parser_type": "",
            "parser_preset": null
        }
    ]
}
```

</details>

我们在示例中使用同步 [**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) 部分。

可选地，你可以添加以下附加参数，例如 `geo_location`, `user_agent_type`, `parse`, `render` 等，以自定义你的抓取请求。了解更多：

{% content-ref url="/spaces/ZwEHB9k4MH4pDy80n9mF/pages/1c0708575f299a0b7d4cba7684877a9277872b1e" %}
[功能](/products/cn/web-scraper-api/features.md)
{% endcontent-ref %}


---

# 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.md?ask=<question>&goal=<endgoal>
```

`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.