File size: 3,766 Bytes
dca809d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
---
title: Amazon Product Scraper
short_description: Scrape Amazon products, sellers and search results as JSON
emoji: 📦
colorFrom: yellow
colorTo: blue
sdk: gradio
sdk_version: 6.0.2
app_file: app.py
pinned: false
tags:
- amazon-scraper
- amazon
- product-data
- price-tracking
- ecommerce
- web-scraping
- scraper
- data-extraction
- anti-bot
- proxy
- smolagents
- tool
- scrape.do
---

# Amazon Product Scraper — Powered by Scrape.do

Pull structured JSON out of any Amazon marketplace: product detail pages, every
seller offer on an ASIN, and keyword or category search results. No HTML parsing.

Powered by the [Scrape.do Amazon Scraper API](https://scrape.do/documentation/amazon-scraper-api/):

- Bypasses AWS WAF, CAPTCHAs and rate limits automatically
- 21 Amazon marketplaces with ZIP-code level delivery targeting
- Parsed JSON — ASIN, brand, price, list price, rating, images, rankings, specs
- Organic vs. sponsored flags and exact on-page positions in search
- 1 credit per successful request

## 🔑 Get your free API token

👉 **[Sign up free on Scrape.do](https://dashboard.scrape.do/sign-up?utm_source=huggingface&utm_medium=amazon-scraper)** — 1,000 successful requests per month, no credit card required.

Paste your token into the UI and start scraping.

## Three modes

| Tab | Input | Output |
| --- | --- | --- |
| **Product page** | Product URL or ASIN | Title, brand, price, list price, rating, images, best seller rankings, technical details |
| **Seller offers** | Product URL or ASIN | Every active offer with price, condition, seller, fulfilment and Buy Box winner |
| **Search results** | Keyword + page | Ranked products with ASIN, price, rating, Prime, sponsored flag and badge |

Every tab returns the raw JSON response and a CSV download.

## Location targeting

Amazon shows different prices, stock and delivery depending on where the buyer is.

- **ZIP-level marketplaces** (`us`, `gb`, `de`, `fr`, `it`, `es`, `ca`, `jp`, `in`) — enter a postal code in the **Delivery location** field.
- **Country-level marketplaces** (`tr`, `br`, `au`, `mx`, `nl`, `pl`, `se`, `ae`, `sa`, `sg`, `eg`, `be`) — enter a delivery country name, or leave it blank to use the marketplace default.

ZIP format is validated per marketplace, so `SW1A 1AA` works for `gb` but not for `us`.

## Use as a smolagents Tool

```python
from smolagents import CodeAgent, InferenceClientModel
from tool import ScrapeDoAmazonTool

agent = CodeAgent(
    tools=[ScrapeDoAmazonTool(api_token="YOUR_SCRAPEDO_TOKEN")],
    model=InferenceClientModel(),
)
agent.run("Compare the price and Buy Box seller for ASIN B0BLRJ4R8F in the US and the UK")
```

You can also set `SCRAPE_DO_API_TOKEN` in your environment and instantiate
`ScrapeDoAmazonTool()` without arguments.

## Inputs

- `mode` *(required)* — `product`, `offers` or `search`.
- `query` *(required)* — Product URL or ASIN for `product` and `offers`; keyword for `search`.
- `geocode` *(optional)* — Marketplace country code, defaults to `us`.
- `zipcode` *(optional)* — ZIP code, or a delivery country name on country-level marketplaces.
- `page` *(optional)* — Search results page number, defaults to `1`.
- `language` *(optional)* — Uppercase ISO 639-1 code supported by the marketplace, e.g. `EN`, `DE`.

## Scope

Only publicly available product data. Anything behind an Amazon login — account
pages, the full customer review archive — is out of scope. See the
[Amazon scraping guide](https://scrape.do/blog/amazon-scraping/) for the legal
and ethical boundaries.

---

Learn more at [scrape.do](https://scrape.do/) · [Documentation](https://scrape.do/documentation/)

Check out the configuration reference at <https://huggingface.co/docs/hub/spaces-config-reference>.