amazon-scraper-v2

Code examples for the Amazon Scraper API. Get real-time product data, prices, reviews, seller information, and more from Amazon marketplaces worldwide.

Quick Start

1. Get Your API Key

Register for a free account and get your API key:

👉 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 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

API Endpoints

Product Endpoints

Endpoint	Description	Example
/search	Search for products	query=laptop&geo=US
/v2/product-details	Get detailed product info	asin=B08C7FBW4N&geo=US
/product	Batch product details (up to 10 ASINs)	asins=B08C7FBW4N,B09VR3N1YW&geo=US
/scrape	Get product offers & prices	asins=B08C7FBW4N&geo=US
/v2/product-reviews	Get product reviews	asin=B08C7FBW4N&geo=US

Seller Endpoints

Endpoint	Description	Example
/seller-profile	Get seller profile	seller_ids=A2L77EE7U53NWQ&geo=US
/v2/seller-products	Get seller's products	seller_id=A2L77EE7U53NWQ&geo=US
/v2/seller-reviews	Get seller reviews	seller_id=A2L77EE7U53NWQ&geo=US

Discovery Endpoints

Endpoint	Description	Example
/v2/best-sellers	Get best sellers	geo=US&page=1
/v2/deals	Get today's deals	geo=US&min_product_star_rating=4

Supported Countries

The API supports the following Amazon marketplaces:

US, CA, DE, MX, UK, FR, IT, ES, AU, BR, IN, JP, NL, AE, PL, SA, SG, SE, TR, BE

Authentication

All API requests require an API key passed via the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" https://api.apiguru.app/search?query=laptop&geo=US

Quick Example

Here's a simple example - just 20 lines of code:

import requests
import json

# Configuration
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://dash.apiguru.app/api/v1"

# Search for products
response = requests.get(
    f"{BASE_URL}/search",
    headers={"x-api-key": API_KEY},
    params={
        "query": "wireless headphones",
        "geo": "US",
        "page": 1
    }
)

# Print the response
print(json.dumps(response.json(), indent=2))

That's it! Check the /examples folder for more endpoint examples.

Common Use Cases

1. Price Tracking

Monitor product prices across different sellers and countries.

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/scrape",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"asins": "B08C7FBW4N", "geo": "US", "condition": "new"}
)

offers = response.json()
offer_data = offers['results'][0]['data']

# Get price stats
prices = [offer['price'] for offer in offer_data]
print(f"Lowest Price: ${min(prices)}")
print(f"Highest Price: ${max(prices)}")
print(f"Total Offers: {len(offer_data)}")

2. Product Research

Find profitable products with good ratings and sales volume.

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/v2/best-sellers",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"geo": "US", "page": 1}
)

best_sellers = response.json()

# Filter high-rated products
for product in best_sellers['data']:
    if float(product['star_rating']) >= 4.5:
        print(f"{product['title']}")
        print(f"  Price: {product['price']}")
        print(f"  Rating: {product['star_rating']}")

3. Competitor Analysis

Monitor competitor products and pricing.

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/seller-profile",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"seller_ids": "A2L77EE7U53NWQ", "geo": "US"}
)

profile = response.json()
seller = profile['data']
lifetime = seller['reviews']['lifetime_reviews']

print(f"Business: {seller['business_name']}")
print(f"Total Reviews: {lifetime['reviews_count']}")
print(f"Positive: {lifetime['positive_percentage']}")

4. Review Analysis

Analyze customer sentiment and product feedback.

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/v2/product-reviews",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"asin": "B08C7FBW4N", "geo": "US", "page": 1}
)

data = response.json()['data']

# Analyze sentiment
positive = sum(1 for r in data['reviews'] if float(r['rating'].split()[0]) >= 4.0)
negative = sum(1 for r in data['reviews'] if float(r['rating'].split()[0]) <= 2.0)

print(f"Total Reviews: {data['total_reviews']}")
print(f"Positive: {positive}, Negative: {negative}")

5. Deal Finder

Find the best deals automatically.

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/v2/deals",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "geo": "US",
        "min_product_star_rating": "4"
    }
)

deals = response.json()

# Display top deals
for deal in deals.get('deals', [])[:5]:
    print(f"{deal['title']}")
    print(f"  Price: {deal['deal_price']}")

6. Batch Product Details

Get details for multiple products at once (up to 10 ASINs).

import requests

response = requests.get(
    "https://dash.apiguru.app/api/v1/product",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "geo": "US",
        "asins": "B0014BYHJE,B0CP9YB3Q4,B0C59CLN29,B0BNYR7MQV,B0CJF94M8J"
    }
)

