Amazon Product API

Get a task result

The result of a product task posted with task_post.

GET

https://api.screamingdata.dev/v1/amazon/product/task_get/{id}

Authentication: API key (HTTP Basic)
Cost: Free
Body: No request body

Overview

Returns the product object produced by a task. The first call after the task finished marks it as collected, so it leaves tasks_ready; the result stays available for 30 days.

If the task has not finished yet, the task-level status is 40401 — retry later or use webhooks. If the product does not exist on the marketplace, the task-level status is 40402; if the lookup could not be completed, it is 50301. Failed tasks are not charged.

Cost

Free — the task was charged when it was posted.

Request

GET /v1/amazon/product/task_get/{id}.

Path parameters

id

string (uuid)required

Task id returned by task_post or tasks_ready.

Example09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1

Request example

The examples read your credentials from the API_LOGIN and API_KEY environment variables.

curl --request GET \
  --url "https://api.screamingdata.dev/v1/amazon/product/task_get/09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1" \
  --user "$API_LOGIN:$API_KEY"

import os

import requests

response = requests.get(
    "https://api.screamingdata.dev/v1/amazon/product/task_get/09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1",
    auth=(os.environ["API_LOGIN"], os.environ["API_KEY"]),
    timeout=30,
)
data = response.json()
print(data["status_code"], data["status_message"], "cost:", data["cost"])
for task in data["tasks"]:
    print(task["id"], task["status_code"], task["status_message"])

const auth = Buffer.from(`${process.env.API_LOGIN}:${process.env.API_KEY}`).toString("base64");

const response = await fetch("https://api.screamingdata.dev/v1/amazon/product/task_get/09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1", {
  headers: {
    Authorization: `Basic ${auth}`,
  },
});
const data = await response.json();
console.log(data.status_code, data.status_message, "cost:", data.cost);
for (const task of data.tasks) {
  console.log(task.id, task.status_code, task.status_message);
}

Response

HTTP 200. The body is the standard response envelope; check status_code at the top level and in every task.

Response example

{
  "version": "1.0.0",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0217 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0029 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v1",
        "amazon",
        "product",
        "task_get",
        "09241235-4e1c-4b6a-9d8f-2c7a51f0e3b1"
      ],
      "data": {
        "api": "amazon",
        "function": "product",
        "asin": "B0EXAMPLE1",
        "marketplace": "com",
        "priority": 1,
        "tag": "catalog-sync",
        "postback_url": "https://example.com/webhooks/postback"
      },
      "result": [
        {
          "asin": "B0EXAMPLE1",
          "marketplace": "com",
          "url": "https://www.amazon.com/dp/B0EXAMPLE1",
          "observed_at": "2026-09-24T12:35:41Z",
          "status": "ok",
          "title": "Acme Wireless Noise Cancelling Headphones, Black",
          "byline": [
            "Acme"
          ],
          "variant": "Black",
          "variants": [
            {
              "name": "Black",
              "asin": "B0EXAMPLE1"
            },
            {
              "name": "White",
              "asin": "B0EXAMPLE2"
            },
            {
              "name": "Navy Blue",
              "asin": "B0EXAMPLE3"
            }
          ],
          "price": {
            "amount": 59.99,
            "currency": "USD"
          },
          "bsr": {
            "rank": 1432,
            "category": "Electronics",
            "scope": "main",
            "subcategories": [
              {
                "rank": 12,
                "category": "Over-Ear Headphones"
              },
              {
                "rank": 31,
                "category": "Noise-Cancelling Headphones"
              }
            ]
          },
          "rating": 4.5,
          "ratings_count": 2318,
          "image_url": "https://m.media-amazon.com/images/I/example._AC_SL1500_.jpg",
          "details": {
            "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"
          }
        }
      ]
    }
  ]
}

Example: Task not ready yet (HTTP 200)

Task not ready yet

{
  "version": "1.0.0",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0104 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    {
      "id": "09241235-7a02-4f3e-8c11-5b9d0e6a4c27",
      "status_code": 40401,
      "status_message": "Task not ready yet.",
      "time": "0.0011 sec.",
      "cost": 0,
      "result_count": 0,
      "path": [
        "v1",
        "amazon",
        "product",
        "task_get",
        "09241235-7a02-4f3e-8c11-5b9d0e6a4c27"
      ],
      "data": {
        "api": "amazon",
        "function": "product",
        "asin": "B0EXAMPLE2",
        "marketplace": "uk",
        "priority": 2,
        "tag": "launch-watch",
        "pingback_url": "https://example.com/webhooks/pingback?id=$id&tag=$tag"
      },
      "result": null
    }
  ]
}

Result, rendered

The product object of the example above as an application would show it: identity, byline and variants, price, rank and rating, and every label → value pair of details.

B0EXAMPLE1·amazon.com

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

Result fields

Each element of tasks[].result is a 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.

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.

Status codes

Codes this endpoint can return, at the request or task level. See Status codes for handling advice.

Code	Message	HTTP	Level	When
20000	Ok.	200	Request / task	The request, or the individual task, was processed successfully.
40100	Authentication failed.	401	Request	The Authorization header is missing or malformed, or the login and API key do not match.
40101	API key revoked.	401	Request	The API key was revoked. Use another active key or create a new one.
40102	Account disabled.	401	Request	The account is disabled. Contact support.
40202	Rate limit exceeded.	429	Request	Too many requests or tasks per minute for this account, or too many access requests from one IP address. The Retry-After header says how many seconds to wait.
40400	Not Found.	404 / 200	Request / task	Unknown endpoint, or an unknown task, key or subscription id.
40401	Task not ready yet.	200	Task	task_get was called before the task completed. Retry later or use webhooks.
40402	Product not found on Amazon.	200	Task	The product does not exist on that marketplace. The task is not charged.
50000	Internal error.	500	Request	Unexpected server error. The request can be retried; contact support if it persists.
50301	Data temporarily unavailable. Try again later.	200	Task	The data source did not return a result (unavailable or too slow). The task is not charged: its cost is refunded automatically. Try again later.