Amazon Async API
Asynchronous callback variant of the Amazon Scrape API. Built for high-concurrency, enterprise-grade workloads with 100+ concurrent requests per account. Results are pushed to your callback URL.
API Description
This is the enterprise-grade asynchronous variant of Amazon Scrape API. Its core capabilities, pricing rules and response payload are identical to the synchronous endpoint — you only need to pass an additional callback URL (callbackUrl) to unlock 100+ high-concurrency scraping.
Limitation: Async mode only supports
format=json.rawHtmlandmarkdownare not available — use the Amazon Scrape API (Sync) for source files.
Key Advantages
- Enterprise-grade: built for massive data extraction, supports 100+ extreme concurrency.
- High reliability: queue-based async pipeline keeps large-batch requests stable and resilient.
- Zero migration cost: request parameters, pricing, and response payload are identical to Amazon Scrape API (Sync).
How to Use — Sync vs Async
| Dimension | Amazon Scrape API | Amazon Async API |
|---|---|---|
| Positioning | Standard synchronous endpoint (Sync) | Enterprise asynchronous endpoint (Async) |
| Best for | Low-latency, single-shot, low-concurrency calls | Massive data, 100+ high-concurrency, large-batch scraping |
| Core difference | callbackUrl is not required / not used in bizContext | callbackUrl is required in bizContext |
| Working mode | Client holds the connection and receives data directly in the response | Returns immediately as accepted; results are POSTed to your callback URL once scraping completes |
| Data structure | Returns the standard JSON payload | Identical to the synchronous endpoint |
| Supported formats | json / rawHtml / markdown | json only (no rawHtml / markdown) |
| Pricing | json (parsed fields): 1 credit / callrawHtml & markdown (source files): 0.75 credit / call | 1 credit / call (same as json) |
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Request Parameters
| Parameters | Required | Type | Description |
|---|---|---|---|
| url | Yes | string | Target URL Note: If omitted, site and content are required. |
| parserName | Yes | string | Choose a parsing template based on your business needs: |
| site | Yes | string | Site information Note: site is optional if url is provided. |
| content | Yes | string | The value of this parameter depends on |
| format | Yes | string | Data return format. Must be json in async mode (other values return a parameter error). |
| bizContext | Yes | object | Business context |
Business Context Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| callbackUrl | Yes | string | Async callback URL. When provided, the endpoint switches to async mode: it returns the taskId immediately, and once scraping and parsing complete, the result is pushed to this URL via HTTP POST. |
| zipcode | No | string | Amazon ZIPCode |
Callback Receiver Example (deploy your own)
A minimal HTTP service that listens on /callback and accepts the result we push. Your endpoint MUST return HTTP 2xx to acknowledge receipt; non-2xx triggers automatic retries.
Response value
| Return value | Type | Description |
|---|---|---|
| code | int | Status Code |
| message | string | Message |
| data | object | Returned data |
Return parameter data description
| Return value | Type | Description |
|---|---|---|
| json | string[] | Return JSON data |
| url | string | Task URL |
| taskId | string | Task ID |
Request example
Return example
Credit Consumption
- Async mode supports
format=jsononly. Pricing: 1 credit / request.

