# Amazon API for agents

> API for Agents · https://apiforagents.dev/platforms/amazon · HTML twin: https://apiforagents.dev/platforms/amazon

Products, search results and reviews from any Amazon marketplace.

Endpoint: `POST https://apiforagents.dev/v1/amazon`. One op per call. Quote first with `"estimateOnly": true`.

## Prices (USD per record, pay as you go)

| Record | Per record |
|---|---|
| reviews | $0.00045 |
| products | $0.0014 |

## Operations

### products

Full product cards for up to ten products. Price, list price, deal and Prime flags, availability, rating and count, best-sellers rank, seller, specs, images, variants. By ASIN or product URL.

| Field | Required | Type | Meaning |
|---|---|---|---|
| subjects | yes | list of string (1-10 items) | ASINs or product URLs. |
| marketplace | no | enum | The Amazon site as its domain suffix ,  "com", "in", "co.uk", "de"… A product URL carries its own and overrides this; a bare ASIN and a search use it. Prices, stock and reviews differ per site. Values: com, in, co.uk, de, fr, it, es, ca, com.au, co.jp, com.mx, com.br. |

Response fields (each row of data; every field present, null when the source had nothing):

| Field | Type |
|---|---|
| asin | string |
| marketplace | string |
| title | string |
| brand | string |
| productUrl | string |
| price | number |
| currency | string |
| listPrice | number |
| discount | string |
| onDeal | boolean |
| prime | boolean |
| availability | string |
| rating | number |
| ratingsCount | integer |
| reviewsCount | integer |
| ratingBreakdown | any |
| boughtPastMonth | string |
| boughtPastMonthMin | integer |
| bestSellersRank | integer |
| bsrCategory | string |
| soldBy | string |
| fulfilledBy | string |
| sellerId | string |
| usedOffer | any |
| features | list of string |
| description | string |
| categoryPath | string |
| browseNodeId | string |
| productDetails | any |
| keySpecs | any |
| bookEditions | any |
| variants | any |
| mainImage | string |
| images | list of string |
| videos | list of string |
| reviewSummary | string |
| reviewTopics | any |
| details | object |

`details` is always the last field: everything else the source sent for that row, under our own field names. Its keys depend on the source that answered, so read them defensively; it is `{}` when there is nothing more.

Example request:

```bash
curl -X POST https://apiforagents.dev/v1/amazon \
  -H "Authorization: Bearer $AFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"products","subjects":["B0DGHMNQ5Z"],"marketplace":"com"}'
```

Example response rows (made-up names, real field names; a live row carries every field above):

