> 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/e-commerce/amazon.md).

# Amazon

Gather Amazon data effortlessly with Web Scraper API. Collect product, pricing, and seller details using ready-made examples and flexible parameters.

With Web Scraper API, you can scrape and parse various types of **Amazon** pages; below is an overview of all supported scrapers and their respective `source` values.

| Source               | Description                                                                                                        | Dedicated parser                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| `amazon_product`     | [**Product page**](/api-targets/e-commerce/amazon/product.md) of an ASIN of your choice.                           | Yes.                                                                                                                   |
| `amazon_search`      | [**Search results**](/api-targets/e-commerce/amazon/search.md) for a search term of your choice.                   | Yes.                                                                                                                   |
| `amazon_pricing`     | [**List of offers**](/api-targets/e-commerce/amazon/pricing.md) available for an ASIN of your choice.              | Yes.                                                                                                                   |
| `amazon_sellers`     | [**Seller information**](/api-targets/e-commerce/amazon/sellers.md) of a seller of your choice.                    | Yes.                                                                                                                   |
| `amazon_bestsellers` | List of [**best seller items**](/api-targets/e-commerce/amazon/best-sellers.md) in a taxonomy node of your choice. | Yes                                                                                                                    |
| `amazon`             | Submit any [**Amazon URL**](/api-targets/e-commerce/amazon/url.md) you like.                                       | Limited to URLs of specific [**Amazon page types**](/products/web-scraper-api/features/localization/domain-locale.md). |

## Getting started

**Create your API user credentials**: Sign up for a free trial or purchase the product in the [**Oxylabs dashboard**](https://dashboard.oxylabs.io/en/registration) to create your API user credentials (`USERNAME` and `PASSWORD`).

{% hint style="warning" %}
If you need more than one API user for your account, please contact our [**customer support**](mailto:support@oxylabs.io) or message our 24/7 live chat support.
{% endhint %}

### Request sample

{% 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>Output example</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": "Save 10% on 4 select item(s)",
                "product_details": {
                    "asin": "B00MNV8E0C",
                    "best_sellers_rank": "#1 in AA Batteries",
                    "date_first_available": "August 1, 2020",
                    "item_model_number": "ALK AA48FFP-U AMZ",
                    "manufacturer": "Amazon",
                    "product_dimensions": "5.98 x 2.29 x 0.98 inches; 0.82 ounces"
                },
                "product_dimensions": "5.98 x 2.29 x 0.98 inches; 0.82 ounces",
                "product_name": "Amazon Basics 48-Pack AA Alkaline High-Performance Batteries, 1.5 Volt, 10-Year Shelf Life, Long-lasting, No Leakage",
                "rating": 4.7,
                "rating_stars_distribution": [
                    {
                        "percentage": 82,
                        "rating": 5
                    },
                    ...
                ],
                "reviews": [
                    {
                        "author": "RT",
                        "content": "6 Stars.I have never - ever - had an issue with Amazon Basics batteries. And the fact there are no duds and they hold their juice for a long time, enables me to buy a 48-pack with the confidence that they'll be good to the last battery. I keep them in a resealable bag in a garage fridge with all ...",
                        "helpful_count": 38,
                        "id": "R1PGPSQ2HEXA0A",
                        "images": [
                            "https://m.media-amazon.com/images/I/81VoYH-xMmL.jpg"
                        ],
                        "is_verified": true,
                        "product_attributes": "Size: 48 Count (Pack of 1)",
                        "rating": 5,
                        "timestamp": "Reviewed in the United States March 11, 2026",
                        "title": "No Duds. Solid Quality. Go-To Brand."
                    },
                    ...
                ],
                "reviews_count": 953875,
                "sales_rank": [
                    {
                        "ladder": [
                            {
                                "name": "Health & Household",
                                "url": "/gp/bestsellers/hpc/ref=pd_zg_ts_hpc"
                            }
                        ],
                        "rank": 1
                    },
                    ...
                ],
                "sales_volume": "100K+ bought",
                "sns_discounts": [],
                "stock": "In 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-Pack AA Alkaline High-Performance Batteries, 1.5 Volt, 10-Year Shelf Life, Long-lasting, No Leakage",
                "url": "https://www.amazon.com/dp/B00MNV8E0C?lv=shuf&language=en_US&channelId=520&plpRedirect=mhFallback",
                "variation": [
                    {
                        "asin": "B07KWYGTC6",
                        "dimensions": {
                            "Size": "12 Count (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>

We use synchronous [**Realtime**](/products/web-scraper-api/integration-methods/realtime.md) integration method in our examples. If you would like to use [**Proxy Endpoint**](/products/web-scraper-api/integration-methods/proxy-endpoint.md) or asynchronous [**Push-Pull**](/products/web-scraper-api/integration-methods/push-pull.md) integration, refer to the [**integration methods**](/products/web-scraper-api/integration-methods.md) section.

Optionally, you can include additional parameters such as `geo_location`, `user_agent_type`, `parse`, `render` and more to customize your scraping request. Read more:

{% content-ref url="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/r6mM4F7G5NQi9p2qufcB" %}
[Features](/products/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/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.