Skip to content

Amazon Product Data API

A GET request to our /api/getter/?platform="amazon_detail" endpoint allows you to scrape product data for any product listing URL on Amazon's marketplace in real-time.

Example

To scrape details about the latest iPhone from Amazon, you can use the following command:

1
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=amazon_detail&url=https%3A%2F%2Fwww.amazon.com%2FApple-iPhone-13-128GB-Blue%2Fdp%2FB09LNX6KQS%2F&api_key=API_KEY'

Note

When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Product URL

url

Required

Product listing's URL on Amazon. Remove unnecessary query parameters and encode the URL.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be amazon_detail.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.

Results

The response will include the following attirbutes for the product:

Attributes Returned Data Type Information Represented
name string Name of product lisitng
brand string Brand of product listing
categories string List of categories the product belongs to
images string Product listing's images
price string Price of product
price_reduced string Reduced price of product
max_quantity int Max quantity purchasable for any user
rating float Average rating of product
total_ratings int No. of ratings received
asin string Product's retailer ID on Amazon
overview list Product's overview as listing on Amazon
details_table list Product's specifications table as a list
bestseller_ranks list Product's bestseller rank in each category on Amazon
seller_name string Seller's name on Amazon
seller_url string Seller's profile URL on Amazon

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "url": "https://www.amazon.com/Apple-iPhone-13-128GB-Blue/dp/B09LNX6KQS/",
    "result_count": 1,
    "detail": {
        "name": "Apple iPhone 13, 128GB, Blue - Unlocked (Renewed)",
        "brand": "Amazon Renewed",
        "categories": [
            {
                "name": "Cell Phones & Accessories",
                "url": "https://www.amazon.com/cell-phones-service-plans-accessories/b/ref=dp_bc_aui_C_1/142-5323634-6780802"
            },
            {
                "name": "Cell Phones",
                "url": "https://www.amazon.com/cell-phone-devices/b/ref=dp_bc_aui_C_2/142-5323634-6780802"
            }
        ],
        "images": [
            "https://images-na.ssl-images-amazon.com/images/I/71H8ipbuxoL.__AC_SX300_SY300_QL70_ML2_.jpg"
        ],
        "price": "$784.97",
        "price_reduced": null,
        "max_quantity": 14,
        "rating": 4.4,
        "total_ratings": 25,
        "asin": "B09LNX6KQS",
        "overview": [
            {
                "name": "ModelName",
                "value": "13"
            },
            {
                "name": "WirelessCarrier",
                "value": "UnlockedforAllCarriers"
            },
            {
                "name": "Brand",
                "value": "Apple"
            },
            {
                "name": "MemoryStorageCapacity",
                "value": "128GB"
            },
            {
                "name": "Color",
                "value": "Blue"
            },
            {
                "name": "CellularTechnology",
                "value": "5G"
            },
            {
                "name": "ScreenSize",
                "value": "6.1Inches"
            },
            {
                "name": "Manufacturer",
                "value": "AppleComputer"
            },
            {
                "name": "Othercamerafeatures",
                "value": "Front"
            },
            {
                "name": "ShootingModes",
                "value": "HighDynamicRange"
            }
        ],
        "details_table": [
            {
                "name": "Package Dimensions",
                "value": "6.1 x 3 x 0.3 inches"
            },
            {
                "name": "Item Weight",
                "value": "6.4 ounces"
            },
            {
                "name": "ASIN",
                "value": "B09LNX6KQS"
            },
            {
                "name": "Item model number",
                "value": "13"
            },
            {
                "name": "Customer Reviews",
                "value": ""
            },
            {
                "name": "Best Sellers Rank",
                "value": ""
            },
            {
                "name": "Other display features",
                "value": "Wireless"
            },
            {
                "name": "Other camera features",
                "value": "Front"
            },
            {
                "name": "Colour",
                "value": "Blue"
            },
            {
                "name": "Manufacturer",
                "value": "Apple Computer"
            },
            {
                "name": "Date First Available",
                "value": "November 11, 2021"
            }
        ],
        "bestseller_ranks": [
            {
                "name": "See Top 100 in Electronics",
                "url": "https://www.amazon.com/gp/bestsellers/electronics/ref=pd_zg_ts_electronics",
                "rank": 4832
            },
            {
                "name": "Cell Phones",
                "url": "https://www.amazon.com/gp/bestsellers/electronics/7072561011/ref=pd_zg_hrsr_electronics",
                "rank": 187
            }
        ],
        "seller_name": "Networkstore",
        "seller_url": "https://www.amazon.com/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=AR1FTLUUZC24W"
    }
}

Request Cost

Each request to this endpoint costs 10 credits. Requests for Amazon.fr, Amazon.de and other regional platforms may cost 50 credits.

Supported Countries

The countries we support to scrape Amazon's search results from are listed below:

Country Domain Code
USA Amazon.com us
UK Amazon.co.uk gb
France Amazon.fr fr
Germany Amazon.de de
India Amazon.in in
Australia Amazon.au au

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com