Amazon Asin — AgentSky
Amazon Asin
Overview
Starts an asynchronous amazon asin request. Save the returned gateway run ID and supplier task ID and use the matching get operation to retrieve the result.
A task identifier and submission status.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| asin | string | Yes | Product ID. unique product identifier (ASIN) in Amazon. |
| location_name | string | No | Full name of search engine location. Required if you don't specify location_code or location_coordinate. |
| location_code | integer | No | Search engine location code. Required if you don't specify location_name or location_coordinate. |
| location_coordinate | string | No | GPS coordinates of a location. Required if you don't specify location_name or location_code. |
| language_name | string | No | Full name of search engine language. Required if you don't specify language_code. |
| language_code | string | No | Search engine language code. Required if you don't specify language_name. |
Requests up to 1 MB.
Example
Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.
# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
-d '{"provider":"dataforseo","endpoint":"amazon_asin_submit","input":{"language_code":"en_US","location_code":2840,"asin":"B0756FCPPN"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.
Pricing
— per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.