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 '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'

Query Parameters

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

Product URL

url

Required if asin not provided

Product listing's URL on Amazon. Remove unnecessary query parameters and encode the URL. If not provided, asin and country_code must be specified.

ASIN

asin

Required if url not provided

The Amazon Standard Identification Number (ASIN) for the product. Required if url is not provided.

Country Code

country_code

Optional

The 2-letter country code for the Amazon marketplace. Defaults to us if not provided. See the Supported Countries section below for valid values.

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 attributes for the product:

Attributes Returned Data Type Information Represented
name string Name of product listing
brand string Brand of product listing
asin string Product's unique identifier (ASIN) on Amazon
listing_id string Same as ASIN, the product's unique identifier
price float Current price of product (null in example)
price_reduced float Original price if product is on sale (null in example)
currency string Currency code of the price (null in example)
currency_symbol string Currency symbol of the price (null in example)
rating float Average rating of product
total_ratings int Total number of ratings received
past_month_sales string Estimated sales in the past month
is_prime boolean Whether the product is Prime eligible
shipping_info string Shipping information (null in example)
max_quantity int Max quantity purchasable for any user
variant object Variant information for the specific product listing
categories list List of categories the product belongs to, each with name and URL
images list List of product listing's image URLs
overview list List of product's key features from the overview section
features list List of product's features
details_table list List of product's specifications from the details table (empty in example)
technical_details list List of product's technical details (empty in example)
bestseller_ranks list List of product's bestseller ranks in each category (empty in example)
seller_name string Name of the seller on Amazon
seller_url string URL of the seller's profile on Amazon
variations object Variations available for the product, grouped by type (service, color, size)
review_summary string Summary of the product reviews
review_aspects list List of key aspects mentioned in the reviews, each with aspect name and sentiment score
top_reviews list List of the most helpful reviews for the product, each with reviewer details and review content

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",
        "url": "https://www.amazon.com/Apple-iPhone-13-128GB-Blue/dp/B09LNX6KQS/",
        "asin": "B09LNX6KQS",
        "listing_id": "B09LNX6KQS",
        "price": 373.97,
        "price_reduced": 397.93,
        "price_per_unit": null,
        "currency": "USD",
        "currency_symbol": "$",
        "rating": 4.1,
        "total_ratings": 12075,
        "past_month_sales": "1K+ bought in past month",
        "is_prime": false,
        "shipping_info": [
            "FREE delivery September 27 - 30",
            "Or fastest delivery September 25 - 28"
        ],
        "max_quantity": 5,
        "variant": {
            "service": {
                "name": "Unlocked",
                "asin": "B09LNX6KQS",
                "in_stock": false,
                "url": "https://www.amazon.com/dp/B09LNX6KQS"
            },
            "color": {
                "name": "Blue",
                "asin": "B09LNX6KQS",
                "in_stock": false,
                "url": "https://www.amazon.com/dp/B09LNX6KQS"
            },
            "size": {
                "name": "128GB",
                "asin": "B09LNX6KQS",
                "in_stock": false,
                "url": "https://www.amazon.com/dp/B09LNX6KQS"
            }
        },
        "categories": [
            {
                "name": "Cell Phones & Accessories",
                "url": "https://www.amazon.com/cell-phones-service-plans-accessories/b/ref=dp_bc_aui_C_1/132-1413933-2889733"
            },
            {
                "name": "Cell Phones",
                "url": "https://www.amazon.com/cell-phone-devices/b/ref=dp_bc_aui_C_2/132-1413933-2889733"
            }
        ],
        "images": [
            "https://m.media-amazon.com/images/I/41t6RkpqD1L._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/31xaSGtJQGL._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/41-8YvVCeyL._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/41Mse24iuNL._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/41t6RkpqD1L._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/41t6RkpqD1L._AC_SR38,50_.jpg",
            "https://m.media-amazon.com/images/I/31xaSGtJQGL._AC_SR38,50_.jpg",
            "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/transparent-pixel._V192234675_.gif",
            "https://m.media-amazon.com/images/I/51ysOQMyoGL.__AC_SX300_SY300_QL70_FMwebp_.jpg"
        ],
        "overview": [
            {
                "name": "Brand",
                "value": "Apple"
            },
            {
                "name": "OperatingSystem",
                "value": "iOS16"
            },
            {
                "name": "RamMemoryInstalledSize",
                "value": "6GB"
            },
            {
                "name": "CPUSpeed",
                "value": "5Nanometer"
            },
            {
                "name": "MemoryStorageCapacity",
                "value": "128GB"
            },
            {
                "name": "ScreenSize",
                "value": "6.1Inches"
            },
            {
                "name": "Resolution",
                "value": "1920x1080"
            },
            {
                "name": "RefreshRate",
                "value": "60Hz"
            },
            {
                "name": "ModelName",
                "value": "iPhone13"
            },
            {
                "name": "WirelessCarrier",
                "value": "UnlockedforAllCarriers"
            }
        ],
        "features": [
            "6.1\" Super Retina XDR display. 5G Superfast downloads, high?quality streaming",
            "Cinematic mode in 1080p at 30 fps. Dolby Vision HDR video recording up to 4K at 60 fps. 2X Optical zoom range",
            "A15 Bionic chip. New 6-core CPU with 2 performance and 4 efficiency cores. New 4-core GPU. New 16-core Neural Engine",
            "Up to 19 hours video playback. Face ID. Ceramic Shield front. Aerospace-grade aluminum"
        ],
        "details_table": [
            {
                "name": "Product Dimensions",
                "value": "7 x 4 x 5 inches"
            },
            {
                "name": "Item Weight",
                "value": "6.1 ounces"
            },
            {
                "name": "ASIN",
                "value": "B09LNX6KQS"
            },
            {
                "name": "Item model number",
                "value": "iPhone 13"
            },
            {
                "name": "Batteries",
                "value": "1 Lithium Ion batteries required. (included)"
            },
            {
                "name": "Customer Reviews",
                "value": "4.1  4.1 out of 5 stars    \n    12,075 ratings   \n\n\n 4.1 out of 5 stars"
            },
            {
                "name": "Best Sellers Rank",
                "value": "#3 in Amazon Renewed (See Top 100 in Amazon Renewed)  #3 in Renewed Smartphones"
            },
            {
                "name": "OS",
                "value": "iOS 16"
            },
            {
                "name": "RAM",
                "value": "4 GB"
            },
            {
                "name": "Connectivity technologies",
                "value": "Wi-Fi"
            },
            {
                "name": "GPS",
                "value": "True"
            },
            {
                "name": "Special features",
                "value": "Built-In GPS"
            },
            {
                "name": "Other display features",
                "value": "Wireless"
            },
            {
                "name": "Human Interface Input",
                "value": "Touchscreen"
            },
            {
                "name": "Scanner Resolution",
                "value": "1920 x 1080"
            },
            {
                "name": "Other camera features",
                "value": "Front, Rear"
            },
            {
                "name": "Form Factor",
                "value": "Slate"
            },
            {
                "name": "Color",
                "value": "Blue"
            },
            {
                "name": "Battery Power Rating",
                "value": "3600 Amp Hours"
            },
            {
                "name": "Phone Talk Time",
                "value": "18 Hours"
            },
            {
                "name": "Whats in the box",
                "value": "iPhone, Lightning to USB Cable"
            },
            {
                "name": "Manufacturer",
                "value": "Apple Computer"
            },
            {
                "name": "Date First Available",
                "value": "November 11, 2021"
            },
            {
                "name": "Memory Storage Capacity",
                "value": "128 GB"
            },
            {
                "name": "Standing screen display size",
                "value": "6.1 Inches"
            },
            {
                "name": "Ram Memory Installed Size",
                "value": "6 GB"
            },
            {
                "name": "Weight",
                "value": "0.38 Pounds"
            }
        ],
        "technical_details": [],
        "bestseller_ranks": [
            {
                "name": "#1 Best SellerinCell Phone Basic Cases",
                "url": "https://www.amazon.com/gp/bestsellers/wireless/3081461011/ref=zg_b_bs_3081461011_1/ref=pd_sim_cpf_related_desktop_d_sccl_2_4_bsb/132-1413933-2889733?pd_rd_w=y7S1V&content-id=amzn1.sym.3e3b5bf8-1052-4a4b-9a30-044634f1680f&pf_rd_p=3e3b5bf8-1052-4a4b-9a30-044634f1680f&pf_rd_r=J0D3H0ZPQKC0XT6STXR0&pd_rd_wg=LJ0zs&pd_rd_r=8762b809-ac5b-43d0-8441-6586ed432135&pd_rd_i=B099JVC9HL",
                "rank": 1
            },
            {
                "name": "See Top 100 in Amazon Renewed",
                "url": "https://www.amazon.com/gp/bestsellers/amazon-renewed/ref=pd_zg_ts_amazon-renewed",
                "rank": 3
            },
            {
                "name": "Renewed Smartphones",
                "url": "https://www.amazon.com/gp/bestsellers/amazon-renewed/17871142011/ref=pd_zg_hrsr_amazon-renewed",
                "rank": 3
            }
        ],
        "seller_name": "Techrific Deals",
        "seller_url": "https://www.amazon.com/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=AXDQETSB4MUQT&asin=B09LNX6KQS&ref_=dp_merchant_link&isAmazonFulfilled=1",
        "variations": {
            "service": [
                {
                    "name": "AT&T",
                    "in_stock": true,
                    "asin": "B09LNV4K66",
                    "url": "https://www.amazon.com/dp/B09LNV4K66",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "GSM Carriers",
                    "in_stock": true,
                    "asin": "B09LNT7B9D",
                    "url": "https://www.amazon.com/dp/B09LNT7B9D",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "T-Mobile",
                    "in_stock": true,
                    "asin": "B09LNT35SH",
                    "url": "https://www.amazon.com/dp/B09LNT35SH",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Unlocked",
                    "in_stock": false,
                    "asin": "B09LNX6KQS",
                    "url": "https://www.amazon.com/dp/B09LNX6KQS",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Verizon",
                    "in_stock": true,
                    "asin": "B09LNCFWVV",
                    "url": "https://www.amazon.com/dp/B09LNCFWVV",
                    "price": null,
                    "price_per_unit": null
                }
            ],
            "color": [
                {
                    "name": "Blue",
                    "in_stock": false,
                    "asin": "B09LNX6KQS",
                    "url": "https://www.amazon.com/dp/B09LNX6KQS",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Green",
                    "in_stock": true,
                    "asin": "B0B5FDB92L",
                    "url": "https://www.amazon.com/dp/B0B5FDB92L",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Midnight",
                    "in_stock": true,
                    "asin": "B09LNW3CY2",
                    "url": "https://www.amazon.com/dp/B09LNW3CY2",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Pink",
                    "in_stock": true,
                    "asin": "B09LNP1ZHT",
                    "url": "https://www.amazon.com/dp/B09LNP1ZHT",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Red",
                    "in_stock": true,
                    "asin": "B09LNT1F3H",
                    "url": "https://www.amazon.com/dp/B09LNT1F3H",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "Starlight",
                    "in_stock": true,
                    "asin": "B09LNKXBRJ",
                    "url": "https://www.amazon.com/dp/B09LNKXBRJ",
                    "price": null,
                    "price_per_unit": null
                }
            ],
            "size": [
                {
                    "name": "128GB",
                    "in_stock": false,
                    "asin": "B09LNX6KQS",
                    "url": "https://www.amazon.com/dp/B09LNX6KQS",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "256GB",
                    "in_stock": true,
                    "asin": "B09LNFRHGN",
                    "url": "https://www.amazon.com/dp/B09LNFRHGN",
                    "price": null,
                    "price_per_unit": null
                },
                {
                    "name": "512GB",
                    "in_stock": true,
                    "asin": "B09LNLLGZ8",
                    "url": "https://www.amazon.com/dp/B09LNLLGZ8",
                    "price": null,
                    "price_per_unit": null
                }
            ]
        },
        "reviews_summary": "Customers like the quality and value of the cell phone. They mention it's in superb condition, the casings are nearly flawless, and it'll be a good phone for the price. Some are also happy with the ease of setup. However, some dislike that the phone cracks. Customers disagree on the functionality, scratch resistance, battery life, and charger.",
        "review_aspects": [
            {
                "name": "Phone quality",
                "sentiment": "positive"
            },
            {
                "name": "Value for money",
                "sentiment": "positive"
            },
            {
                "name": "Ease of setup",
                "sentiment": "positive"
            },
            {
                "name": "Functionality",
                "sentiment": "mixed"
            },
            {
                "name": "Scratch resistance",
                "sentiment": "mixed"
            },
            {
                "name": "Battery life",
                "sentiment": "mixed"
            },
            {
                "name": "Charger",
                "sentiment": "mixed"
            },
            {
                "name": "Phone cracks",
                "sentiment": "negative"
            }
        ],
        "top_reviews": [
            {
                "reviewer_name": "Tommy Nguyen",
                "review_title": "\n9.5/10 overall",
                "rating": 5,
                "review_text": "iPhone 13, midnight, 256gb, unlocked version, seller = DirectCertified.  I ordered 2 for my kids.  Both phones were practically same condition.Cosmetic - One phone had a very tiny stress fracture on the screen that measured approx 1\" across.  It was only noticeable at direct light and 6\" away.  After laying a screen protector, it is not noticeable.  Both iphones had 1-2 tiny knicks on the screen.  Again, both are only noticeable up front and after laying a screen protector, it is barely noticeable.  The casings on both were near flawless.  I can tell the previous owners used screen protectors and cases with longevity in mind.  I grade both phones a 95% on appearance and like new cosmetically.Battery - One phone had 85% and other had 86%.  A bit on the lower end but its all a gamble going the refurbished route.  Not bad enough for me to deal with doing an exchange and take a chance I may get a worse condition phone.  I suspect its the original batteries in these 2 units.Function - speaker is loud, face ID works, touchscreen is good, sidebar buttons all work, rear and front cameras are clear, everything works as it should.  Doesn't seem to have aftermarket parts used on these phones as there is no pop up notification indicating so.  I suspect everything on these 2 phones were original.I will update this review after few weeks of use.  I am more curious on battery life so we'll see...8/18/2024 update:  kiddos reported the phone battery holds its charge fine. 1 full charge lasts them the whole day. They're using a fast charger purchased off Amazon and so far so good!\nRead more",
                "date": "2024-06-22",
                "verified_perchase": true,
                "review_imgs": []
            },
            {
                "reviewer_name": "Jeremy Young",
                "review_title": "\nSo far, happy with the refurb purchase!",
                "rating": 5,
                "review_text": "Just set up this renewed iphone 13, and so far so good! When activated, it showed 100% battery capacity. Physical condition seems perfect - no chips, scratches, dents... I bought my last iPhone through Amazon renewed and had a good experience, so I wanted to check them out again. I would suggest consumers to explore this option!! And if a phone is not to your expectations, you can return. But it's a more affordable and sustainable way to upgrade your electronics!\nRead more",
                "date": "2024-08-19",
                "verified_perchase": true,
                "review_imgs": []
            },
            {
                "reviewer_name": "Yossif ibrahem shahata",
                "review_title": "\nVery good, almost perfect if not for the battery health.",
                "rating": 4,
                "review_text": "The phone is in a very good condition:No damages, the screen is clean and fine.The battery is 84% which is not good.The phone performs and functions normally, the phone looks good but their is some scratches around the frame of the camera (not on the lens of the camera) doesn't affect the camera. Overall a good deal.\nRead more",
                "date": "2024-08-21",
                "verified_perchase": true,
                "review_imgs": []
            },
            {
                "reviewer_name": "Michele Dawson",
                "review_title": "\nHigh quality",
                "rating": 5,
                "review_text": "Bought this iPhone 13 to replace a SE. I was a bit skeptical but I have been surprised at the quality of this phone. Battery charge is great and the functionality of the phone is like new. The cosmetics of the phone is good. Signal strength is great. I wish it came with more directions as I was thinking I needed to have a SIM card, but I did not. The transition from the SE to 13 is smooth- basically the phone walks you through the set up of the new phone & resetting of the old phone- it’s pretty slick actually.\nRead more",
                "date": "2024-09-16",
                "verified_perchase": true,
                "review_imgs": []
            },
            {
                "reviewer_name": "Najara",
                "review_title": "\nPleasantly surprised",
                "rating": 5,
                "review_text": "So let me start out by saying that I am not one to purchased refurbished phones and whenever something would happen to one of mine and I had to turn it into the Phone company and they would send me a refurbished one to replace mine, there was always something wrong with them. So, that has always made me a little bit gunshy regarding that particular situation.With that said, as a full-time caregiver for the last 11 years, I have not been able to work and unfortunately can no longer purchase the best of the best with the flagship phones that I used to get back in the day. Many of my parents doctors do some video visits and some of them actually prefer FaceTime so as a result, having an iPhone was actually partly a necessity for that reason.I have always been an Android girl, )still have that too), so I didn’t quite know what iPhone I needed to get, but after some research, I finally settled on what I thought would be the best choice for me both with regard to the technology inside and with the price as well as the warranty.I had actually considered either an iPhone 11 or an iPhone 13 as my choice. As we are now on the 15 I found the 13 to be the wisest choice of the two.After researching many different sites, some very reputable and actually recommended by people, I decided to land on Amazon‘s renewed program because I’ve always had a nice experience when there have been any issues with a product and I’ve never had any problems with customer service. They’ve always been very helpful and I thought if anything were to happen with the phone, I would be hoping to have the same type of experience.In looking at the options, I chose to actually pay more to have one that was put forth by Amazon themselves because they offered a year warranty as opposed to many of the others who were a bit cheaper and offered maybe 30 days or so etc.And hey, so far, so good! The Phone arrived. It was in perfect cosmetic condition and I have not had any issues with it since. The battery was at 87% and although I would’ve liked to had it higher than that, I was glad to see that it still was pretty snappy when I needed it to be.So I would say that I have been very pleased so far and I would absolutely recommend the renewed program to anyone interested, but can only speak to the actual product provided by Amazon itself, however, I’m sure many of the third-party individuals that sell refurbished items may have some really good product themselves.Ah…there I go again…refurbished…renewed…to-may-toe…to-mah-toe… well you get the jist…\nRead more",
                "date": "2024-08-23",
                "verified_perchase": true,
                "review_imgs": []
            }
        ]
    },
    "remaining_credits": 856912
}

Request Cost

Each request to this endpoint costs 1 credits.

Supported Countries

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

Country Domain Code
USA Amazon.com us
Canada Amazon.ca ca
UK Amazon.co.uk gb
France Amazon.fr fr
Germany Amazon.de de
Spain Amazon.es es
Japan Amazon.co.jp jp
Australia Amazon.au au
India Amazon.in in
Brazil Amazon.br br

If you don't see the country you need data from, please contact us at support@unwrangle.com.

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