```json
[
  {
    "title": "Sonora Buds Pro, Wireless Noise Cancelling Earbuds",
    "brand": "Sonora",
    "price": 79,
    "currency": "USD",
    "listPrice": 99,
    "discount": "20%",
    "onDeal": true,
    "prime": true,
    "availability": "In Stock",
    "rating": 4.4,
    "ratingsCount": 2310,
    "reviewsCount": 640,
    "bestSellersRank": 412,
    "bsrCategory": "Electronics",
    "soldBy": "Sonora Store",
    "asin": "B062975243",
    "productUrl": "https://www.amazon.com/sonora-buds-pro-wireless-noise-cancellin-1000",
    "sellerId": "224336018",
    "browseNodeId": "3757554087",
    "images": [
      "https://img.amazon.com/sonora-buds-pro-wireless-noise-cancellin.jpg"
    ],
    "details": {}
  },
  {
    "title": "Brewlab Cold Brew Coffee Maker, 1.5 L",
    "brand": "Brewlab",
    "price": 34.99,
    "currency": "USD",
    "listPrice": 34.99,
    "discount": null,
    "onDeal": false,
    "prime": true,
    "availability": "In Stock",
    "rating": 4.6,
    "ratingsCount": 8120,
    "reviewsCount": 1904,
    "bestSellersRank": 58,
    "bsrCategory": "Home & Kitchen",
    "soldBy": "Brewlab",
    "asin": "B030638468",
    "productUrl": "https://www.amazon.com/brewlab-cold-brew-coffee-maker-1-5-l-1001",
    "sellerId": "4228393585",
    "browseNodeId": "4135714401",
    "images": [
      "https://img.amazon.com/brewlab-cold-brew-coffee-maker-1-5-l.jpg"
    ],
    "details": {}
  }
]
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=amazon&op=products (sign in first).

### search

Keyword search on one marketplace. Every hit is a full product card with its search rank.

| Field | Required | Type | Meaning |
|---|---|---|---|
| query | yes | string (≤300 chars) |  |
| marketplace | no | enum | The Amazon site as its domain suffix ,  "com", "in", "co.uk", "de"… A product URL carries its own and overrides this; a bare ASIN and a search use it. Prices, stock and reviews differ per site. Values: com, in, co.uk, de, fr, it, es, ca, com.au, co.jp, com.mx, com.br. |
| limit | no | integer (1-50) |  |

Response fields (each row of data; every field present, null when the source had nothing):

| Field | Type |
|---|---|
| asin | string |
| marketplace | string |
| title | string |
| brand | string |
| productUrl | string |
| price | number |
| currency | string |
| listPrice | number |
| discount | string |
| onDeal | boolean |
| prime | boolean |
| availability | string |
| rating | number |
| ratingsCount | integer |
| reviewsCount | integer |
| ratingBreakdown | any |
| boughtPastMonth | string |
| boughtPastMonthMin | integer |
| bestSellersRank | integer |
| bsrCategory | string |
| soldBy | string |
| fulfilledBy | string |
| sellerId | string |
| usedOffer | any |
| features | list of string |
| description | string |
| categoryPath | string |
| browseNodeId | string |
| productDetails | any |
| keySpecs | any |
| bookEditions | any |
| variants | any |
| mainImage | string |
| images | list of string |
| videos | list of string |
| reviewSummary | string |
| reviewTopics | any |
| details | object |

`details` is always the last field: everything else the source sent for that row, under our own field names. Its keys depend on the source that answered, so read them defensively; it is `{}` when there is nothing more.

Example request:

```bash
curl -X POST https://apiforagents.dev/v1/amazon \
  -H "Authorization: Bearer $AFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"search","query":"wireless earbuds","marketplace":"com","limit":10}'
