Amazon data, ready when you are.
Products, search results and reviews from any Amazon marketplace.
- See the price before every call
- Pay only for records that come back
- No subscription. Your balance never expires
What you can get.
- $0.0014per recordTry it →
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.
- $0.00045per recordTry it →
Search
Keyword search on one marketplace. Every hit is a full product card with its search rank.
- $0.00045per recordTry it →
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.
What the data looks like.
| title | brand | price | currency | listPrice | discount | onDeal | prime | availability | rating | ratingsCount | reviewsCount | bestSellersRank | bsrCategory | soldBy | asin | productUrl | sellerId | browseNodeId | images | details |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sonora Buds Pro, Wireless Noise Cancelling Earbuds | Sonora | 79 | USD | 99 | 20% | true | true | In Stock | 4.4 | 2,310 | 640 | 412 | Electronics | Sonora Store | B062975243 | https://www.amazon.com/sonora-buds-pro-wireless-noise-cancellin-1000 | 224336018 | 3757554087 |
|
|
| Brewlab Cold Brew Coffee Maker, 1.5 L | Brewlab | 34.99 | USD | 34.99 | null | false | true | In Stock | 4.6 | 8,120 | 1,904 | 58 | Home & Kitchen | Brewlab | B030638468 | https://www.amazon.com/brewlab-cold-brew-coffee-maker-1-5-l-1001 | 4228393585 | 4135714401 |
|
|
| Northfold Linen Notebook, A5 | Northfold Studio | 14 | USD | 16 | 13% | false | false | Only 6 left in stock | 4.3 | 210 | 48 | 9,120 | Office Products | Northfold Studio | B002373275 | https://www.amazon.com/northfold-linen-notebook-a5-1002 | 1601836021 | 3182991214 |
|
|
For developers
API reference.
One endpoint, POST /v1/amazon. Open an operation to see its fields.
Productsproducts
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 | Type | Meaning |
|---|---|---|
| subjects * | list of string · 1-10 items | ASINs or product URLs. |
| marketplace | 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.com · in · co.uk · de · fr · it · es · ca · com.au · co.jp · com.mx · com.br |
Response fields, each row of data
| 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 |
Every field is present on every row: a value the source had nothing for is null, an empty list is []. 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.
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
[
{
"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": {}
}
]An example to show the shape. The rows show the most used fields; a live row carries every field in the table above.
Searchsearch
Keyword search on one marketplace. Every hit is a full product card with its search rank.
| Field | Type | Meaning |
|---|---|---|
| query * | string · ≤300 chars | |
| marketplace | 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.com · in · co.uk · de · fr · it · es · ca · com.au · co.jp · com.mx · com.br |
| limit | integer · 1-50 |
Response fields, each row of data
| 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 |
Every field is present on every row: a value the source had nothing for is null, an empty list is []. 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.
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
[
{
"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": {}
}
]Rows from an earlier run. The rows show the most used fields; a live row carries every field in the table above.
Reviewsreviews
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 | Type | Meaning |
|---|---|---|
| subjects * | list of string · 1-10 items | ASINs or product URLs. |
| marketplace | 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.com · in · co.uk · de · fr · it · es · ca · com.au · co.jp · com.mx · com.br |
| limit | integer · 1-100 |
Response fields, each row of data
| 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 |
Every field is present on every row: a value the source had nothing for is null, an empty list is []. 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.
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
[
{
"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": {}
}
]An example to show the shape. The rows show the most used fields; a live row carries every field in the table above.
Historyhistoryfree
The stored series for products already held. Free.
| Field | Type | Meaning |
|---|---|---|
| subjects * | list of string · 1-10 items | |
| marketplace | 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.com · in · co.uk · de · fr · it · es · ca · com.au · co.jp · com.mx · com.br |
| metric | enum | price · list_price · rating · ratings_count · best_sellers_rank · bought_past_month_min |
| days | integer · 1-730 |