Skip to main content
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_TOKEN
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.

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_TOKEN" \
  -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

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_TOKEN" \
  -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

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_TOKEN" \
  -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

Products Global

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_TOKEN" \
  -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_TOKEN" \
  -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.