BrowsableAmazon APIs
Amazon Products Batch API
Fetch up to 10 products by ASIN. Duplicate ASINs are fetched once. Partial batches include per-product errors; all-failed batches fail. Costs 10 credits. No Amazon sign-in required. Prices and availability reflect the marketplace and delivery location; unavailable fields are null.
POST
/v1/amazon/products/batchSend Authorization: Bearer YOUR_API_KEY. Get an API key →
Parameters
Send these fields in a flat JSON body. Add _run to choose execution options.
asinsarray<string>RequiredBetween 1 and 10 Amazon product ASINs. Each ASIN has 10 letters or digits. Errors are reported per product. Minimum items: 1. Maximum items: 10.
marketplacestringOptionalAmazon marketplace. Defaults to the product URL's marketplace, or amazon.com. Allowed: "amazon.com", "amazon.co.uk", "amazon.ca", "amazon.de", "amazon.fr", "amazon.it", "amazon.es", "amazon.co.jp", "amazon.in", "amazon.com.au".
postal_codestringOptionalDelivery postal code. The request fails if Amazon cannot apply it; responses include the displayed delivery location. Minimum length: 2. Maximum length: 16. Pattern: ^[a-zA-Z0-9][a-zA-Z0-9 -]+$.
Response
Every response describes a run. Read result once run_status is succeeded.
run_id- The run to track. Keep it when contacting support.
run_status- Queued, running, waiting for sign-in, succeeded, or failed. Check this even after an HTTP 200.
status_url- Poll this URL while the run is pending. Keep the same run instead of starting another request.
result- The endpoint’s returned data. The example is illustrative; actual fields may be empty or unavailable.
error- On failure, inspect its code, message, retryable and action fields.
View the complete output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"success",
"source",
"query",
"url",
"results",
"count",
"data",
"max_results_requested",
"pagination"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"data": {
"type": "object",
"required": [
"marketplace",
"delivery_location",
"requested",
"succeeded",
"failed",
"errors"
],
"properties": {
"errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"asin",
"code",
"message"
],
"properties": {
"asin": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"failed": {
"type": "integer",
"minimum": 0
},
"requested": {
"type": "integer",
"minimum": 0
},
"succeeded": {
"type": "integer",
"minimum": 0
},
"marketplace": {
"enum": [
"amazon.com",
"amazon.co.uk",
"amazon.ca",
"amazon.de",
"amazon.fr",
"amazon.it",
"amazon.es",
"amazon.co.jp",
"amazon.in",
"amazon.com.au"
],
"type": "string"
},
"delivery_location": {
"type": "object",
"required": [
"postal_code",
"applied",
"displayed"
],
"properties": {
"applied": {
"type": "boolean"
},
"displayed": {
"type": [
"string",
"null"
]
},
"postal_code": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"count": {
"type": "integer",
"minimum": 0
},
"query": {
"type": [
"string",
"null"
]
},
"source": {
"const": "amazon-products-batch"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"asin",
"url",
"title",
"description",
"price",
"price_amount",
"price_currency",
"availability",
"availability_text",
"rating",
"review_count",
"image_url",
"image_urls",
"details",
"marketplace",
"delivery_location"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"asin": {
"type": "string"
},
"price": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"rating": {
"type": [
"number",
"null"
]
},
"details": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"image_url": {
"type": [
"string",
"null"
]
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": [
"string",
"null"
]
},
"marketplace": {
"enum": [
"amazon.com",
"amazon.co.uk",
"amazon.ca",
"amazon.de",
"amazon.fr",
"amazon.it",
"amazon.es",
"amazon.co.jp",
"amazon.in",
"amazon.com.au"
],
"type": "string"
},
"availability": {
"type": [
"string",
"null"
]
},
"price_amount": {
"type": [
"string",
"null"
],
"description": "Decimal amount in the marketplace currency, without grouping separators; null when unavailable."
},
"review_count": {
"type": [
"integer",
"null"
]
},
"price_currency": {
"type": [
"string",
"null"
]
},
"availability_text": {
"type": [
"string",
"null"
]
},
"delivery_location": {
"type": "object",
"required": [
"postal_code",
"applied",
"displayed"
],
"properties": {
"applied": {
"type": "boolean"
},
"displayed": {
"type": [
"string",
"null"
]
},
"postal_code": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"success": {
"const": true
},
"pagination": {
"type": "object",
"required": [
"cursor",
"next_cursor",
"has_next_page",
"count",
"strategy"
],
"properties": {
"count": {
"type": "integer",
"minimum": 0
},
"cursor": {
"type": [
"string",
"null"
]
},
"strategy": {
"enum": [
"none",
"cursor"
],
"type": "string"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"has_next_page": {
"type": "boolean"
}
},
"additionalProperties": false
},
"max_results_requested": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
}View a polled run response
{
"run_id": "00000000-0000-4000-8000-000000000001",
"task_key": "amazon-products-batch",
"task_name": "Amazon Products Batch API",
"run_status": "succeeded",
"status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
"result": {
"url": "https://example.com/item-1",
"data": {
"errors": [
{
"asin": "sample",
"code": "sample",
"message": "sample"
}
],
"failed": 1,
"requested": 1,
"succeeded": 1,
"marketplace": "amazon.com",
"delivery_location": {
"applied": true,
"displayed": "sample",
"postal_code": "sample"
}
},
"count": 1,
"query": "London",
"source": "amazon-products-batch",
"results": [
{
"id": "id-1",
"url": "https://example.com/item-1",
"asin": "sample",
"price": "180",
"title": "Stylish Shoreditch Loft with Balcony",
"rating": 4.91,
"details": {},
"image_url": "https://example.com/item-1",
"image_urls": [
"https://images.example.com/image_urls-1.jpg"
],
"description": "Sample description 1",
"marketplace": "amazon.com",
"availability": "sample",
"price_amount": "180",
"review_count": 1,
"price_currency": "GBP",
"availability_text": "Sample availability_text 1",
"delivery_location": {
"applied": true,
"displayed": "sample",
"postal_code": "sample"
}
}
],
"success": true,
"pagination": {
"count": 1,
"cursor": "cursor-page-1",
"strategy": "none",
"next_cursor": "cursor-page-1",
"has_next_page": true
},
"max_results_requested": 1
},
"error": null
}Errors & retries
400Fix the fields listed inerrorsbefore retrying.428Connect the requested website account using the returned sign-in link.429Wait for the duration inRetry-After.5xxRetry transient failures with backoff. Keep the request ID.
A failed run has its own error inside the response. Retry it only when error.retryable is true.
More examples
Async request with polling
RUN=$(curl -s -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/amazon/products/batch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asins":["B0C3HCD34R","B085DV8T75"]}')
RUN_ID=$(echo "$RUN" | jq -er '.run_id // empty') || { echo "$RUN" >&2; exit 1; }
POLL_DELAY=3
while true; do
RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/$RUN_ID")
STATUS=$(echo "$RESULT" | jq -r '.run_status')
if [[ "$STATUS" =~ ^(succeeded|failed|errored|cancelled|canceled|expired)$ ]]; then
echo "$RESULT"
break
fi
sleep "$(awk "BEGIN { print $POLL_DELAY * (0.9 + ($RANDOM % 21) / 100) }")"
POLL_DELAY=$((POLL_DELAY < 30 ? POLL_DELAY * 2 : 30))
[ "$POLL_DELAY" -gt 30 ] && POLL_DELAY=30
doneWait-for-results request
curl -X POST "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/amazon/products/batch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"asins":["B0C3HCD34R","B085DV8T75"],"_run":{"async":false}}'Canonical & compatibility routes
You can also send the same JSON body to /v1/tasks/amazon-products-batch/runs.