products = response.json()

# Display all products
for product in products:
    print(f"ASIN: {product['asin']}")
    print(f"Title: {product.get('title', 'N/A')}")
    print(f"Price: {product.get('price', 'N/A')}")
    print("---")

Parameters Reference

Common Parameters

Parameter	Type	Required	Description	Example
geo	string	Yes	Country code	US, UK, DE
asin	string	Varies	Amazon product ID (10 chars)	B08C7FBW4N
page	integer	No	Page number (1-100)	1

Search Parameters

Parameter	Type	Required	Description	Example
query	string	Yes	Search term	laptop

Offers Parameters

Parameter	Type	Required	Description	Example
asins	string	Yes	Single or comma-separated ASINs	B08C7FBW4N,B09VR3N1YW
condition	string	No	Product condition	new, used, all
check_inventory	boolean	No	Check real-time inventory	true, false

Seller Parameters

Parameter	Type	Required	Description	Example
seller_id	string	Yes	Amazon seller ID	A2L77EE7U53NWQ
seller_ids	string	Yes	Comma-separated seller IDs	A2L77EE7U53NWQ,A3BCD...
from_rating	string	No	Filter from rating	1, 2, 3, 4, 5
to_rating	string	No	Filter to rating	1, 2, 3, 4, 5

Deals Parameters

Parameter	Type	Required	Description	Example
min_product_star_rating	string	No	Minimum product rating	ALL, 1, 2, 3, 4, 5
price_range	string	No	Price filter	ALL, 0-25, 25-50, 50-100, 100-200, 200+
discount_range	string	No	Discount filter	ALL, 10-25, 25-50, 50-70, 70+

Error Handling

The API uses standard HTTP status codes:

Code	Description	Solution
200	Success	Request completed successfully
400	Bad Request	Check your parameters
401	Unauthorized	Invalid API key
402	Payment Required	Insufficient credits or no active subscription
429	Rate Limit	Wait and retry
500	Server Error	Retry the request

Example Error Handling

try:
    results = await api.search_products("laptop", "US")
except Exception as e:
    if "402" in str(e):
        print("Please add funds at https://dash.apiguru.app/top-up")
    elif "429" in str(e):
        print("Rate limit - waiting 60 seconds...")
        await asyncio.sleep(60)
    else:
        print(f"Error: {e}")

Rate Limits

Rate limits depend on your subscription plan:

• Free Trial: Limited requests to test the API
• Pay-as-you-go: Based on account balance
• Subscription Plans: Higher limits with better rates

Check your current usage at https://dash.apiguru.app/profile

Installation

Just install requests:

pip install requests

Or use the requirements file:

pip install -r requirements.txt

That's it!

Project Structure

amazon-scraper-v2/
├── README.md                          # This file
├── requirements.txt                   # Python dependencies (just requests)
├── examples/                          # Simple Python examples
│   ├── 01_search_products.py         # Search for products
│   ├── 02_product_details.py         # Get product details
│   ├── 03_product_offers.py          # Get product offers
│   ├── 04_product_reviews.py         # Get product reviews
│   ├── 05_best_sellers.py            # Get best sellers
│   ├── 06_todays_deals.py            # Get today's deals
│   ├── 07_seller_profile.py          # Get seller profile
│   ├── 08_seller_products.py         # Get seller products
│   ├── 09_seller_reviews.py          # Get seller reviews
│   └── 10_batch_product_details.py   # Batch product details (up to 10)
└── responses/                         # Example API response structures
    ├── productDetails.json
    ├── productDetails_full.json
    ├── productOffers.json
    ├── productReviews.json
    ├── productSearch.json
    ├── bestSellers.json
    ├── sellerProfile.json
    ├── sellerProducts.json
    ├── sellerReviews.json
    └── stockEstimate.json

Tips

1. Reuse the session - Create one requests.Session() for multiple requests
2. Use the right endpoint - Choose the endpoint that returns only what you need
3. Check rate limits - Monitor your usage in the dashboard

Support

• Documentation: https://docs.apiguru.app
• Dashboard: https://dash.apiguru.app
• API Status: Check your usage and limits in the dashboard

License

These code examples are provided as-is for use with the Amazon API service.

Get Started Now!

1. Register: https://dash.apiguru.app/register
2. Get your API key: Free trial included!
3. Copy examples: Choose your language
4. Start building: Fast, modern, simple