```

Example response rows (real rows, business data; a live row carries every field above):

```json
[
  {
    "asin": "B0DGHMNQ5Z",
    "marketplace": "com",
    "title": "Apple AirPods 4 Wireless Earbuds",
    "brand": "Apple",
    "productUrl": "https://www.amazon.com/dp/B0DGHMNQ5Z",
    "price": 99,
    "currency": "USD",
    "listPrice": 129,
    "discount": "-23%",
    "onDeal": false,
    "prime": false,
    "availability": "In Stock",
    "rating": 4.5,
    "ratingsCount": 34347,
    "boughtPastMonth": "10K+ bought in past month",
    "boughtPastMonthMin": 10000,
    "bestSellersRank": null,
    "bsrCategory": null,
    "soldBy": "Amazon.com",
    "fulfilledBy": "Amazon.com",
    "sellerId": null,
    "usedOffer": {
      "price": 94.05,
      "soldBy": "Amazon Resale",
      "condition": "Used - Like New",
      "packageCondition": "Moderate cosmetic damage observed during inspection. Minor packaging damage observed during inspection."
    },
    "features": [
      "REBUILT FOR COMFORT - AirPods 4 have been redesigned for exceptional all-day comfort and greater stability. With a refined contour, shorter stem, and quick-press controls for music or calls.",
      "PERSONALIZED SPATIAL AUDIO - Personalized Spatial Audio with dynamic head tracking places sound all around you, creating a theater-like listening experience for music, TV shows, movies, games, and more.*",
      "IMPROVED SOUND AND CALL QUALITY - AirPods 4 feature the Apple-designed H2 chip. Voice Isolation improves the quality of phone calls in loud conditions. Using advanced computational audio, it reduces background noise while isolating and clarifying the sound of your voice for whomever you’re speaking to.*",
      "MAGICAL EXPERIENCE - Just say “Siri” or “Hey Siri” to play a song, make a call, or check your schedule.* And with Siri Interactions, now you can respond to Siri by simply nodding your head yes or shaking your head no.* Pair AirPods 4 by simply placing them near your device and tapping Connect on your screen.* Easily share a song or show between two sets of AirPods.* An optical in-ear sensor knows to play audio only when you’re wearing AirPods and pauses when you take them off. And you can track down your AirPods and Charging Case with the Find My app.*",
      "LONG BATTERY LIFE - Get up to 5 hours of listening time on a single charge. And get up to 30 hours of total listening time using the case.*",
      "REDESIGNED CASE - The Charging Case comes with USB-C charging capabilities and is more than 10 percent smaller by volume than the previous generation.*",
      "DUST, SWEAT, AND WATER RESISTANT - AirPods 4 and the Charging Case are rated IP54 dust, sweat, and water resistant, so they’ll withstand rain and heavy workouts.*",
      "LEGAL DISCLAIMERS - This is a summary of the main product features. See below to learn more."
    ],
    "description": null,
    "categoryPath": null,
    "browseNodeId": null,
    "productDetails": [
      {
        "name": "Product Dimensions",
        "value": "‎3.25 x 3.25 x 1.5 inches"
      },
      {
        "name": "Item Weight",
        "value": "‎1.6 ounces"
      },
      {
        "name": "Manufacturer",
        "value": "‎Apple"
      },
      {
        "name": "ASIN",
        "value": "‎B0DGHMNQ5Z"
      },
      {
        "name": "Item model number",
        "value": "‎MXP63LL/A"
      },
      {
        "name": "Batteries",
        "value": "‎3 Lithium Ion batteries required. (included)"
      },
      {
        "name": "Date First Available",
        "value": "‎September 9, 2024"
      },
      {
        "name": "Item Weight",
        "value": "‎1.6 ounces"
      },
      {
        "name": "Units",
        "value": "‎1 Count"
      },
      {
        "name": "Number Of Items",
        "value": "‎1"
      }
    ],
    "keySpecs": [
      {
        "name": "Brand",
        "value": "Apple"
      },
      {
        "name": "Color",
        "value": "White"
      },
      {
        "name": "Ear Placement",
        "value": "In Ear"
      },
      {
        "name": "Form Factor",
        "value": "In Ear"
      },
      {
        "name": "Noise Control",
        "value": "Sound Isolation"
      }
    ],
    "variants": [
      {
        "asin": "B0DGHMNQ5Z",
        "value": "Without Active Noise Cancellation",
        "imageUrl": null,
        "selected": true,
        "available": true,
        "dimension": "style_name"
      },
      {
        "asin": "B0DGJ7HYG1",
        "value": "With Active Noise Cancellation",
        "imageUrl": null,
        "selected": false,
        "available": true,
        "dimension": "style_name"
      },
      {
        "asin": "B0DGHMNQ5Z",
        "value": "Without AppleCare+",
        "imageUrl": null,
        "selected": true,
        "available": true,
        "dimension": "configuration"
      },
      {
        "asin": "B0DGW54P27",
        "value": "With AppleCare+ (2 Years)",
        "imageUrl": null,
        "selected": false,
        "available": true,
        "dimension": "configuration"
      }
    ],
    "mainImage": "https://m.media-amazon.com/images/I/61iBtxCUabL._AC_SL1500_.jpg",
    "images": [
      "https://m.media-amazon.com/images/I/61iBtxCUabL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/51ppBwqC4xL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/71c1ABI5GAL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/61E7pA3mgcL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/715J6Hx8xyL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/61l+yD0pXXL._AC_SL1500_.jpg"
    ],
    "videos": [
      "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/6c3055e8-b5b0-47ef-b4e7-41434b936140/default.jobtemplate.hls.m3u8",
      "https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-us-east-1-prod/5f412838-9f13-4205-b380-ff69c70948bb/default.jobtemplate.hls.m3u8"
    ],
    "reviewSummary": "Customers find these wireless earbuds to be well-made and appreciate their sound quality, describing them as loud and clear. The fit receives mixed feedback - while some say they fit comfortably, others report they don't stay in their ears. Customers disagree on the value for money, with some considering them well worth the investment while others find them not worth the cost. Reliability, battery life, connectivity, and durability are also mixed aspects, with some customers reporting good performance and long-lasting battery life, while others experience issues with connectivity and premature failure within three months of use.",
    "reviewTopics": [
      {
        "topic": "Quality",
        "summary": "Customers find these wireless earbuds to be of good quality and exactly as described.",
        "mentions": 759,
        "negative": 675,
        "positive": 84,
        "sentiment": "POSITIVE"
      },
      {
        "topic": "Sound quality",
        "summary": "Customers love the sound quality of these wireless earbuds, finding them loud and clear, with one customer specifically mentioning crisp highs.",
        "mentions": 590,
        "negative": 335,
        "positive": 255,
        "sentiment": "POSITIVE"
      },
      {
        "topic": "Fit",
        "summary": "Customers have mixed experiences with how the earbuds sit in their ears, with some finding them comfortable and secure while others report they don't stay in place and fall out frequently.",
        "mentions": 246,
        "negative": 825,
        "positive": 421,
        "sentiment": "MIXED"
      },
      {
        "topic": "Value for money",
        "summary": "Customers have mixed opinions about the headphones' value for money, with some finding them well worth the investment while others consider them a complete waste of money.",
        "mentions": 123,
        "negative": 392,
        "positive": 731,
        "sentiment": "MIXED"
      },
      {
        "topic": "Reliability",
        "summary": "Customers have mixed experiences with the reliability of these earbuds, with some reporting they work great and have no problems, while others mention issues with the left bud stopping working and one ear not functioning properly.",
        "mentions": 25,
        "negative": 315,
        "positive": 710,
        "sentiment": "MIXED"
      },
      {
        "topic": "Battery life",
        "summary": "Customers have mixed experiences with the battery life of these earbuds: while some report that the charge lasts a long time and recharges quickly, others mention that the case doesn't hold a charge.",
        "mentions": 818,
        "negative": 380,
        "positive": 438,
        "sentiment": "MIXED"
      },
      {
        "topic": "Connectivity",
        "summary": "Customers have mixed experiences with the earbuds' connectivity: while some report seamless Bluetooth pairing and quick iPhone connection, others mention issues with disconnection and pairing problems.",
        "mentions": 553,
        "negative": 193,
        "positive": 360,
        "sentiment": "MIXED"
      },
      {
        "topic": "Durability",
        "summary": "Customers have mixed experiences with the durability of these earbuds, with some reporting they last through daily use and hours longer than expected, while others mention they stopped working within three months or died after a month of use.",
        "mentions": 471,
        "negative": 293,
        "positive": 178,
        "sentiment": "MIXED"
      }
    ],
    "details": {}
  },
  {
    "asin": "B0BJQWYLYN",
    "marketplace": "com",
    "title": "Apple AirPods Pro (2nd Generation) (Renewed)",
    "brand": "Apple",
    "productUrl": "https://www.amazon.com/dp/B0BJQWYLYN",
    "price": 146.9,
    "currency": "USD",
    "listPrice": 249,
    "discount": "-41%",
    "onDeal": false,
    "prime": false,
    "availability": "In Stock",
    "rating": 4,
    "ratingsCount": 3302,
    "boughtPastMonth": "1K+ bought in past month",
    "boughtPastMonthMin": 1000,
    "bestSellersRank": 65,
    "bsrCategory": "Amazon Renewed",
    "soldBy": "EcoBytez",
    "fulfilledBy": "Amazon",
    "sellerId": "A36UZVYSKR2ZI5",
    "usedOffer": null,
    "features": [
      "Active Noise Cancellation reduces unwanted background noise",
      "Adaptive Transparency lets outside sounds in while reducing loud environmental noise",
      "Personalized Spatial Audio with dynamic head tracking places sound all around you",
      "Multiple ear tips (XS, S, M, L)",
      "Touch control lets you swipe to adjust volume, press to direct media playback, answer or end calls, and press and hold to switch between listening modes"
    ],
    "description": "Apple AirPods Pro (2nd Generation) (Renewed)",
    "categoryPath": "Electronics > Headphones, Earbuds & Accessories > Headphones & Earbuds > Earbud Headphones",
    "browseNodeId": "12097478011",
    "productDetails": [
      {
        "name": "Brand Name",
        "value": "Apple"
      },
      {
        "name": "Model Number",
        "value": "A2931"
      },
      {
        "name": "Model Name",
        "value": "AirPods Pro"
      },
      {
        "name": "Built-In Media",
        "value": "Charging Station"
      },
      {
        "name": "Age Range Description",
        "value": "Adult"
      },
      {
        "name": "Warranty Description",
        "value": "90 days limited warranty"
      },
      {
        "name": "Customer Package Type",
        "value": "Standard Amazon Packaging"
      },
      {
        "name": "Number of Items",
        "value": "1"
      },
      {
        "name": "Series Number",
        "value": "2"
      },
      {
        "name": "UPC",
        "value": "657768136146"
      },
      {
        "name": "Manufacturer",
        "value": "Apple Computer"
      },
      {
        "name": "ASIN",
        "value": "B0BJQWYLYN"
      },
      {
        "name": "Customer Reviews",
        "value": "4.0 out of 5 stars (3,302)"
      },
      {
        "name": "Headphone Jack",
        "value": "lightning"
      },
      {
        "name": "Connectivity Technology",
        "value": "Wireless"
      },
      {
        "name": "Wireless Technology",
        "value": "Apple H2 Chip, Bluetooth, NFC, Wireless"
      },
      {
        "name": "Bluetooth Version",
        "value": "5.1"
      },
      {
        "name": "Control Type",
        "value": "Touch Control"
      },
      {
        "name": "Control Method",
        "value": "Touch"
      },
      {
        "name": "Controller Type",
        "value": "Siri"
      },
      {
        "name": "Impedance",
        "value": "16 ohm"
      },
      {
        "name": "Noise Control",
        "value": "None"
      },
      {
        "name": "Audio Driver Type",
        "value": "Dynamic Driver"
      },
      {
        "name": "Audio Latency",
        "value": "16 milliseconds"
      },
      {
        "name": "Audio Driver Size",
        "value": "30 millimeters"
      },
      {
        "name": "Enclosure Material",
        "value": "Silicone"
      },
      {
        "name": "Specific Uses For Product",
        "value": "Music"
      },
      {
        "name": "Antenna Location",
        "value": "Calling"
      },
      {
        "name": "Compatible Devices",
        "value": "Cellphones"
      },
      {
        "name": "Cable Features",
        "value": "Retractable"
      },
      {
        "name": "Water Resistance Level",
        "value": "Water Resistant"
      },
      {
        "name": "Additional Features",
        "value": "iOS Phone Control, Water-Resistant, Fast Charging, Microphone included, sweatproof, Volume Control, Sports & Exercise, Lightweight, Wireless,"
      },
      {
        "name": "Number of Power Levels",
        "value": "7"
      },
      {
        "name": "Total USB 2.0 Ports",
        "value": "1"
      },
      {
        "name": "Headphones Ear Placement",
        "value": "In Ear"
      },
      {
        "name": "Headphone Folding Features",
        "value": "semi-open-back"
      },
      {
        "name": "Earpiece Shape",
        "value": "Bud"
      },
      {
        "name": "Color",
        "value": "White"
      },
      {
        "name": "Item Weight",
        "value": "5.67 g"
      },
      {
        "name": "Battery Average Life",
        "value": "6 hours"
      }
    ],
    "keySpecs": [
      {
        "name": "Brand",
        "value": "Apple"
      },
      {
        "name": "Color",
        "value": "White"
      },
      {
        "name": "Ear Placement",
        "value": "In Ear"
      },
      {
        "name": "Form Factor",
        "value": "semi-open-back"
      },
      {
        "name": "Impedance",
        "value": "16 ohm"
      }
    ],
    "variants": null,
    "mainImage": "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg",
    "images": [
      "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/61sRKTAfrhL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/51emillNpWL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/51+vJkbGtJL._AC_SL1500_.jpg",
      "https://m.media-amazon.com/images/I/51s3yLTjWSL._AC_SL1500_.jpg"
    ],
    "videos": [],
    "reviewSummary": "Customers find these headphones excellent in quality, with great sound and awesome noise cancellation. The functionality and value for money receive mixed reviews - while some say they work well and offer good value, others report issues with connectivity and consider them a waste of money. The battery life is also mixed, with some praising its amazing performance while others report it won't charge after three months. The condition of the headphones is mixed, with some arriving like new while others show scratches.",
    "reviewTopics": [
      {
        "topic": "Quality",
        "summary": "Customers find these headphones to be excellent, with multiple customers expressing their satisfaction and willingness to recommend them.",
        "mentions": 239,
        "negative": 62,
        "positive": 177,
        "sentiment": "POSITIVE"
      },
      {
        "topic": "Sound quality",
        "summary": "Customers are satisfied with the sound quality of these headphones.",
        "mentions": 96,
        "negative": 23,
        "positive": 73,
        "sentiment": "POSITIVE"
      },
      {
        "topic": "Noise cancellation",
        "summary": "Customers appreciate the noise cancellation features of these earbuds, with one customer noting that the transparency and noise canceling modes exceed expectations, and another mentioning that they automatically close to block wind noise.",
        "mentions": 50,
        "negative": 11,
        "positive": 39,
        "sentiment": "POSITIVE"
      },
      {
        "topic": "Functionality",
        "summary": "Customers have mixed experiences with the functionality of these headphones, with some reporting that they work great and all features operate seamlessly, while others mention that one AirPod stopped working.",
        "mentions": 159,
        "negative": 56,
        "positive": 103,
        "sentiment": "MIXED"
      },
      {
        "topic": "Value for money",
        "summary": "Customers have mixed opinions about the headphones' value for money, with some finding them a great product for the price while others warn not to buy them.",
        "mentions": 101,
        "negative": 31,
        "positive": 70,
        "sentiment": "MIXED"
      },
      {
        "topic": "Battery life",
        "summary": "Customers have mixed experiences with the battery life of these earbuds, with some praising its amazing performance while others report that they won't charge after three months and don't last all day.",
        "mentions": 67,
        "negative": 44,
        "positive": 23,
        "sentiment": "MIXED"
      },
      {
        "topic": "Condition",
        "summary": "Customers have mixed experiences with the condition of the headphones, with some reporting they arrived like new and in perfect condition, while others mention scratches and signs of wear.",
        "mentions": 46,
        "negative": 25,
        "positive": 21,
        "sentiment": "MIXED"
      },
      {
        "topic": "Connectivity",
        "summary": "Customers report significant connectivity issues with these earbuds, noting that they won't connect to their devices, won't stay paired with phones, and the left AirPod specifically has connection problems.",
        "mentions": 71,
        "negative": 51,
        "positive": 20,
        "sentiment": "NEGATIVE"
      }
    ],
    "details": {}
  }
]
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=amazon&op=search (sign in first).

