amazon-scraper-tool / README.md
bugrahans's picture
Upload 4 files
dca809d verified
|
Raw History Blame Contribute Delete
3.77 kB

A newer version of the Gradio SDK is available: 6.32.0

Upgrade
metadata
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:

  • 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 — 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

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 for the legal and ethical boundaries.


Learn more at scrape.do · Documentation

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