Amazon
Amazon.com product search, category listings and product pages, and customer reviews by product, filtered by star rating and sorted top or most recent.
Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.
- Site:
amazon - Version:
1.3.0 - Reads from:
amazon.com
| Action | Description | Listed price |
|---|---|---|
search | Search amazon.com by keyword, optionally within a category, up to 48 products a page in Amazon's order: ASIN, title, brand, price and list price, rating, rating count, purchase volume, sponsored flag, badges and image. | Billed per request at your plan's rates |
category | List an amazon.com category's products by browse node, up to 24 a page, by relevance, price, rating, newest or best selling: ASIN, title, brand, price and list price, rating, rating count, purchase volume, sponsored flag, badges and image. | Billed per request at your plan's rates |
product | Read amazon.com product pages by ASIN: title, brand, price and list price, availability, rating, rating count, the share of ratings at each star level, Amazon's review summary, purchase volume, category breadcrumb, bullet points and image. | Billed per request at your plan's rates |
reviews | Read an amazon.com product's customer reviews, top or most recent first, optionally one star rating or verified purchases only: title, text, rating, author, date, country, helpful votes, verified and Vine flags, and image and video URLs. Each star filter and sort order reaches its first 10 reviews; coverage max reads all ten of them and returns the deduplicated union, the most reviews available for a product. | Billed per request at your plan's rates |
search
Search amazon.com by keyword, optionally within a category, up to 48 products a page in Amazon's order: ASIN, title, brand, price and list price, rating, rating count, purchase volume, sponsored flag, badges and image.
POST https://request.usestring.ai/v1/integrations/amazon/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. What to search amazon.com for, such as nike running shoes. At least 1 character. |
category | string | Only results in this category: an Amazon browse node id, such as 679286011, or an amazon.com category or search URL carrying one. |
sort | relevance price-asc price-desc rating newest bestselling | relevance (the default), price-asc, price-desc, rating, newest or bestselling. |
pages | integer | How many result pages to read, from 1. A search page holds up to 48 products; Amazon serves about 7 pages of a keyword search. From 1 to 20. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
asin | string | — |
position | integer | The product's position across the pages read, from 1. |
page | integer | The results page the product was on, from 1. |
title | string | null | — |
brand | string | null | The brand, when the result shows it apart from the title, as fashion results do. |
url | string | The product's amazon.com page. |
imageUrl | string | null | — |
price | number | null | The price shown, in currency. |
listPrice | number | null | The struck-through list or typical price, when one is shown. |
currency | string | null | The price's ISO currency code, such as USD. |
rating | number | null | Average star rating, out of 5. |
ratingCount | integer | null | How many customer ratings the product has. |
boughtPastMonth | string | null | Amazon's purchase-volume label, such as 1K+ bought in past month. |
isSponsored | boolean | The result is a sponsored placement. |
badges | string[] | Badges on the result, such as Best Seller or Amazon's Choice. |
Example
curl https://request.usestring.ai/v1/integrations/amazon/search \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "nike running shoes",
"pages": 2
}'data starts with these rows:
[
{
"asin": "B0DZWJ88PX",
"position": 1,
"page": 1,
"title": "Men's Run Defy Road Running Shoes",
"brand": "Nike",
"url": "https://www.amazon.com/dp/B0DZWJ88PX",
"imageUrl": "https://m.media-amazon.com/images/I/715uBJVy9EL._AC_UL320_.jpg",
"price": 48.75,
"listPrice": 65,
"currency": "USD",
"rating": 4.6,
"ratingCount": 2784,
"boughtPastMonth": "200+ bought in past month",
"isSponsored": false,
"badges": []
},
{
"asin": "B0DYLF9JV5",
"position": 2,
"page": 1,
"title": "Men's Run Defy Road Running Shoes",
"brand": "Nike",
"url": "https://www.amazon.com/dp/B0DYLF9JV5",
"imageUrl": "https://m.media-amazon.com/images/I/61FRp--pyOL._AC_UL320_.jpg",
"price": 48.75,
"listPrice": 65,
"currency": "USD",
"rating": 4.6,
"ratingCount": 2784,
"boughtPastMonth": "200+ bought in past month",
"isSponsored": false,
"badges": []
}
]Requests and billing
- Requests: 1–3 Web Access requests per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
category
List an amazon.com category's products by browse node, up to 24 a page, by relevance, price, rating, newest or best selling: ASIN, title, brand, price and list price, rating, rating count, purchase volume, sponsored flag, badges and image.
POST https://request.usestring.ai/v1/integrations/amazon/categoryInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
category | string | Required. An Amazon browse node id, such as 172282 for Electronics, or an amazon.com category or search URL carrying one. At least 1 character. |
sort | relevance price-asc price-desc rating newest bestselling | relevance (the default), price-asc, price-desc, rating, newest or bestselling. |
pages | integer | How many result pages to read, from 1. A category page holds up to 24 products. From 1 to 20. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
asin | string | — |
position | integer | The product's position across the pages read, from 1. |
page | integer | The results page the product was on, from 1. |
title | string | null | — |
brand | string | null | The brand, when the result shows it apart from the title, as fashion results do. |
url | string | The product's amazon.com page. |
imageUrl | string | null | — |
price | number | null | The price shown, in currency. |
listPrice | number | null | The struck-through list or typical price, when one is shown. |
currency | string | null | The price's ISO currency code, such as USD. |
rating | number | null | Average star rating, out of 5. |
ratingCount | integer | null | How many customer ratings the product has. |
boughtPastMonth | string | null | Amazon's purchase-volume label, such as 1K+ bought in past month. |
isSponsored | boolean | The result is a sponsored placement. |
badges | string[] | Badges on the result, such as Best Seller or Amazon's Choice. |
Example
curl https://request.usestring.ai/v1/integrations/amazon/category \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"category": "12097479011",
"sort": "bestselling"
}'data starts with these rows:
[
{
"asin": "B0C8PR4W22",
"position": 1,
"page": 1,
"title": "Beats Studio Pro Premium Wireless Over-Ear Headphones- Up to 40-Hour Battery Life, Active Noise Cancelling, Great for Travel & Commuting, USB-C Lossless Audio, Apple & Android Compatible -Black",
"brand": null,
"url": "https://www.amazon.com/dp/B0C8PR4W22",
"imageUrl": "https://m.media-amazon.com/images/I/61u-OaDSfQL._AC_UL320_.jpg",
"price": 199.95,
"listPrice": 299.99,
"currency": "USD",
"rating": 4.5,
"ratingCount": 28804,
"boughtPastMonth": "10K+ bought in past month",
"isSponsored": false,
"badges": []
},
{
"asin": "B09LYF2ST7",
"position": 2,
"page": 1,
"title": "BERIBES Bluetooth Headphones Over Ear Wireless HiFi Stereo Headsets 65H 6EQ",
"brand": null,
"url": "https://www.amazon.com/dp/B09LYF2ST7",
"imageUrl": "https://m.media-amazon.com/images/I/71F2ccIPPLL._AC_UL320_.jpg",
"price": 23.99,
"listPrice": 28.99,
"currency": "USD",
"rating": 4.5,
"ratingCount": 48641,
"boughtPastMonth": "10K+ bought in past month",
"isSponsored": false,
"badges": []
}
]Requests and billing
- Requests: 1–3 Web Access requests per result page.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
product
Read amazon.com product pages by ASIN: title, brand, price and list price, availability, rating, rating count, the share of ratings at each star level, Amazon's review summary, purchase volume, category breadcrumb, bullet points and image.
POST https://request.usestring.ai/v1/integrations/amazon/productInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
items | string[] | Required. Amazon ASINs or amazon.com product URLs. 1 to 100 entries. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
asin | string | — |
url | string | — |
title | string | null | — |
brand | string | null | — |
price | number | null | The price to pay, in currency. |
listPrice | number | null | The struck-through list or typical price, when one is shown. |
currency | string | null | The price's ISO currency code, such as USD. |
availability | string | null | The availability line, such as In Stock. |
rating | number | null | Average star rating, out of 5. |
ratingCount | integer | null | How many customer ratings the product has. |
ratingHistogram | object | null | The share of ratings at each star level, in percent. |
ratingHistogram.fiveStar | integer | null | — |
ratingHistogram.fourStar | integer | null | — |
ratingHistogram.threeStar | integer | null | — |
ratingHistogram.twoStar | integer | null | — |
ratingHistogram.oneStar | integer | null | — |
customersSay | string | null | Amazon's summary of what reviewers say about the product. |
boughtPastMonth | string | null | Amazon's purchase-volume label, such as 1K+ bought in past month. |
categories | string[] | The category breadcrumb, broadest first. |
bullets | string[] | The About this item bullet points. |
imageUrl | string | null | — |
Example
curl https://request.usestring.ai/v1/integrations/amazon/product \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": ["B0D1XD1ZV3"]
}'data starts with these rows:
[
{
"asin": "B0D1XD1ZV3",
"url": "https://www.amazon.com/dp/B0D1XD1ZV3",
"title": "Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparency, Personalized Spatial Audio, High-Fidelity Sound, H2 Chip, USB-C Charging",
"brand": "Apple",
"price": 182.34,
"listPrice": null,
"currency": "USD",
"availability": "In Stock",
"rating": 4.6,
"ratingCount": 46953,
"ratingHistogram": {
"fiveStar": 84,
"fourStar": 8,
"threeStar": 3,
"twoStar": 1,
"oneStar": 4
},
"customersSay": "Customers praise the headphones' sound quality, noise cancellation, and functionality, noting they work better than hearing aids and are great for working out. The battery life and connectivity receive mixed feedback - while some report solid battery life and seamless pairing, others experience issues with charging and disconnection. The fit and hearing aid functionality also get mixed reviews, with some finding them secure and effective, while others report they fall out of the ears and make sounds muffled.",
"boughtPastMonth": "100+ bought in past month",
"categories": [],
"bullets": ["PIONEERING HEARING — AirPods Pro 2 unlock the world’s first all-in-one hearing health experience: a scientifically validated Hearing Test,* clinical-grade and active Hearing Protection.*", "INTELLIGENT NOISE CONTROL — Active Noise Cancellation removes up to 2x more background noise.* Transparency mode lets you hear the world around you, and Adaptive Audio seamlessly blends Active Noise Cancellation and Transparency mode for the best listening experience in any environment.* And when you’re speaking with someone nearby, Conversation Awareness automatically lowers the volume of what’s playing.*", "IMPROVED SOUND AND CALL QUALITY — The Apple-designed H2 chip helps to create deeply immersive sound. The low-distortion, custom-built driver delivers crisp, clear high notes and full, rich bass in stunning definition. Voice Isolation improves the quality of phone calls in loud conditions.*", "CUSTOMIZABLE FIT — Includes four pairs of silicone tips (XS, S, M, L) to fit a wide range of ear shapes and provide all-day comfort. The tips create an acoustic seal to help keep out noise and secure AirPods Pro 2 in place.", "DUST, SWEAT, AND WATER RESISTANT — Both AirPods Pro and the MagSafe Charging Case are IP54 dust, sweat, and water resistant, so you can listen comfortably in more conditions.*", "PERSONALIZED SPATIAL AUDIO — With sound that suits your unique ear shape along with dynamic head tracking, AirPods Pro 2 deliver an immersive listening experience that places sound all around you.* You can also listen to select songs, shows, and movies in Dolby Atmos.", "A HIGHER LEVEL OF CONTROL — Simply swipe, press, and hold the stem to manage playback functions using Touch control. And with Siri Interactions, simply nod your head yes or shake your head no when Siri asks if you’d like to hear a message, answer a call, or manage a notification.*", "LONG BATTERY LIFE — Get up to 6 hours of listening time with Active Noise Cancellation enabled. And get up to 30 hours of total listening time with Active Noise Cancellation enabled, using the case.*", "A MORE CAPABLE CASE— Keep track of AirPods Pro 2 with Precision Finding and a built-in speaker.* A lanyard loop helps keep your AirPods Pro 2 close. Charge with an Apple Watch or MagSafe Charger, USB-C Charge Cable, or Qi-certified charger.", "LEGAL DISCLAIMERS — This is a summary of the main product features. See “Additional information” to learn more."],
"imageUrl": "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg"
}
]Requests and billing
- Requests: 1–3 Web Access requests per entry in
items. - Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.
reviews
Read an amazon.com product's customer reviews, top or most recent first, optionally one star rating or verified purchases only: title, text, rating, author, date, country, helpful votes, verified and Vine flags, and image and video URLs. Each star filter and sort order reaches its first 10 reviews; coverage max reads all ten of them and returns the deduplicated union, the most reviews available for a product.
POST https://request.usestring.ai/v1/integrations/amazon/reviewsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
product | string | Required. An Amazon ASIN or an amazon.com product or review page URL. At least 1 character. |
stars | integer | Only reviews with this star rating, 1 to 5. Omitted, every rating. From 1 to 5. |
sort | top recent | top (the default), Amazon's top reviews first, or recent, newest first. |
verifiedOnly | boolean | Only reviews from verified purchases. |
pages | integer | Accepted for compatibility. Each star filter and sort order now serves only its first 10 reviews, so one page is read whatever this asks; use coverage max for more. From 1 to 10. |
coverage | page max | page (the default) reads the first 10 reviews of one star filter and sort. max reads every star rating both top and recent, 10 requests, and returns the deduplicated union: the most reviews available for a product, typically 40 to 90. stars, sort and pages do not apply to max. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
asin | string | — |
position | integer | The review's position in this star filter and sort order, from 0; with coverage max, its position in the deduplicated union. |
rating | integer | null | — |
title | string | null | — |
text | string | null | — |
author | string | null | — |
reviewDate | string | null | The date the review was written, YYYY-MM-DD, read from origin. |
reviewedIn | string | null | The country the review was written in, such as United States, read from origin. |
origin | string | null | Amazon's line naming the review's country and date, such as Reviewed in the United States on October 4, 2026. |
helpfulVotes | integer | null | — |
isVerifiedPurchase | boolean | null | — |
isVineReview | boolean | null | — |
imageUrls | string[] | — |
videoUrls | string[] | — |
Example
curl https://request.usestring.ai/v1/integrations/amazon/reviews \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product": "https://www.amazon.com/dp/B0D1XD1ZV3",
"stars": 1,
"sort": "recent"
}'data starts with these rows:
[
{
"asin": "B0D1XD1ZV3",
"position": 0,
"rating": 1,
"title": "ABSOLUTE TRASH! BROKE IN EXACTLY 1 YEAR! DO NOT WASTE YOUR MONEY!",
"text": "I am utterly disgusted and beyond angry with this product! Exactly one year after purchasing these AirPods Pro 2, the left earbud COMPLETELY stopped working out of nowhere, not charging at all. No damage, no drops, nothing! When I contacted support, they had the audacity to ask for $89just to replace a SINGLE defective earbud! Are you kidding me?! They intentionally design these to break right after the warranty ends so they can bleed more money out of you. I literally threw my hard-earned money straight into the trash. I will NEVER, EVER buy another one! Save yourself the headache and rage—DO NOT BUY THIS DISASTER!",
"author": "Ozzy",
"reviewDate": "2026-10-20",
"reviewedIn": "United States",
"origin": "Reviewed in the United States on October 20, 2026",
"helpfulVotes": 0,
"isVerifiedPurchase": true,
"isVineReview": false,
"imageUrls": [],
"videoUrls": []
},
{
"asin": "B0D1XD1ZV3",
"position": 1,
"rating": 1,
"title": "Apple is not what it used to be",
"text": "Constant connectivity issues",
"author": "Lucas Carballeira",
"reviewDate": "2026-10-19",
"reviewedIn": "United States",
"origin": "Reviewed in the United States on October 19, 2026",
"helpfulVotes": 0,
"isVerifiedPurchase": true,
"isVineReview": false,
"imageUrls": [],
"videoUrls": []
}
]Requests and billing
- Requests: 1 Web Access request per result page, plus up to 2 setup requests per call.
- Billing:
passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.