# 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.

```bash
# 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.

## Questions

### What does Amazon Asin do?

### What does Amazon Asin take?

### What are the limits on Amazon Asin?

### How do I retry safely and check the final charge?