### reviews

Customer reviews for up to ten products. Text, rating, date, verified-purchase and Vine flags, helpful votes, variant, media. Amazon caps at 100 per product.

| Field | Required | Type | Meaning |
|---|---|---|---|
| subjects | yes | list of string (1-10 items) | ASINs or product URLs. |
| marketplace | no | enum | The Amazon site as its domain suffix ,  "com", "in", "co.uk", "de"… A product URL carries its own and overrides this; a bare ASIN and a search use it. Prices, stock and reviews differ per site. Values: com, in, co.uk, de, fr, it, es, ca, com.au, co.jp, com.mx, com.br. |
| limit | no | integer (1-100) |  |

Response fields (each row of data; every field present, null when the source had nothing):

| Field | Type |
|---|---|
| reviewId | string |
| reviewTitle | string |
| reviewText | string |
| rating | number |
| posted | string |
| reviewer | string |
| reviewerUrl | string |
| verifiedPurchase | boolean |
| amazonVine | boolean |
| helpfulVotes | integer |
| language | string |
| variant | list of string |
| variantAsin | string |
| images | list of string |
| videos | list of string |
| mediaType | string |
| reviewUrl | string |
| country | string |
| details | object |

`details` is always the last field: everything else the source sent for that row, under our own field names. Its keys depend on the source that answered, so read them defensively; it is `{}` when there is nothing more.

