Skip to content
Screaming Data
Documentation menu

API reference

Amazon Product API

Title, byline, variants, price, Best Sellers Rank, rating and product details of any ASIN — as queued tasks, live, or as history.

Product data for any ASIN on 12 Amazon marketplaces: title, byline (usually the brand), the selected variant and its siblings, price, Best Sellers Rank with category ranks, average rating and ratings count, the main image and every product detail that is listed.

Choose the method that fits the workload: the standard method (task_post → tasks_ready → task_get) for volume, priorities and webhooks; live for one interactive lookup; history for stored observations over time.

Endpoints

Standard workflow

  1. 01
    Post tasks

    Send up to 100 task objects per request, each with an ASIN and marketplace. Set a tag to match results to your records, and optionally a postback or pingback URL.

  2. 02
    Wait for completion

    Poll tasks_ready for completed tasks, or let the API call your webhook as soon as each task is done.

  3. 03
    Collect results

    Call task_get for each id. Results stay available for 30 days.

Need one result right now? Use live. Need the same products regularly? Use monitoring.

Ready task

One completed task that has not been collected yet.

id
string (uuid)

Task id.

tag
string· nullable

Tag you set in task_post.

endpoint
string

Path to collect the result from.

date_posted
string (date-time)

When the task was posted, ISO 8601 in UTC.

Product object

Returned by task_get and live (result[0]), by history (every item) and inside monitoring subscriptions. Text is returned as the marketplace shows it, in its language. A field that is not available is null (empty for byline, variants and details) — values are never guessed.

Example, rendered

B0EXAMPLE1·amazon.com

ok

Acme Wireless Noise Cancelling Headphones, Black

Acme

  • BlackB0EXAMPLE1
  • WhiteB0EXAMPLE2
  • Navy BlueB0EXAMPLE3
Price

$59.99

USD

Best Sellers Rank

#1,432

in Electronics

Rating

4.5out of 5

2,318 ratings

  • #12 in Over-Ear Headphones
  • #31 in Noise-Cancelling Headphones

details8 pairs

brand
Acme
color
Black
connectivity_technology
Wireless
date_first_available
March 4, 2025
item_model_number
AC-WH400
item_weight
8.8 ounces
manufacturer
Acme
product_dimensions
7.3 x 6.5 x 3.1 inches

observed 24 Sept 2026, 12:35 UTC

asin
string

ASIN that was observed (uppercased).

marketplace
string

Marketplace code.

url
string

Product URL on the marketplace.

observed_at
string (date-time)

When the observation was made, ISO 8601 in UTC.

status
string

ok — the observation was made; no_bsr — the product has no Best Sellers Rank; not_found — the product does not exist on this marketplace.

title
string· nullable

Product title.

byline
array of strings

Names listed for the product — usually its brand. Empty when none are available.

variant
string· nullable

Label of the selected variant — a colour, size, style or configuration. When several options are selected (colour and size), their labels are joined with , , for example Black, Large. null when the product has no variants.

variants
array of objects

Sibling variants of the product, each with name and asin — the selected one included. Empty when none are listed.

variants[].name
string

Label of the variant.

variants[].asin
string

ASIN of that variant.

price
object· nullable

Current price, or null when none is listed.

price.amount
number

Price in the marketplace currency.

price.currency
string

ISO 4217 currency code, for example USD.

bsr
object· nullable

Best Sellers Rank, or null when status is no_bsr or not_found.

bsr.rank
integer

The first rank the marketplace shows: the rank in the main category when bsr.scope is main.

bsr.category
string

Category of bsr.rank as the marketplace shows it, for example Electronics or Home & Kitchen.

bsr.scope
string· nullable

What bsr.rank is: main — the rank in the main category; subcategory — the marketplace shows no main-category rank for this product, so bsr.rank is its rank in a subcategory (and the first item of bsr.subcategories); store — a rank in a special store list rather than the main category; null — not known (an observation made before 2026-10-15).

bsr.subcategories
array of objects

Ranks in subcategories, each with rank and category.

rating
number· nullable

Average customer rating from 1.0 to 5.0.

ratings_count
integer· nullable

Number of customer ratings.

image_url
string· nullable

URL of the main product image.

details
object

Every label → value pair of the product's details (specifications) except the Best Sellers Rank and the customer rating, which are bsr, rating and ratings_count. Keys are the labels lower-cased, with every run of spaces and punctuation turned into _; they stay in the marketplace's language (item_weight on com, artikelgewicht on de, メーカー on jp) and are sorted. Values are the text as shown, trimmed, without invisible characters. At most 60 entries; a value longer than 500 characters is cut. {} when none are available.

details.<key>
string

One value as published, for example 8.8 ounces for item_weight.