Spaces:
Sleeping
Sleeping
|
Download README.md from bugrahans/amazon-scraper-tool: direct link, hf CLI and curl.
- Browser
- Download file 3.77 kB
-
https://huggingface.co/spaces/bugrahans/amazon-scraper-tool/resolve/main/README.md
- Command line
-
hf download hf://spaces/bugrahans/amazon-scraper-tool/README.md
-
curl -L -o README.md https://huggingface.co/spaces/bugrahans/amazon-scraper-tool/resolve/main/README.md
3.77 kB
| 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>. | |