Amazon Scraper API
Amazon pages are dense, dynamic, and defended by anti-bot systems.
This API turns a product lookup or a search query into a structured JSON record, so a data team can spend its time on analysis rather than on proxy pools and browser fleets. The page below explains what each endpoint accepts, what comes back, and how to choose between a full request and a lighter one.
What the API returns
A single call returns structured JSON covering Amazon products, reviews, pricing, and related listing data. Three endpoint families cover the common jobs:
- Product API — pull detailed product data for a given ASIN.
- Pricing API — pull offer and price data for a given ASIN.
- Search API — run a search term and collect the products that appear in Amazon's results.
Each family has its own input set. The product and pricing endpoints key on an ASIN; the search endpoint keys on a free-text query. All three accept country, language, and Amazon domain controls, and all three support a light request mode for faster, cheaper responses.
Choosing the right endpoint
Start from the question you need answered, not from the endpoint name.
| If you need… | Use | Primary input |
|---|---|---|
| Full detail for one known item | Product API | query (ASIN) |
| Offer-level prices and conditions for one known item | Pricing API | asin |
| A set of products matching a phrase | Search API | query (search term) |
| Review text and ratings | Review extraction via the Amazon API | ASIN or URL |
A practical rule: if you already hold the ASIN, the product or pricing endpoint is the direct route. If you are still discovering which products matter, run the search endpoint first and carry the returned ASINs into the product endpoint for depth.
Input controls and what they change
The request parameters are shared across the endpoint families with small differences.
- `query` — on the product endpoint this is the 10-character ASIN product code to look up; on the search endpoint it is the search term, such as a product name.
- `asin` — the 10-character ASIN product code used by the pricing endpoint.
- `country` — a two-letter country code selecting where results are scraped from.
- `language` — sets the language of the returned results.
- `domain` — selects the Amazon marketplace, for example amazon.com, amazon.co.uk, or amazon.de.
- `light_request` — a faster, cheaper request mode.
- `device` — desktop or mobile rendering for the request.
- `merchant_id` — search-only filter that restricts results to a merchant.
Country and domain are related but not identical: country sets the result location, while domain picks the marketplace host. Set both deliberately when you need a specific storefront view.
A worked product record
The captured product response for ASIN B0DPDRNSXV shows how much a single record carries. The item is an Apple iPhone 16 (renewed premium) listed at 675 USD with an 11% discount, a 4.6 rating from 114 ratings, and a stock note of nine units remaining. The record also includes:
- A category ladder (Cell Phones & Accessories → Cell Phones).
- Three sales-rank entries with their own ladders and ranks.
- A featured merchant block with seller ID and fulfilment flag.
- A
product_detailsobject holding model number, storage, OS, dimensions, and battery figures. - A
variationsarray listing sibling ASINs with colour, size, and carrier dimensions.
Because the fields are named and nested, a downstream job can read price, rating, and rank without parsing HTML. Treat the numbers as a snapshot of the moment the request ran, not as a live price feed.
What the pricing response adds
The pricing endpoint returns an offer list rather than a single buy-box figure. In the captured example for ASIN B087TXHLVQ, the response contains three offers: a new condition at 38.97 USD from a named seller, a used very good condition at 35.07 USD, and a used like new condition at 35.46 USD. Each offer carries its own condition, currency, delivery text, delivery options, seller name, seller ID, and rating count.
This structure is what makes the pricing endpoint useful for offer comparison: you can see condition tiers side by side instead of a single headline price. The review count on the record (6903) is separate from the per-offer rating counts, so read both fields when you need the full picture.
What the search response adds
The search endpoint returns a product list plus refinements. In the captured example for the query iphone 16, the response includes a products array where each entry carries ASIN, title, price, strikethrough price, rating, review count, sales volume text, shipping information, sponsored and Amazon's Choice flags, organic position, and image URL. The response also includes a products_count and a refinements object grouping filter options such as battery capacity, each with a name, value, and link.
Two fields deserve attention. organic_position tells you where a product sits in the non-sponsored ordering, while sponsored_position is null for organic entries. is_sponsored marks paid placements. Use these together when you need to separate paid visibility from organic rank.
When to use light request mode
Light request mode is a trade-off control. It returns faster and cheaper results, which suits high-volume monitoring where you need price and availability rather than every field. The full mode is the better choice when you need the complete record, including variations, product details, and offer-level pricing.
A sensible pattern is to run light requests on a schedule for price and stock checks, then issue a full request only when a value crosses a threshold you care about.
Blocking versus missing data
Two different problems can look similar in a failed run, and they need different responses.
Anti-bot blocking shows up as CAPTCHAs, rate limiting, or fingerprint checks. Amazon uses these systems actively. The API is designed to handle them with rotating proxies, headless browsers, and CAPTCHA solving; confirm the current behavior with the provider before relying on it. A blocked request is usually a signal to check your plan's concurrency and credit budget rather than to rewrite your parser.
Missing or partial fields are a data-shape problem, not a blocking problem. Shipping information is a known example: it sometimes loads and sometimes does not. A null buybox, an empty reviews array, or a null rating_stars_distribution means the field was absent on that page at that moment, not that the request was rejected. Design your pipeline to tolerate nulls in optional fields and to retry only when a required field is missing.
Integration shape
The API is a plain HTTP GET with a bearer token in the Authorization header. The provider supplies code samples for Python, JavaScript, PHP, Ruby, Java, and Go, and the same request shape works from curl. No framework is required.
For teams that prefer visual automation, the provider documents connections to Make and n8n so that product monitoring and report delivery can run without custom code. Results can be sent to spreadsheets, chat, or other APIs.
Legal and compliance notes
Scraping Amazon can be legally complex because it may conflict with Amazon's terms of service. Review the applicable legal guidance for your jurisdiction and use case before running a collection job.
The provider states that it does not collect or store personal data from scraped sites unless the user explicitly requests it; confirm this with the provider before relying on it. Review extraction should be limited to what your use case requires and should comply with Amazon's terms and applicable privacy law.
| Endpoint | Primary input | Other inputs | Typical output |
|---|---|---|---|
| Product API | query (ASIN) | country, language, domain, light_request, device | Product detail, pricing, rating, sales rank, variations |
| Pricing API | asin | country, language, domain, light_request, device | Offer list with condition, price, seller, delivery |
| Search API | query (search term) | country, language, domain, light_request, merchant_id | Product list, products_count, refinements |
Input names and descriptions are taken from the endpoint documentation on this page. The output column summarizes fields visible in the captured example responses and is not an exhaustive schema.
Frequently asked questions
Is scraping Amazon legal?
Scraping Amazon can be legally complex because it may violate Amazon's terms of service. Review the legal guidelines that apply to your jurisdiction and use case, and use the API's settings responsibly.
Does Amazon block web scrapers?
Yes. Amazon uses anti-bot systems including CAPTCHAs, IP rate limiting, and browser fingerprinting. The API handles these with rotating proxies, headless browsers, and CAPTCHA solving so that product data collection can continue without manual intervention.
How do I scrape Amazon product data?
Send a request to the Amazon API with the product ASIN or URL. The response is structured JSON containing product details, pricing, reviews, ratings, and seller information.
Can I scrape Amazon reviews?
Yes. The Amazon API can extract customer reviews, ratings, and review metadata. Make sure your use case complies with Amazon's terms of service and applicable law.
What is the difference between country and domain?
Country is a two-letter code that sets the location results are scraped from. Domain selects the Amazon marketplace host, such as amazon.com or amazon.co.uk. Set both when you need a specific storefront view.
When should I use light request mode?
Use it for high-volume price and stock checks where speed and cost matter more than completeness. Switch to a full request when you need variations, product details, or offer-level pricing.
{
"ads": null,
"answered_questions_count": 0,
"asin": "B0DPDRNSXV",
"asin_in_url": "B0DPDRNSXV",
"brand": "Apple",
"bullet_points": "This pre-owned product is not Apple certified, but has been professionally inspected, tested and cleaned by Amazon-qualified suppliers.\nThere will be no visible cosmetic imperfections when held at an arm’s length. There will be no visible cosmetic imperfections when held at an arm’s length.\nThis product will have a battery which exceeds 80% capacity relative to new.\nAccessories will not be original, but will be compatible and fully functional. Product may come in generic Box.\nThis product is eligible for a replacement or refund within 90 days of receipt if you are not satisfied.",
"buybox": null,
"category": [
{
"ladder": [
{
"name": "Cell Phones & Accessories",
"url": "/cell-phones-service-plans-accessories/b/ref=dp_bc_1?ie=UTF8&node=2335752011"
},
{
"name": "Cell Phones",
"url": "/cell-phone-devices/b/ref=dp_bc_2?ie=UTF8&node=7072561011"
}
]
}
],
"coupon": "",
"coupon_discount_percentage": null,
"currency": "USD",
"deal_type": null,
"delivery": [
{
"date": {
"by": "Tomorrow, September 13"
},
"type": "FREE delivery"
}
],
"description": "Example post details.",
"developer_info": [],
"discount_end": null,
"discount_percentage": 11,
"featured_merchant": {
"is_amazon_fulfilled": false,
"link": "/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=A230ZFNKXE1WUD&asin=B0DPDRNSXV&ref_=dp_merchant_link",
"name": "ELECTRONIC DEALS",
"seller_id": "A230ZFNKXE1WUD",
"shipped_from": "ELECTRONIC DEALS"
},
"has_videos": false,
"highest_price": 675,
"html": null,
"images": [
"https://m.media-amazon.com/images/I/31-6u85wcSL._AC_.jpg"
],
"important_information": null,
"is_addon_item": null,
"is_prime": false,
"item_form": null,
"lightning_deal": null,
"manufacturer": "Amazon Renewed",
"max_quantity": 9,
"other_sellers": null,
"page": 1,
"page_type": "Product",
"parent_asin": "B0DPTG2HKV",
"price": 675,
"price_buybox": 675,
"price_shipping": 0,
"price_sns": 0,
"price_strikethrough": 0,
"pricing_count": 1,
"pricing_str": "Renewed (7) from $675.00$675.00 & FREE Shipping",
"pricing_url": "https://www.amazon.com/gp/offer-listing/B0DPDRNSXV/ref=dp_olp_NEW_mbc?ie=UTF8&condition=NEW",
"product_details": {
"asin": "B0DPDRNSXV",
"batteries": "1 Lithium Ion batteries required. (included)",
"battery_capacity": "3491 Milliamp Hours",
"battery_power_rating": "3561 Milliamp Hours",
"best_sellers_rank": "#5,163 in Cell Phones & Accessories (See Top 100 in Cell Phones & Accessories) #68 in Renewed Smartphones #100 in Cell Phones",
"color": "Pink",
"connectivity_technologies": "Infrared, USB, Wi-Fi, Wireless",
"customer_reviews": "4.6 4.6 out of 5 stars 114 ratings 4.6 out of 5 stars",
"date_first_available": "October 20, 2024",
"form_factor": "Bar",
"human_interface_input": "Touchscreen",
"item_model_number": "A3081",
"item_weight": "5.9 ounces",
"manufacturer": "Apple",
"memory_storage_capacity": "128 GB",
"os": "iOS 18",
"other_display_features": "Wireless",
"product_dimensions": "5.81 x 2.82 x 0.31 inches",
"ram_memory_installed_size": "8 GB",
"scanner_resolution": "2556 x 1179",
"standing_screen_display_size": "6.1 Inches",
"weight": "0.37 Pounds",
"whats_in_the_box": "Apple iPhone 16, USB Cable"
},
"product_dimensions": "5.81 x 2.82 x 0.31 inches",
"product_name": "Apple iPhone 16, US Version, 128GB, Pink - Unlocked (Renewed Premium)",
"product_overview": [
{
"description": "Example post details.",
"title": "Brand"
},
{
"description": "Example post details.",
"title": "Operating System"
},
{
"description": "Example post details.",
"title": "Ram Memory Installed Size"
},
{
"description": "Example post details.",
"title": "CPU Model"
},
{
"description": "Example post details.",
"title": "CPU Speed"
},
{
"description": "Example post details.",
"title": "Memory Storage Capacity"
},
{
"description": "Example post details.",
"title": "Screen Size"
},
{
"description": "Example post details.",
"title": "Resolution"
},
{
"description": "Example post details.",
"title": "Refresh Rate"
},
{
"description": "Example post details.",
"title": "Model Name"
}
],
"rating": 4.6,
"rating_stars_distribution": null,
"reviews": [],
"reviews_count": 114,
"sales_rank": [
{
"ladder": [
{
"name": "Cell Phones & Accessories ",
"url": "/gp/bestsellers/wireless/ref=pd_zg_ts_wireless"
}
],
"rank": 5163
},
{
"ladder": [
{
"name": "Renewed Smartphones",
"url": "/gp/bestsellers/amazon-renewed/17871142011/ref=pd_zg_hrsr_amazon-renewed"
}
],
"rank": 68
},
{
"ladder": [
{
"name": "Cell Phones",
"url": "/gp/bestsellers/wireless/7072561011/ref=pd_zg_hrsr_wireless"
}
],
"rank": 100
}
],
"sns_discounts": [],
"stock": "Only 9 left in stock - order soon.",
"store_url": "/Amazon-Renewed/b/ref=bl_dp_s_web_12653393011?ie=UTF8&node=12653393011&field-lbr_brands_browse-bin=Amazon+Renewed",
"technical_details": null,
"title": "Apple iPhone 16, US Version, 128GB, Pink - Unlocked (Renewed Premium)",
"url": "https://www.amazon.com/dp/B0DPDRNSXV?language=en_US",
"variations": [
{
"asin": "B0DPCYVF47",
"dimensions": {
"Color": "Black",
"Size": "128GB",
"Wireless Provider": "T-Mobile"
},
"selected": false
},
...
{
"asin": "B0DPDSD11Q",
"dimensions": {
"Color": "Teal",
"Size": "128GB",
"Wireless Provider": "Unlocked for All Carriers"
},
"selected": false
}
],
"warranty_and_support": null
}
{
"asin": "B087TXHLVQ",
"asin_in_url": "B087TXHLVQ",
"html": null,
"page": 1,
"review_count": 6903,
"title": "HOOBRO Folding TV Tray Tables, Set of 2 Side Table for Small Space, Industrial Snack Tables for Eating at Couch, Stable Metal Frame, Easy Assembly, Space Saving, Rustic Brown and Black BF25BZ01",
"url": "https://www.amazon.com/gp/product/ajax/aodAjaxMain/ref=dp_aod_unknown_mbc?asin=B087TXHLVQ&pageno=1&language=en_US",
"pricing": [
{
"condition": "New",
"currency": "USD",
"delivery": "Ships from Amazon.com",
"delivery_options": [
{
"date": {
"by": "Tuesday, June 2"
},
"type": "FREE delivery"
},
{
"date": {
"by": "Tomorrow, May 29"
},
"type": "Prime members FREE delivery"
}
],
"price": 38.97,
"price_shipping": 0,
"rating_count": 17268,
"seller": "HOOBRO US",
"seller_id": "A3SKXH2JUBBQ8Y",
"seller_link": "/gp/aag/main?ie=UTF8&seller=A3SKXH2JUBBQ8Y&isAmazonFulfilled=1&asin=B087TXHLVQ&ref_=olp_merch_name_0"
},
{
"condition": "Used - Very Good",
"currency": "USD",
"delivery": "Ships from Amazon.com",
"delivery_options": [
{
"date": {
"by": "Wednesday, June 3"
},
"type": "FREE delivery"
}
],
"price": 35.07,
"price_shipping": 0,
"rating_count": 0,
"seller": "Amazon Resale",
"seller_id": "",
"seller_link": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011"
},
{
"condition": "Used - Like New",
"currency": "USD",
"delivery": "Ships from Amazon.com",
"delivery_options": [
{
"date": {
"by": "Wednesday, June 3"
},
"type": "FREE delivery"
}
],
"price": 35.46,
"price_shipping": 0,
"rating_count": 0,
"seller": "Amazon Resale",
"seller_id": "",
"seller_link": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011"
}
]
}
{
"html": "", # Use add_html=true to get the full HTML response
"url": "https://www.amazon.com/s?k=iphone+16&page=1&language=en_US"
"page": 1,
"products": [
{
"asin": "B0DGHH9WMX",
"best_seller": false,
"currency": "USD",
"highest_price": 39.99,
"is_amazons_choice": false,
"is_prime": false,
"is_sponsored": true,
"is_video": null,
"manufacturer": "",
"organic_position": 1,
"price": 39.99,
"price_strikethrough": 49,
"pricing_count": 1,
"rating": 4.5,
"reviews_count": 1934,
"sales_volume": "500+ bought in past month",
"shipping_information": "FREE delivery Mon, Sep 22",
"sponsored_position": null,
"title": "iPhone 16 Clear Case with MagSafe and Camera Control: Lightweight Phone Case, Wireless Charging Compatible, Smooth Glossy Finish",
"url": "/sspa/click?ie=UTF8&spc=MTo3OTg1MzI2MDA1MzM3Nzg0OjE3NTc2NjM2OTY6c3BfYXRmOjMwMDQwNzcxMzk2NTkwMjo6MDo6&url=/Apple-iPhone-MagSafe-Camera-Control/dp/B0DGHH9WMX/ref=sr_1_1_sspa?dib=eyJ2IjoiMSJ9.MUo4aqcokGTenXfAL4iZAn2MnWqsNIC9tCokWLgO5AG-PvJmF4Bn99Cp1OhJKoivOrII9El6_dDsYNU8-RFZmmxabOG-1v_2V1tsPCtpbNuHFGM1devOF_7Gn_tuRu0LnuLfg3QkRpMXXkeqpSucS6aa7Ba6g4mPG08f16opjwwtJ-zZHY0FvHq480uhXBfcfpaqEkUQKHvroWqvyTGicwn74QvOahjq1f-xBjhBl3I.fcm270pzFN4A4U4QIiIkzvqIgXtkAmIeFL243g-kEC4&dib_tag=se&keywords=iphone+16&qid=1757663696&sr=8-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1",
"url_image": "https://m.media-amazon.com/images/I/71K2g1AgnLL._AC_UY218_.jpg",
"variations": []
},
...
{
"asin": "B0DMYRZJ69",
"best_seller": false,
"currency": "USD",
"highest_price": 569.56,
"is_amazons_choice": false,
"is_prime": false,
"is_sponsored": false,
"is_video": null,
"manufacturer": "",
"organic_position": 18,
"price": 569.56,
"price_strikethrough": 598.82,
"pricing_count": 1,
"rating": 4.5,
"reviews_count": 55,
"sales_volume": "50+ bought in past month",
"shipping_information": "FREE delivery Mon, Sep 22Or fastest delivery Tomorrow, Sep 13",
"sponsored_position": null,
"title": "Apple iPhone 16 Plus, 128GB, Pink - T-Mobile (Renewed)",
"url": "/Apple-iPhone-Plus-128GB-Pink/dp/B0DMYRZJ69/ref=sr_1_18?dib=eyJ2IjoiMSJ9.MUo4aqcokGTenXfAL4iZAn2MnWqsNIC9tCokWLgO5AG-PvJmF4Bn99Cp1OhJKoivOrII9El6_dDsYNU8-RFZmmxabOG-1v_2V1tsPCtpbNuHFGM1devOF_7Gn_tuRu0LnuLfg3QkRpMXXkeqpSucS6aa7Ba6g4mPG08f16opjwwtJ-zZHY0FvHq480uhXBfcfpaqEkUQKHvroWqvyTGicwn74QvOahjq1f-xBjhBl3I.fcm270pzFN4A4U4QIiIkzvqIgXtkAmIeFL243g-kEC4&dib_tag=se&keywords=iphone+16&qid=1757663696&sr=8-18",
"url_image": "https://m.media-amazon.com/images/I/31BVQroLBUL._AC_UY218_.jpg",
"variations": []
}
],
"products_count": 22,
"refinements": {
"battery_capacity": [
{
"link": "/s?k=iphone+16&rh=n%3A21514055011%2Cp_n_g-101015098008111%3A120185115011&dc&language=en_US&qid=1757663696&rnid=120185111011&ref=sr_nr_p_n_g-101015098008111_1&ds=v1%3AU%2FHfUzaCpWwZoHXb43Xf7R2Ab58ACAbasU9LsBEcUE4",
"name": "Up to 2,999 mAh",
"refinement_display_name": "Battery Capacity",
"value": "n:21514055011,p_n_g-101015098008111/120185115011"
},
{
"link": "/s?k=iphone+16&rh=n%3A21514055011%2Cp_n_g-101015098008111%3A120185114011&dc&language=en_US&qid=1757663696&rnid=120185111011&ref=sr_nr_p_n_g-101015098008111_2&ds=v1%3AFFyukaU7Fws1%2FAjuxyDrYQRn7b06vm8UZQmW%2B3T8i8I",
"name": "3,000 to 3,999 mAh",
"refinement_display_name": "Battery Capacity",
"value": "n:21514055011,p_n_g-101015098008111/120185114011"
},
{
"link": "/s?k=iphone+16&rh=n%3A21514055011%2Cp_n_g-101015098008111%3A120185112011&dc&language=en_US&qid=1757663696&rnid=120185111011&ref=sr_nr_p_n_g-101015098008111_3&ds=v1%3AHheQ1XxVNf%2F%2BI8vagmRZ1ttGGO1%2BpIWVXJU%2FsJPtTZU",
"name": "4,000 to 4,999 mAh",
"refinement_display_name": "Battery Capacity",
"value": "n:21514055011,p_n_g-101015098008111/120185112011"
},
{
"link": "/s?k=iphone+16&rh=n%3A21514055011%2Cp_n_g-101015098008111%3A120185113011&dc&language=en_US&qid=1757663696&rnid=120185111011&ref=sr_nr_p_n_g-101015098008111_4&ds=v1%3AHTRHkdpT6I8We0JPHIFIqYgXquS8c7GITCEvTzC%2BzUg",
"name": "5,000 to 5,999 mAh",
"refinement_display_name": "Battery Capacity",
"value": "n:21514055011,p_n_g-101015098008111/120185113011"
},
{
"link": "/s?k=iphone+16&rh=n%3A21514055011%2Cp_n_g-101015098008111%3A120224515011&dc&language=en_US&qid=1757663696&rnid=120185111011&ref=sr_nr_p_n_g-101015098008111_5&ds=v1%3AxfVFtKOkVhKiCGB9KqXIEmwoNj2UJhwBc5z5t1CYA9Y",
"name": "6,000 mAh & Above",
"refinement_display_name": "Battery Capacity",
"value": "n:21514055011,p_n_g-101015098008111/120224515011"
}
],
...
},
}