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 the page lists.

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. Any field that cannot be read reliably 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 · parser 2026.09.2

asin
string

ASIN that was observed (uppercased).

marketplace
string

Marketplace code.

url
string

Product page URL on the marketplace.

observed_at
string (date-time)

When the product page was read, ISO 8601 in UTC.

status
string

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

title
string· nullable

Product title as shown on the page.

byline
array of strings

Names shown under the title, in page order — usually the brand of the product, from its "Visit the … Store" or "Brand: …" line. Empty when the page shows none or they could not be read.

variant
string· nullable

Label of the selected variant as the page shows it — 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 page offers no variants.

variants
array of objects

Sibling variants listed on the page, each with name and asin — the selected one included. Empty when the page lists none.

variants[].name
string

Label of the variant as the page shows it.

variants[].asin
string

ASIN of that variant.

price
object· nullable

Current price, or null when the page shows none.

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

Rank in the main category.

bsr.category
string

Main category as the marketplace shows it, for example Electronics or Home & Kitchen.

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 page's product details — the details list and the product-information, technical-details, overview and product-facts tables — 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 nothing could be read.

details.<key>
string

One value as the page shows it, for example 8.8 ounces for item_weight.

parser_version
string

Version of the parser that produced this object.