Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt

Use this file to discover all available pages before exploring further.

This tutorial walks you through sending a synchronous request to each Bright Data Amazon Scraper API endpoint. By the end, you’ll have working examples for products, reviews, sellers info, products global, and products search.

​
Prerequisites

​
Request structure

Every synchronous request follows the same pattern: 
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.amazon.com/..."}]
The only thing that changes between endpoints is the dataset_id and the input URL format.
Synchronous requests support up to 20 URLs and have a 1-minute timeout. If the request takes longer, the API automatically returns a snapshot_id instead. See async requests.

​
How to scrape Amazon products

Dataset ID: gd_l7q7dkf244hwjntr0 
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l7q7dkf244hwjntr0&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'
You should see a 200 response. This takes 10-30 seconds. 
[
  {
    "title": "Apple AirPods Pro (2nd Generation)",
    "asin": "B0CHHSFMRL",
    "price": 189.99,
    "currency": "USD",
    "rating": 4.7,
    "reviews_count": 85420,
    "seller_name": "Amazon.com",
    "brand": "Apple",
    "availability": "In Stock",
    "main_image": "https://m.media-amazon.com/images/I/...",
    "url": "https://www.amazon.com/dp/B0CHHSFMRL"
  }
]
Full Products response schema

​
How to scrape Amazon reviews

Dataset ID: gd_le8e811kzy4ggddlq 
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_le8e811kzy4ggddlq&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/dp/B0CHHSFMRL"}]'

[
  {
    "title": "Best noise cancellation ever",
    "text": "These earbuds have incredible noise cancellation. The fit is comfortable and battery life is outstanding.",
    "rating": 5,
    "date": "2024-08-15T00:00:00.000Z",
    "author_name": "TechReviewer42",
    "verified_purchase": true,
    "helpful_count": 234,
    "asin": "B0CHHSFMRL",
    "url": "https://www.amazon.com/dp/B0CHHSFMRL"
  }
]
Full Reviews response schema

​
How to scrape Amazon sellers info

Dataset ID: gd_lhotzucw1etoe5iw1k 
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lhotzucw1etoe5iw1k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"}]'

[
  {
    "seller_name": "TechGadgets Direct",
    "seller_id": "A2FE5N3LOEXQRU",
    "rating": 4.5,
    "ratings_count": 12450,
    "positive_feedback_pct": 95,
    "business_name": "TechGadgets LLC",
    "business_address": "123 Commerce St, Seattle, WA 98101",
    "url": "https://www.amazon.com/sp?seller=A2FE5N3LOEXQRU"
  }
]
Full Sellers Info response schema

​
How to scrape Amazon products globally

Dataset ID: gd_lwhideng15g8jg63s7 
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwhideng15g8jg63s7&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"}]'

[
  {
    "title": "Apple AirPods Pro (2nd Generation)",
    "asin": "B0CHHSFMRL",
    "price": 229.00,
    "currency": "GBP",
    "rating": 4.7,
    "reviews_count": 32150,
    "seller_name": "Amazon.co.uk",
    "brand": "Apple",
    "availability": "In Stock",
    "domain": "amazon.co.uk",
    "url": "https://www.amazon.co.uk/dp/B0CHHSFMRL"
  }
]
Full Products Global response schema Dataset ID: gd_lwdb4vjm1ehb499uxs 
curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lwdb4vjm1ehb499uxs&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "wireless earbuds", "url": "https://www.amazon.com", "pages_to_search": 1}]'

[
  {
    "title": "Apple AirPods Pro (2nd Generation)",
    "asin": "B0CHHSFMRL",
    "price": 189.99,
    "currency": "USD",
    "rating": 4.7,
    "reviews_count": 85420,
    "sponsored": false,
    "position": 1,
    "keyword": "wireless earbuds",
    "url": "https://www.amazon.com/dp/B0CHHSFMRL"
  },
  {
    "title": "Samsung Galaxy Buds2 Pro",
    "asin": "B0B2SH4CN6",
    "price": 159.99,
    "currency": "USD",
    "rating": 4.5,
    "reviews_count": 42300,
    "sponsored": false,
    "position": 2,
    "keyword": "wireless earbuds",
    "url": "https://www.amazon.com/dp/B0B2SH4CN6"
  }
]
Full Products Search response schema

​
Quick reference: dataset IDs

EndpointDataset IDInput format
Productsgd_l7q7dkf244hwjntr0amazon.com/dp/{ASIN}
Reviewsgd_le8e811kzy4ggddlqamazon.com/dp/{ASIN}
Sellers Infogd_lhotzucw1etoe5iw1kamazon.com/sp?seller={SELLER_ID}
Products Globalgd_lwhideng15g8jg63s7amazon.{domain}/dp/{ASIN}
Products Searchgd_lwdb4vjm1ehb499uxskeyword + url + pages_to_search

​
Output formats

Control the response format with the format query parameter:
ValueDescription
jsonJSON array (default)
ndjsonNewline-delimited JSON, one record per line
csvComma-separated values

​
Next steps

Async batch requests

Scrape hundreds of URLs in a single batch job.

API reference

Full parameter and response field reference.