# ASIN Data API

ASIN Data API provides detailed product data from Amazon, including price, rank, reviews, and more, enabling real-time insights for e-commerce professionals, marketers, and data analysts.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `ASIN_DATA_API`
- **Version:** 20260223_00

## Tools

### Clear multiple collection requests

**Slug:** `ASIN_DATA_API_CLEAR_COLLECTION_REQUESTS`

Delete multiple requests from a collection by their IDs using the bulk delete endpoint. Use this tool when you need to remove a selected set of request entries from an existing collection. Note: Requests can only be deleted when the collection is not running.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_ids` | array | Yes | Array of request ID strings to delete. Use LIST_COLLECTION_REQUESTS to get valid request IDs for a collection. |
| `collection_id` | string | Yes | Unique identifier of the collection to clear requests from. Use LIST_COLLECTIONS to get valid collection IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Destination

**Slug:** `ASIN_DATA_API_DELETE_DESTINATION`

Delete a destination from your account. Use this when you need to remove a destination that is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `destination_id` | string | Yes | The unique identifier of the destination to delete. Can be obtained from the List Destinations action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Collection Details

**Slug:** `ASIN_DATA_API_GET_COLLECTION`

Get details of a specific collection including status and request counts. Use when you need to check collection configuration, operational status, or aggregate statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique identifier of the collection to retrieve. Can be obtained from the List Collections action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Collection Requests

**Slug:** `ASIN_DATA_API_LIST_COLLECTION_REQUESTS`

List all requests in a Collection (paginated). Use to retrieve and paginate through all requests added to a specific collection. Returns up to 1000 requests per page with pagination info.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1). Each page returns up to 1000 requests. |
| `collection_id` | string | Yes | Unique identifier of the collection whose requests are to be listed. Can be obtained from the List Collections action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Destinations

**Slug:** `ASIN_DATA_API_LIST_DESTINATIONS`

List all destinations configured on your account. Use to retrieve and filter destination configurations for data export. Maximum 50 destinations allowed per account. Returns 10 destinations per page with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starts at 1). Each page returns up to 10 destinations. |
| `sort_by` | string ("type" | "name") | No | Sort criteria for destinations. |
| `search_term` | string | No | Filter destinations by name. Only destinations matching this search term will be returned. |
| `sort_direction` | string ("ascending" | "descending") | No | Sort order for destinations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Destination

**Slug:** `ASIN_DATA_API_UPDATE_DESTINATION`

Update an existing destination's configuration. Use to modify cloud storage settings, change the destination name, or enable/disable a destination. Only include fields you want to update.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the destination. |
| `enabled` | boolean | No | Whether the destination should be enabled (true) or disabled (false). |
| `oss_region_id` | string | No | Alibaba Cloud OSS region ID. |
| `destination_id` | string | Yes | The unique identifier of the destination to update. Can be obtained from List Destinations action. |
| `gcs_access_key` | string | No | Google Cloud Storage access key for GCS authentication. |
| `gcs_secret_key` | string | No | Google Cloud Storage secret key for GCS authentication. |
| `oss_access_key` | string | No | Alibaba Cloud OSS access key for OSS authentication. |
| `oss_secret_key` | string | No | Alibaba Cloud OSS secret key for OSS authentication. |
| `s3_bucket_name` | string | No | AWS S3 bucket name for S3-type destinations. |
| `s3_path_prefix` | string | No | Path prefix within the S3 bucket where files will be stored. |
| `gcs_bucket_name` | string | No | Google Cloud Storage bucket name for GCS-type destinations. |
| `gcs_path_prefix` | string | No | Path prefix within the GCS bucket. |
| `oss_bucket_name` | string | No | Alibaba Cloud OSS bucket name for OSS-type destinations. |
| `oss_path_prefix` | string | No | Path prefix within the OSS bucket. |
| `s3_access_key_id` | string | No | AWS access key ID for S3 authentication. |
| `azure_account_key` | string | No | Azure storage account key for Azure authentication. |
| `azure_path_prefix` | string | No | Path prefix within the Azure container. |
| `azure_account_name` | string | No | Azure storage account name for Azure-type destinations. |
| `azure_container_name` | string | No | Azure container name where files will be stored. |
| `s3_secret_access_key` | string | No | AWS secret access key for S3 authentication. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
