Skip to content
Back to search

amazon-scraper-v2

Agent-ready Amazon Scraper API: real-time product details (batch ASIN), offers & stock, reviews, search, best sellers, deals and seller data across 20 marketplaces. One pasted line for Claude Code / Codex / Cursor, an MCP server, or plain HTTP with 3 free calls a day and no key. Python examples inside.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/apiguru-app--amazon-scraper-v2/badge.svg)](/listings/apiguru-app--amazon-scraper-v2)

HTML

<a href="/listings/apiguru-app--amazon-scraper-v2"><img src="/api/listings/apiguru-app--amazon-scraper-v2/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get Your API Key for **amazon-scraper-v2**

Register for a free account and get your API key:

**πŸ‘‰ [https://dash.apiguru.app/register](https://dash.apiguru.app/register)**

Free trial requests included with every account!

2. Install Dependencies

pip install requests

3. Run Examples

Each endpoint has its own simple example file. Just add your API key for **amazon-scraper-v2** and run:

# Search for products
python examples/01_search_products.py

# Get product details
python examples/02_product_details.py

# Get product offers
python examples/03_product_offers.py

# Get product reviews
python examples/04_product_reviews.py

# Get best sellers
python examples/05_best_sellers.py

# Get today's deals
python examples/06_todays_deals.py

# Get seller profile
python examples/07_seller_profile.py

# Get seller products
python examples/08_seller_products.py

# Get seller reviews
python examples/09_seller_reviews.py

# Batch product details (up to 10 ASINs)
python examples/10_batch_product_details.py

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 467 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <a href="https://dash.apiguru.app/landing">
  3. <img src="https://raw.githubusercontent.com/apiguru-app/amazon-scraper-v2/refs/heads/main/service_logo_github.png" alt="apiGURU Amazon Scraper API Logo"/>
  4. </a>
  5. <p>
  6. <a href="https://agent.apiguru.app/llms.txt"><img src="https://img.shields.io/badge/agent--ready-llms.txt-7c3aed" alt="agent-ready: llms.txt"></a>
  7. <a href="https://registry.modelcontextprotocol.io/v0/servers?search=app.apiguru"><img src="https://img.shields.io/badge/MCP-server-2563eb" alt="MCP server"></a>
  8. <a href="https://pypi.org/project/apiguru-mcp/"><img src="https://img.shields.io/pypi/v/apiguru-mcp?label=PyPI&color=3775a9" alt="apiguru-mcp on PyPI"></a>
  9. <a href="https://www.npmjs.com/package/apiguru-mcp"><img src="https://img.shields.io/npm/v/apiguru-mcp?label=npm&color=cb3837" alt="apiguru-mcp on npm"></a>
  10. <a href="https://agent.apiguru.app/.well-known/x402"><img src="https://img.shields.io/badge/x402-USDC%20on%20Base-0052ff" alt="x402: USDC on Base"></a>
  11. <a href="https://dash.apiguru.app/openapi.json"><img src="https://img.shields.io/badge/OpenAPI-3.1-6ba539" alt="OpenAPI 3.1"></a>
  12. </p>
  13. </div>
  14. # amazon-scraper-v2 β€” the agent-ready Amazon Scraper API
  15. Real-time Amazon data β€” product details, prices, offers & stock, reviews, search, best sellers, deals and seller data β€” across 20 marketplaces. Call it from Python in 20 lines (examples below), or hand it to the AI agent you already have open: it reads our docs itself and starts pulling live data. No SDK, no wrapper code, nothing to install.
  16. ## Start with your AI
  17. Paste one sentence into Claude Code, Codex, Cursor, Gemini CLI, Copilot, Claude Desktop, ChatGPT β€” anything that can call HTTP:
  18. ```
  19. Use Apiguru for live Amazon data. Read https://agent.apiguru.app/llms.txt first, then call it.
  20. ```
  21. That is the whole integration. Three ways in, same URL:
  22. | Mode | The line to paste | What you get |
  23. |---|---|---|
  24. | **No account** | `Use Apiguru for live Amazon data. Read https://agent.apiguru.app/llms.txt first, then call it.` | 3 free calls a day, per machine. No account, no key, no card β€” enough for an agent to prove the data is what you need. |
  25. | **With a key** | `Use Apiguru for live Amazon data. Read https://agent.apiguru.app/llms.txt first, then call it with the header X-API-KEY: YOUR_API_KEY` | A [free key from the dashboard](https://dash.apiguru.app/register) raises that to 100 requests a month, and every call your agent makes shows up in your usage graph. |
  26. | **With a wallet** | `Use Apiguru for live Amazon data. Read https://agent.apiguru.app/llms.txt first, then call it, and settle the 402 with x402 from my wallet.` | Pays per call in USDC on Base β€” about a cent a call, still no account. Your agent needs an x402 client and a funded wallet. |
  27. Curious what the agent sees? **[Read what your agent reads β†’](https://agent.apiguru.app/llms.txt)**
  28. ## Or wire it in as permanent tools
  29. The one line above needs nothing installed. If you would rather your client list Apiguru as named tools it can pick from β€” and remember them between sessions β€” there is an MCP server too: 12 tools with prices and retry rules written into the descriptions, sign-in from claude.ai or ChatGPT that bills the same account, and the same three ways in.
  30. ```bash
  31. # claude.ai / Claude Desktop / ChatGPT: add a connector
  32. https://mcp.apiguru.app/account
  33. # Claude Code
  34. claude mcp add --transport http apiguru https://mcp.apiguru.app/mcp
  35. /plugin marketplace add apiguru-app/agent-kit
  36. # Codex CLI
  37. codex mcp add apiguru --url https://mcp.apiguru.app/mcp
  38. # any local MCP client
  39. uvx apiguru-mcp # PyPI
  40. npx -y apiguru-mcp # npm
  41. # keyless HTTP, no signup: 3 free calls/day, then x402
  42. curl "https://agent.apiguru.app/agent/v1/v2/product-details?asin=B09DJLW458"
  43. ```
  44. Everything an agent needs lives in the **[Agent Kit on GitHub](https://github.com/apiguru-app/agent-kit)**. Machine-readable: [llms.txt](https://dash.apiguru.app/llms.txt) Β· [OpenAPI](https://dash.apiguru.app/openapi.json) Β· [x402 catalogue](https://agent.apiguru.app/.well-known/x402) Β· [PyPI](https://pypi.org/project/apiguru-mcp/) Β· [npm](https://www.npmjs.com/package/apiguru-mcp) Β· [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=app.apiguru)
  45. ## Quick Start (Python)
  46. ### 1. Get Your API Key for **amazon-scraper-v2**
  47. Register for a free account and get your API key:
  48. **πŸ‘‰ [https://dash.apiguru.app/register](https://dash.apiguru.app/register)**
  49. Free trial requests included with every account!
  50. ### 2. Install Dependencies
  51. ```bash
  52. pip install requests
  53. ```
  54. ### 3. Run Examples
  55. Each endpoint has its own simple example file. Just add your API key for **amazon-scraper-v2** and run:
  56. ```bash
  57. # Search for products
  58. python examples/01_search_products.py
  59. # Get product details
  60. python examples/02_product_details.py
  61. # Get product offers
  62. python examples/03_product_offers.py
  63. # Get product reviews
  64. python examples/04_product_reviews.py
  65. # Get best sellers
  66. python examples/05_best_sellers.py
  67. # Get today's deals
  68. python examples/06_todays_deals.py
  69. # Get seller profile
  70. python examples/07_seller_profile.py
  71. # Get seller products
  72. python examples/08_seller_products.py
  73. # Get seller reviews
  74. python examples/09_seller_reviews.py
  75. # Batch product details (up to 10 ASINs)
  76. python examples/10_batch_product_details.py
  77. ```
  78. ## API Endpoints
  79. ### Product Endpoints
  80. | Endpoint | Description | Example |
  81. |----------|-------------|---------|
  82. | `/search` | Search for products | `query=laptop&geo=US` |
  83. | `/v2/product-details` | Get detailed product info | `asin=B08C7FBW4N&geo=US` |
  84. | `/product` | Batch product details (up to 10 ASINs) | `asins=B08C7FBW4N,B09VR3N1YW&geo=US` |
  85. | `/scrape` | Get product offers & prices | `asins=B08C7FBW4N&geo=US` |
  86. | `/v2/product-reviews` | Get product reviews | `asin=B08C7FBW4N&geo=US` |
  87. ### Seller Endpoints
  88. | Endpoint | Description | Example |
  89. |----------|-------------|---------|
  90. | `/seller-profile` | Get seller profile | `seller_ids=A2L77EE7U53NWQ&geo=US` |
  91. | `/v2/seller-products` | Get seller's products | `seller_id=A2L77EE7U53NWQ&geo=US` |
  92. | `/v2/seller-reviews` | Get seller reviews | `seller_id=A2L77EE7U53NWQ&geo=US` |
  93. ### Discovery Endpoints
  94. | Endpoint | Description | Example |
  95. |----------|-------------|---------|
  96. | `/v2/best-sellers` | Get best sellers | `geo=US&page=1` |
  97. | `/v2/deals` | Get today's deals | `geo=US&min_product_star_rating=4` |
  98. ## Supported Countries
  99. The API supports the following Amazon marketplaces:
  100. `US`, `CA`, `DE`, `MX`, `UK`, `FR`, `IT`, `ES`, `AU`, `BR`, `IN`, `JP`, `NL`, `AE`, `PL`, `SA`, `SG`, `SE`, `TR`, `BE`
  101. ## Authentication
  102. All API requests require an API key passed via the `x-api-key` header:
  103. ```bash
  104. curl -H "x-api-key: YOUR_API_KEY" "https://dash.apiguru.app/api/v1/search?query=laptop&geo=US"
  105. ```
  106. ## Quick Example
  107. Here's a simple example - just 20 lines of code:
  108. ```python
  109. import requests
  110. import json
  111. # Configuration
  112. API_KEY = "YOUR_API_KEY_HERE"
  113. BASE_URL = "https://dash.apiguru.app/api/v1"
  114. # Search for products
  115. response = requests.get(
  116. f"{BASE_URL}/search",
  117. headers={"x-api-key": API_KEY},
  118. params={
  119. "query": "wireless headphones",
  120. "geo": "US",
  121. "page": 1
  122. }
  123. )
  124. # Print the response
  125. print(json.dumps(response.json(), indent=2))
  126. ```
  127. That's it! Check the `/examples` folder for more endpoint examples.
  128. ## Common Use Cases
  129. ### 1. Price Tracking
  130. Monitor product prices across different sellers and countries.
  131. ```python
  132. import requests
  133. response = requests.get(
  134. "https://dash.apiguru.app/api/v1/scrape",
  135. headers={"x-api-key": "YOUR_API_KEY"},
  136. params={"asins": "B08C7FBW4N", "geo": "US", "condition": "new"}
  137. )
  138. offers = response.json()
  139. offer_data = offers['results'][0]['data']
  140. # Get price stats
  141. prices = [offer['price'] for offer in offer_data]
  142. print(f"Lowest Price: ${min(prices)}")
  143. print(f"Highest Price: ${max(prices)}")
  144. print(f"Total Offers: {len(offer_data)}")
  145. ```
  146. ### 2. Product Research
  147. Find profitable products with good ratings and sales volume.
  148. ```python
  149. import requests
  150. response = requests.get(
  151. "https://dash.apiguru.app/api/v1/v2/best-sellers",
  152. headers={"x-api-key": "YOUR_API_KEY"},
  153. params={"geo": "US", "page": 1}
  154. )
  155. best_sellers = response.json()
  156. # Filter high-rated products
  157. for product in best_sellers['data']:
  158. if float(product['star_rating']) >= 4.5:
  159. print(f"{product['title']}")
  160. print(f" Price: {product['price']}")
  161. print(f" Rating: {product['star_rating']}")
  162. ```
  163. ### 3. Competitor Analysis
  164. Monitor competitor products and pricing.
  165. ```python
  166. import requests
  167. response = requests.get(
  168. "https://dash.apiguru.app/api/v1/seller-profile",
  169. headers={"x-api-key": "YOUR_API_KEY"},
  170. params={"seller_ids": "A2L77EE7U53NWQ", "geo": "US"}
  171. )
  172. profile = response.json()
  173. seller = profile['data']
  174. lifetime = seller['reviews']['lifetime_reviews']
  175. print(f"Business: {seller['business_name']}")
  176. print(f"Total Reviews: {lifetime['reviews_count']}")
  177. print(f"Positive: {lifetime['positive_percentage']}")
  178. ```
  179. ### 4. Review Analysis
  180. Analyze customer sentiment and product feedback.
  181. ```python
  182. import requests
  183. response = requests.get(
  184. "https://dash.apiguru.app/api/v1/v2/product-reviews",
  185. headers={"x-api-key": "YOUR_API_KEY"},
  186. params={"asin": "B08C7FBW4N", "geo": "US", "page": 1}
  187. )
  188. data = response.json()['data']
  189. # Analyze sentiment
  190. positive = sum(1 for r in data['reviews'] if float(r['rating'].split()[0]) >= 4.0)
  191. negative = sum(1 for r in data['reviews'] if float(r['rating'].split()[0]) <= 2.0)
  192. print(f"Total Reviews: {data['total_reviews']}")
  193. print(f"Positive: {positive}, Negative: {negative}")
  194. ```
  195. ### 5. Deal Finder
  196. Find the best deals automatically.
  197. ```python
  198. import requests
  199. response = requests.get(
  200. "https://dash.apiguru.app/api/v1/v2/deals",
  201. headers={"x-api-key": "YOUR_API_KEY"},
  202. params={
  203. "geo": "US",
  204. "min_product_star_rating": "4"
  205. }
  206. )
  207. deals = response.json()
  208. # Display top deals
  209. for deal in deals.get('deals', [])[:5]:
  210. print(f"{deal['title']}")
  211. print(f" Price: {deal['deal_price']}")
  212. ```
  213. ### 6. Batch Product Details
  214. Get details for multiple products at once (up to 10 ASINs).
  215. ```python
  216. import requests
  217. response = requests.get(
  218. "https://dash.apiguru.app/api/v1/product",
  219. headers={"x-api-key": "YOUR_API_KEY"},
  220. params={
  221. "geo": "US",
  222. "asins": "B0014BYHJE,B0CP9YB3Q4,B0C59CLN29,B0BNYR7MQV,B0CJF94M8J"
  223. }
  224. )
  225. products = response.json()
  226. # Display all products
  227. for product in products:
  228. print(f"ASIN: {product['asin']}")
  229. print(f"Title: {product.get('title', 'N/A')}")
  230. print(f"Price: {product.get('price', 'N/A')}")
  231. print("---")
  232. ```
  233. ## Parameters Reference
  234. ### Common Parameters
  235. | Parameter | Type | Required | Description | Example |
  236. |-----------|------|----------|-------------|---------|
  237. | `geo` | string | Yes | Country code | `US`, `UK`, `DE` |
  238. | `asin` | string | Varies | Amazon product ID (10 chars) | `B08C7FBW4N` |
  239. | `page` | integer | No | Page number (1-100) | `1` |
  240. ### Search Parameters
  241. | Parameter | Type | Required | Description | Example |
  242. |-----------|------|----------|-------------|---------|
  243. | `query` | string | Yes | Search term | `laptop` |
  244. ### Offers Parameters
  245. | Parameter | Type | Required | Description | Example |
  246. |-----------|------|----------|-------------|---------|
  247. | `asins` | string | Yes | Single or comma-separated ASINs | `B08C7FBW4N,B09VR3N1YW` |
  248. | `condition` | string | No | Product condition | `new`, `used`, `all` |
  249. | `check_inventory` | boolean | No | Check real-time inventory | `true`, `false` |
  250. ### Seller Parameters
  251. | Parameter | Type | Required | Description | Example |
  252. |-----------|------|----------|-------------|---------|
  253. | `seller_id` | string | Yes | Amazon seller ID | `A2L77EE7U53NWQ` |
  254. | `seller_ids` | string | Yes | Comma-separated seller IDs | `A2L77EE7U53NWQ,A3BCD...` |
  255. | `from_rating` | string | No | Filter from rating | `1`, `2`, `3`, `4`, `5` |
  256. | `to_rating` | string | No | Filter to rating | `1`, `2`, `3`, `4`, `5` |
  257. ### Deals Parameters
  258. | Parameter | Type | Required | Description | Example |
  259. |-----------|------|----------|-------------|---------|
  260. | `min_product_star_rating` | string | No | Minimum product rating | `ALL`, `1`, `2`, `3`, `4`, `5` |
  261. | `price_range` | string | No | Price filter | `ALL`, `0-25`, `25-50`, `50-100`, `100-200`, `200+` |
  262. | `discount_range` | string | No | Discount filter | `ALL`, `10-25`, `25-50`, `50-70`, `70+` |
  263. ## Error Handling
  264. The API uses standard HTTP status codes:
  265. | Code | Description | Solution |
  266. |------|-------------|----------|
  267. | `200` | Success | Request completed successfully |
  268. | `400` | Bad Request | Check your parameters |
  269. | `401` | Unauthorized | Invalid API key |
  270. | `402` | Payment Required | Insufficient credits or no active subscription |
  271. | `429` | Rate Limit | Wait and retry |
  272. | `500` | Server Error | Retry the request |
  273. ### Example Error Handling
  274. ```python
  275. try:
  276. results = await api.search_products("laptop", "US")
  277. except Exception as e:
  278. if "402" in str(e):
  279. print("Please add funds at https://dash.apiguru.app/top-up")
  280. elif "429" in str(e):
  281. print("Rate limit - waiting 60 seconds...")
  282. await asyncio.sleep(60)
  283. else:
  284. print(f"Error: {e}")
  285. ```
  286. ## Rate Limits
  287. Rate limits depend on your subscription plan:
  288. - **Free Trial**: Limited requests to test the API
  289. - **Pay-as-you-go**: Based on account balance
  290. - **Subscription Plans**: Higher limits with better rates
  291. Check your current usage at [https://dash.apiguru.app/profile](https://dash.apiguru.app/profile)
  292. ## Installation
  293. Just install requests:
  294. ```bash
  295. pip install requests
  296. ```
  297. Or use the requirements file:
  298. ```bash
  299. pip install -r requirements.txt
  300. ```
  301. That's it!
  302. ## Project Structure
  303. ```
  304. amazon-scraper-v2/
  305. β”œβ”€β”€ README.md # This file
  306. β”œβ”€β”€ QUICKSTART.md # Three steps to a first call
  307. β”œβ”€β”€ requirements.txt # Python dependencies (just requests)
  308. └── examples/ # Simple Python examples
  309. β”œβ”€β”€ 01_search_products.py # Search for products
  310. β”œβ”€β”€ 02_product_details.py # Get product details
  311. β”œβ”€β”€ 03_product_offers.py # Get product offers
  312. β”œβ”€β”€ 04_product_reviews.py # Get product reviews
  313. β”œβ”€β”€ 05_best_sellers.py # Get best sellers
  314. β”œβ”€β”€ 06_todays_deals.py # Get today's deals
  315. β”œβ”€β”€ 07_seller_profile.py # Get seller profile
  316. β”œβ”€β”€ 08_seller_products.py # Get seller products
  317. β”œβ”€β”€ 09_seller_reviews.py # Get seller reviews
  318. └── 10_batch_product_details.py # Batch product details (up to 10)
  319. ```
  320. Example response shapes for every endpoint are in the [OpenAPI spec](https://dash.apiguru.app/openapi.json).
  321. ## Tips
  322. 1. **Reuse the session** - Create one `requests.Session()` for multiple requests
  323. 2. **Use the right endpoint** - Choose the endpoint that returns only what you need
  324. 3. **Check rate limits** - Monitor your usage in the dashboard
  325. ## Support for **amazon-scraper-v2**.
  326. - **Documentation**: [llms.txt](https://agent.apiguru.app/llms.txt) (what your agent reads) Β· [OpenAPI](https://dash.apiguru.app/openapi.json) Β· [Agent Kit](https://github.com/apiguru-app/agent-kit)
  327. - **Dashboard**: [https://dash.apiguru.app](https://dash.apiguru.app)
  328. - **API Status**: Check your usage and limits in the dashboard
  329. - **Something wrong or missing?** Open an issue on the [Agent Kit](https://github.com/apiguru-app/agent-kit/issues), or post to the [feedback wall](https://dash.apiguru.app/feedback) β€” no account needed. The agents and developers who report are the ones this API gets fixed for.
  330. ## License
  331. These code examples are provided as-is for use with the Amazon API service.
  332. ## Get Started Now!
  333. To use **amazon-scraper-v2**:
  334. 1. **Register**: [https://dash.apiguru.app/register](https://dash.apiguru.app/register)
  335. 2. **Get your API key**: Free trial included!
  336. 3. **Copy examples**: Choose your language
  337. 4. **Start building**: Fast, modern, simple

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.