Example request:

```bash
curl -X POST https://apiforagents.dev/v1/amazon \
  -H "Authorization: Bearer $AFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"reviews","subjects":["B0DGHMNQ5Z"],"marketplace":"com","limit":50}'
```

Example response rows (made-up names, real field names; a live row carries every field above):

```json
[
  {
    "reviewTitle": "Great sound for the price",
    "reviewText": "Clear calls, solid bass, case fits in a pocket.",
    "rating": 5,
    "posted": "2026-09-28",
    "reviewer": "Dana P.",
    "verifiedPurchase": true,
    "helpfulVotes": 214,
    "country": "United States",
    "reviewId": "1992978764",
    "reviewerUrl": "https://www.amazon.com/great-sound-for-the-price-1000",
    "images": [
      "https://img.amazon.com/great-sound-for-the-price.jpg"
    ],
    "reviewUrl": "https://www.amazon.com/great-sound-for-the-price-1000",
    "details": {}
  },
  {
    "reviewTitle": "Battery could be better",
    "reviewText": "About 4 hours with noise cancelling on.",
    "rating": 3,
    "posted": "2026-10-02",
    "reviewer": "Chris M.",
    "verifiedPurchase": true,
    "helpfulVotes": 86,
    "country": "United States",
    "reviewId": "570880587",
    "reviewerUrl": "https://www.amazon.com/battery-could-be-better-1001",
    "images": [
      "https://img.amazon.com/battery-could-be-better.jpg"
    ],
    "reviewUrl": "https://www.amazon.com/battery-could-be-better-1001",
    "details": {}
  }
]
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=amazon&op=reviews (sign in first).

### history (free)

The stored series for products already held. Free.

| Field | Required | Type | Meaning |
|---|---|---|---|
| subjects | yes | list of string (1-10 items) |  |
| marketplace | no | enum | The Amazon site as its domain suffix ,  "com", "in", "co.uk", "de"… A product URL carries its own and overrides this; a bare ASIN and a search use it. Prices, stock and reviews differ per site. Values: com, in, co.uk, de, fr, it, es, ca, com.au, co.jp, com.mx, com.br. |
| metric | no | enum |  Values: price, list_price, rating, ratings_count, best_sellers_rank, bought_past_month_min. |
| days | no | integer (1-730) |  |

Request shape:

```json
{
  "op": "history",
  "subjects": [
    "example"
  ]
}
```

Try it in the playground: https://apiforagents.dev/dashboard/run?platform=amazon&op=history (sign in first).

## Notes for the agent

Measured Amazon product data, one operation per call. Products are named by ASIN or by any amazon.<marketplace> product URL; a URL carries its own marketplace, a bare ASIN takes the call's (default com). Prices are per marketplace and every fetch adds a point to that product's price history. ops: products (full cards for up to ten ASINs/URLs. Price, list price, deal and Prime flags, availability, rating and count, best-sellers rank, seller, specs, variants, images), search (keyword search on one marketplace, full cards with rank), reviews (customer reviews for up to ten products. Text, rating, date, verified-purchase and Vine flags, helpful votes, variant), history (stored price/rating/rank series for products already held, free). Ops are independent. Issue several as PARALLEL tool calls. Fresh fetches are charged per record; your own answer is free while fresh.
