Amazon
Amazon.com product search, category listings and product pages, optionally as a shopper at a US ZIP code, customer reviews by product, filtered by star rating and sorted top or most recent, top reviews from Amazon's other country stores, and public wish lists with their items.
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:
2.2.0 - Reads from:
amazon.com,amazon.ca,amazon.co.uk,amazon.de,amazon.fr,amazon.it,amazon.es,amazon.com.mx,amazon.com.br,amazon.in,amazon.co.jp,amazon.com.au,amazon.nl,amazon.se,amazon.pl,amazon.ae,amazon.sa,amazon.sg,amazon.com.tr,amazon.com.be,amzn.to,a.co
| 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 |
regional-reviews | A product's top reviews on Amazon's country stores: each store's local reviews and the foreign reviews it shows beside them, deduplicated by review id. A store shows about 8 local reviews and up to 5 foreign ones, and no more than that. | Billed per request at your plan's rates |
wishlist | Read a public amazon.com wish list by id, link or amzn.to/a.co share link: its name and description, whether it shows only unpurchased items, and its items in most-recently-added order (up to 1,000), each with ASIN, title, byline, price, rating, image, quantity wanted (Needs) and bought (Has, when the list shows it), priority and the owner's comment. | 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. |
zip | string | A 5-digit US ZIP code to read the pages as a shopper delivering there, such as 10001. Omitted, the default US view. Matches ^\d{5}$. |
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, plus up to 24 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.
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. |
zip | string | A 5-digit US ZIP code to read the pages as a shopper delivering there, such as 10001. Omitted, the default US view. Matches ^\d{5}$. |
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, plus up to 24 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.
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. |
zip | string | A 5-digit US ZIP code to read the pages as a shopper delivering there, such as 10001. Omitted, the default US view. Matches ^\d{5}$. |
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, plus up to 24 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.
regional-reviews
A product's top reviews on Amazon's country stores: each store's local reviews and the foreign reviews it shows beside them, deduplicated by review id. A store shows about 8 local reviews and up to 5 foreign ones, and no more than that.
POST https://request.usestring.ai/v1/integrations/amazon/regional-reviewsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
product | string | Required. An Amazon ASIN, or a product or review page URL on one of Amazon's country stores. At least 1 character. |
stores | all us ca uk de fr it es mx br in jp au nl se pl ae sa sg tr be[] | null | Store codes to read, in any order. Omit, leave empty, or include "all" to read every store. Duplicates are ignored. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
asin | string | The product ASIN that was asked for. |
reviewedAsin | string | null | The ASIN the review was written for, which can be a variant of the product. |
reviewId | string | Amazon's id for the review. |
store | us ca uk de fr it es mx br in jp au nl se pl ae sa sg tr be | Store code of the page the review was first read from. |
seenIn | us ca uk de fr it es mx br in jp au nl se pl ae sa sg tr be[] | Store codes whose page showed this review, in store order. At least 1 entry. |
section | local international | local when the review came from the local list of the store it was first read from, otherwise international. |
reviewCountry | string | null | ISO 3166-1 alpha-2 country where the review was written, or null when the review's language tag has no region. |
language | string | null | The review's original language, such as en or ja. |
rating | integer | null | Star rating, from 1 to 5. |
title | string | null | The review title in its original language. |
text | string | null | The review text in its original language. |
author | string | null | — |
reviewDate | string | null | The date the review was written, YYYY-MM-DD, read from the date line, or null when that line could not be parsed. |
dateLine | string | null | The store's own date line, such as Reviewed in the United Kingdom on 3 May 2025. |
variant | string | null | The variant the review is for, such as Size: X-Large, Colour Name: Black. |
isVerifiedPurchase | boolean | Whether the review is marked as a verified purchase. |
helpfulVotes | integer | How many people found the review helpful. 0 when the page does not say. |
imageUrls | string[] | Image URLs attached to the review. |
position | integer | The review's index in the deduplicated result, from 0. |
Example
curl https://request.usestring.ai/v1/integrations/amazon/regional-reviews \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"product": "B01GCML3L4",
"stores": ["uk", "de", "br"]
}'data starts with these rows:
[
{
"asin": "B01GCML3L4",
"reviewedAsin": "B01GCML5O4",
"reviewId": "R2DDZRR0UGKRVF",
"store": "uk",
"seenIn": ["uk"],
"section": "local",
"reviewCountry": "GB",
"language": "en",
"rating": 5,
"title": "Price",
"text": "Great as always",
"author": "Rafal Zawadzki",
"reviewDate": "2026-02-17",
"dateLine": "Reviewed in the United Kingdom on 17 February 2026",
"variant": "Size Name: L",
"isVerifiedPurchase": true,
"helpfulVotes": 0,
"imageUrls": [],
"position": 0
},
{
"asin": "B01GCML3L4",
"reviewedAsin": "B01GCML8XM",
"reviewId": "R2OH4ZAC5NV4YP",
"store": "uk",
"seenIn": ["uk", "de"],
"section": "local",
"reviewCountry": "GB",
"language": "en",
"rating": 5,
"title": "Good shooting gloves",
"text": "Good shooting gloves alright dexterity and a very non slip grip on most surfaces. The only con I've noticed is that the synthetic leather dries very slow.",
"author": "matej s.",
"reviewDate": "2020-03-09",
"dateLine": "Reviewed in the United Kingdom on 9 March 2020",
"variant": "Size Name: M",
"isVerifiedPurchase": true,
"helpfulVotes": 0,
"imageUrls": [],
"position": 1
}
]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.
wishlist
Read a public amazon.com wish list by id, link or amzn.to/a.co share link: its name and description, whether it shows only unpurchased items, and its items in most-recently-added order (up to 1,000), each with ASIN, title, byline, price, rating, image, quantity wanted (Needs) and bought (Has, when the list shows it), priority and the owner's comment.
POST https://request.usestring.ai/v1/integrations/amazon/wishlistInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
list | string | Required. A public amazon.com wish list: an amazon.com/hz/wishlist/ls/{id} link, an amzn.to or a.co share link to one, or the bare list id. At least 1 character. |
limit | integer | The most items to return, in the list's most-recently-added order, 1 to 1000. Defaults to 100. From 1 to 1000. |
Output
data is an array of rows, one per result. Each row has:
| Field | Type | Description |
|---|---|---|
id | string | The list's id. |
url | string | The list's amazon.com page. |
name | string | The list's name. |
description | string | null | The description the list's owner wrote. |
unpurchasedOnly | boolean | True when the list shows visitors only items still to be bought, so an item bought in full is left out of items. |
items | object[] | The list's items, most recently added first, up to limit. |
items[].itemId | string | The item's id within the list. |
items[].position | integer | The item's position in the list, from 1. |
items[].asin | string | null | The product's ASIN; null for an item added from another site. |
items[].title | string | null | — |
items[].byline | string | null | The brand or author line under the title, such as by Lysol (Health and Beauty) |
items[].url | string | null | The product's amazon.com page. |
items[].imageUrl | string | null | — |
items[].price | number | null | The price shown, in currency; null when the item has no current offer. |
items[].currency | string | null | The price's ISO currency code, USD. |
items[].rating | number | null | The product's average star rating, out of 5. |
items[].requested | integer | null | How many the owner wants in all, the list's Needs count; it does not go down as copies are bought. |
items[].purchased | integer | null | How many have been bought from the list so far, the list's Has count; null when the list hides it from visitors. |
items[].priority | string | null | The priority the owner set, such as highest; null when left at the default. |
items[].comment | string | null | The owner's note on the item. |
items[].badge | string | null | A badge on the item, such as Best Seller. |
Example
curl https://request.usestring.ai/v1/integrations/amazon/wishlist \
-H "Authorization: Bearer $STRING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"list": "https://www.amazon.com/hz/wishlist/ls/2ALIL0SLDKRAF",
"limit": 25
}'data starts with these rows:
[
{
"id": "2ALIL0SLDKRAF",
"url": "https://www.amazon.com/hz/wishlist/ls/2ALIL0SLDKRAF",
"name": "Longview PAWS Wish List",
"description": null,
"unpurchasedOnly": false,
"items": [
{
"itemId": "I3N6NGDQK8FKQQ",
"position": 1,
"asin": "B0BNNVT2VH",
"title": "Lysol Disinfecting Wipes, Cleaner, Lemon + Mango + Linen, 80 ct. (4 Pack) | All Purpose Cleaner, Sanitizing, Deodorizing, Apartment Essentials, Back To School Cleaning Supplies, Kitchen & Bathroom Wipe",
"byline": "by Lysol (Health and Beauty)",
"url": "https://www.amazon.com/dp/B0BNNVT2VH",
"imageUrl": "https://m.media-amazon.com/images/I/41Se5rI1z8L._SS135_.jpg",
"price": 13.47,
"currency": "USD",
"rating": 4.8,
"requested": 1,
"purchased": null,
"priority": "high",
"comment": null,
"badge": "Best Seller"
},
{
"itemId": "I2U3V0Z1SKUGX1",
"position": 2,
"asin": "B0BYLQ7BWW",
"title": "Fabuloso 2X All-Purpose Cleaner, Spring Fresh Scent, 56 fl oz | No Rinse Floor Cleaner, Long-Lasting Freshness, All-Purpose Cleaner, Concentrated Formula, Everyday Cleaning, Multi-Surface",
"byline": "by Fabuloso (Health and Beauty)",
"url": "https://www.amazon.com/dp/B0BYLQ7BWW",
"imageUrl": "https://m.media-amazon.com/images/I/41w0s0LEpwL._SS135_.jpg",
"price": 4.97,
"currency": "USD",
"rating": 4.8,
"requested": 1,
"purchased": null,
"priority": "highest",
"comment": null,
"badge": null
},
{
"itemId": "I20Q86QM4KBM6C",
"position": 3,
"asin": "B0DHWC8Y2H",
"title": "Fabuloso 2X All-Purpose Cleaner, Peach Scent, 56 fl oz | No Rinse Floor Cleaner, Long-Lasting Freshness, Multi-Purpose Cleaner, Concentrated Formula, Everyday Cleaning",
"byline": "by Fabuloso (Health and Beauty)",
"url": "https://www.amazon.com/dp/B0DHWC8Y2H",
"imageUrl": "https://m.media-amazon.com/images/I/4109PDn-JSL._SS135_.jpg",
"price": 3.99,
"currency": "USD",
"rating": 4.8,
"requested": 1,
"purchased": null,
"priority": "highest",
"comment": null,
"badge": null
}
]
}
]Requests and billing
- Requests: 1–3 Web Access requests per result page, plus up to 1 setup request 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.