# Amazon Product Offer

## Overview

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

## Description

Efficiently extract details of third-party seller offers for any Amazon product across multiple marketplaces.

## 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/offer' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Offers for ASIN B093C9B1HK on amazon.fr

```json
{
  "results": [
    {
      "asin": "B093C9B1HK",
      "price": 16.21,
      "seller_url": "https://www.amazon.fr/Amazon-Offres-Reconditionnees/b?ie=UTF8&node=3581943031",
      "seller_name": "Amazon Seconde main",
      "delivery_info": {
        "time": "vendredi 23 mai",
        "type": "Livraison",
        "price": "GRATUITE"
      },
      "discount_percentage": 0
    },
    {
      "asin": "B093C9B1HK",
      "price": 19.99,
      "seller_url": "https://www.amazon.fr/gp/aag/main?ie=UTF8&seller=A1C2OJL0SJT92U&isAmazonFulfilled=1&asin=B093C9B1HK",
      "seller_name": "TwistedMarket",
      "delivery_info": {
        "time": "vendredi 23 mai",
        "type": "Livraison",
        "price": "GRATUITE"
      },
      "seller_rating": "Nouveau vendeur",
      "discount_percentage": 13
    },
    {
      "asin": "B093C9B1HK",
      "price": 22,
      "seller_url": "https://www.amazon.fr/gp/aag/main?ie=UTF8&seller=A3ET0BYK0UPCYZ&isAmazonFulfilled=0&asin=B093C9B1HK",
      "seller_name": "BINIMEKS",
      "delivery_info": {
        "time": "26 - 27 mai",
        "type": "Livraison",
        "price": "GRATUITE"
      },
      "seller_rating": "L'évaluation du vendeur est de 4 étoiles sur 5(13632 évaluations)81 % positif(s) au cours des 12 derniers mois",
      "discount_percentage": 4
    },
    {
      "asin": "B093C9B1HK",
      "price": 18.99,
      "seller_url": "https://www.amazon.fr/gp/aag/main?ie=UTF8&seller=A066248065M1IW1TJ2D&isAmazonFulfilled=0&asin=B093C9B1HK",
      "seller_name": "Conrad Electronic France",
      "delivery_info": {
        "time": "22 - 24 mai",
        "type": "Livraison",
        "price": "à 5,90 €"
      },
      "seller_rating": "L'évaluation du vendeur est de 4 étoiles sur 5(10679 évaluations)71 % positif(s) au cours des 12 derniers mois",
      "discount_percentage": 17
    }
  ]
}
```

## Documentation

## Overview
Retrieve the full list of third-party seller offers for any Amazon product by ASIN. Returns seller names, prices, delivery conditions, ratings, and discount percentages: across all supported Amazon marketplaces. Ideal for price comparison, seller benchmarking, and competitive intelligence workflows.

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

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Amazon product ASIN (e.g. `B093C9B1HK`) |
| `domain` | string | no | Amazon domain extension (default: `com`) |
| `page` | number | no | Page number for paginated results (default: `1`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].asin` | string | Amazon Standard Identification Number |
| `results[].price` | number | Seller's listed price |
| `results[].seller_url` | string | URL of the seller's Amazon storefront |
| `results[].seller_name` | string | Seller display name |
| `results[].seller_rating` | string | Text summary of seller rating and review count |
| `results[].discount_percentage` | number | Discount applied by the seller (0 if none) |
| `results[].delivery_info.time` | string | Estimated delivery window |
| `results[].delivery_info.type` | string | Delivery type label |
| `results[].delivery_info.price` | string | Delivery cost (e.g. "GRATUITE") |

## Notes
- Products sold exclusively by Amazon directly may return an empty results array.
- Use `domain` to switch between Amazon marketplaces (e.g. `fr`, `de`, `co.uk`).
- Use `page` to paginate through all available sellers for high-competition products.

## Main use cases
- Compare third-party seller prices for any Amazon product to identify the cheapest offer
- Monitor seller competition dynamics for a product and detect new entrants over time
- Build price alert systems by tracking offer prices across multiple Amazon domains
- Automate repricing decisions by pulling live seller data into pricing workflows