# Amazon Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/amazon/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/amazon-product |

## Description

Efficiently extract product details from Amazon for dynamic retail insights, including price, stock, features, and seller data.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/amazon/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup PlayStation 5 (ASIN B09DFCB66S) on amazon.com

```json
{
  "url": "https://www.amazon.com/dp/B09DFCB66S",
  "asin": "B09DFCB66S",
  "image": "https://m.media-amazon.com/images/I/51051FiD9UL._SX522_.jpg",
  "price": null,
  "stock": "Only 5 left in stock - order soon.",
  "title": "PlayStation PS5 HW 1115 STANDARD_US - PlayStation 5",
  "coupon": null,
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/51051FiD9UL._SX342_.jpg",
      "type": "main",
      "width": 167,
      "height": 342
    },
    {
      "url": "https://m.media-amazon.com/images/I/51051FiD9UL._SX522_.jpg",
      "type": "main",
      "width": 256,
      "height": 522
    }
  ],
  "currency": null,
  "features": [
    "Stunning Games - Marvel at incredible graphics and experience new PS5 features.",
    "Breathtaking Immersion - Discover a deeper gaming experience with support for haptic feedback, adaptive triggers, and 3D Audio technology.",
    "Lightning Speed - Harness the power of a custom CPU, GPU, and SSD with Integrated I/O that rewrite the rules of what a PlayStation console can do.",
    "Model Number CFI-1102A"
  ],
  "variants": [],
  "description": "The PS5 console unleashes new gaming possibilities that you never anticipated. Experience lightning fast loading with an ultra-high speed SSD, deeper immersion with support for haptic feedback, adaptive triggers, and 3D Audio, and an all-new generation of incredible PlayStation games.",
  "product_information": {
    "asin": "B09DFCB66S",
    "rated": "Rating Pending",
    "batteries": "1 Lithium Ion batteries required. (included)",
    "item_weight": "15.17 pounds",
    "manufacturer": "Sony",
    "release_date": "October 22, 2021",
    "type_of_item": "Video Game",
    "best_sellers_rank": [
      "#30,675 in Video Games (See Top 100 in Video Games)",
      "#95 in PlayStation 5 Consoles"
    ],
    "item_model_number": "Internacional",
    "product_dimensions": "18 x 18 x 12 inches; 15.17 Pounds",
    "date_first_available": "June 21, 2021"
  },
  "merchant_information": null
}
```

## Documentation

## Overview
Extract comprehensive product details from any Amazon listing using the product ASIN. Returns the title, price, stock status, images, product features, description, technical specifications, and customer review data: across all supported Amazon marketplaces.

## Quickstart
```
GET https://api.piloterr.com/v2/amazon/product?query=B09DFCB66S&domain=com
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Amazon product ASIN (e.g. `B09DFCB66S`) |
| `domain` | string | no | Amazon domain extension (default: `com`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `url` | string | Canonical Amazon product URL |
| `asin` | string | Amazon Standard Identification Number |
| `title` | string | Product title |
| `price` | number\|null | Listed price (null if unavailable) |
| `stock` | string | Stock availability message |
| `image` | string | Main product image URL |
| `features` | string[] | Key product features |
| `description` | string | Full product description |
| `product_information` | object | Technical specs, ratings, and manufacturer info |

## Notes
- Price may be `null` if the product has no active buy box or is out of stock.
- Use the `domain` parameter to retrieve product data from specific Amazon marketplaces.

## Main use cases
- Enrich product catalogs with live Amazon data (title, description, images, specs) for omnichannel workflows
- Track price and stock availability changes for products to trigger repricing or restocking alerts
- Build product comparison tools using structured Amazon data across multiple categories
- Extract customer review metadata (star rating, count) for product sentiment monitoring