String docs
Site integrations

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
ActionDescriptionListed price
searchSearch 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
categoryList 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
productRead 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-reviewsA 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
wishlistRead 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 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/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. What to search amazon.com for, such as nike running shoes. At least 1 character.
categorystringOnly results in this category: an Amazon browse node id, such as 679286011, or an amazon.com category or search URL carrying one.
sortrelevance price-asc price-desc rating newest bestsellingrelevance (the default), price-asc, price-desc, rating, newest or bestselling.
pagesintegerHow 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.
zipstringA 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:

FieldTypeDescription
asinstring—
positionintegerThe product's position across the pages read, from 1.
pageintegerThe results page the product was on, from 1.
titlestring | null—
brandstring | nullThe brand, when the result shows it apart from the title, as fashion results do.
urlstringThe product's amazon.com page.
imageUrlstring | null—
pricenumber | nullThe price shown, in currency.
listPricenumber | nullThe struck-through list or typical price, when one is shown.
currencystring | nullThe price's ISO currency code, such as USD.
ratingnumber | nullAverage star rating, out of 5.
ratingCountinteger | nullHow many customer ratings the product has.
boughtPastMonthstring | nullAmazon's purchase-volume label, such as 1K+ bought in past month.
isSponsoredbooleanThe result is a sponsored placement.
badgesstring[]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/category

Input

Unknown fields are rejected.

FieldTypeDescription
categorystringRequired. An Amazon browse node id, such as 172282 for Electronics, or an amazon.com category or search URL carrying one. At least 1 character.
sortrelevance price-asc price-desc rating newest bestsellingrelevance (the default), price-asc, price-desc, rating, newest or bestselling.
pagesintegerHow many result pages to read, from 1. A category page holds up to 24 products. From 1 to 20.
zipstringA 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:

FieldTypeDescription
asinstring—
positionintegerThe product's position across the pages read, from 1.
pageintegerThe results page the product was on, from 1.
titlestring | null—
brandstring | nullThe brand, when the result shows it apart from the title, as fashion results do.
urlstringThe product's amazon.com page.
imageUrlstring | null—
pricenumber | nullThe price shown, in currency.
listPricenumber | nullThe struck-through list or typical price, when one is shown.
currencystring | nullThe price's ISO currency code, such as USD.
ratingnumber | nullAverage star rating, out of 5.
ratingCountinteger | nullHow many customer ratings the product has.
boughtPastMonthstring | nullAmazon's purchase-volume label, such as 1K+ bought in past month.
isSponsoredbooleanThe result is a sponsored placement.
badgesstring[]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/product

Input

Unknown fields are rejected.

FieldTypeDescription
itemsstring[]Required. Amazon ASINs or amazon.com product URLs. 1 to 100 entries.
zipstringA 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:

FieldTypeDescription
asinstring—
urlstring—
titlestring | null—
brandstring | null—
pricenumber | nullThe price to pay, in currency.
listPricenumber | nullThe struck-through list or typical price, when one is shown.
currencystring | nullThe price's ISO currency code, such as USD.
availabilitystring | nullThe availability line, such as In Stock.
ratingnumber | nullAverage star rating, out of 5.
ratingCountinteger | nullHow many customer ratings the product has.
ratingHistogramobject | nullThe share of ratings at each star level, in percent.
ratingHistogram.fiveStarinteger | null—
ratingHistogram.fourStarinteger | null—
ratingHistogram.threeStarinteger | null—
ratingHistogram.twoStarinteger | null—
ratingHistogram.oneStarinteger | null—
customersSaystring | nullAmazon's summary of what reviewers say about the product.
boughtPastMonthstring | nullAmazon's purchase-volume label, such as 1K+ bought in past month.
categoriesstring[]The category breadcrumb, broadest first.
bulletsstring[]The About this item bullet points.
imageUrlstring | 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-reviews

Input

Unknown fields are rejected.

FieldTypeDescription
productstringRequired. An Amazon ASIN, or a product or review page URL on one of Amazon's country stores. At least 1 character.
storesall us ca uk de fr it es mx br in jp au nl se pl ae sa sg tr be[] | nullStore 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:

FieldTypeDescription
asinstringThe product ASIN that was asked for.
reviewedAsinstring | nullThe ASIN the review was written for, which can be a variant of the product.
reviewIdstringAmazon's id for the review.
storeus ca uk de fr it es mx br in jp au nl se pl ae sa sg tr beStore code of the page the review was first read from.
seenInus 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.
sectionlocal internationallocal when the review came from the local list of the store it was first read from, otherwise international.
reviewCountrystring | nullISO 3166-1 alpha-2 country where the review was written, or null when the review's language tag has no region.
languagestring | nullThe review's original language, such as en or ja.
ratinginteger | nullStar rating, from 1 to 5.
titlestring | nullThe review title in its original language.
textstring | nullThe review text in its original language.
authorstring | null—
reviewDatestring | nullThe date the review was written, YYYY-MM-DD, read from the date line, or null when that line could not be parsed.
dateLinestring | nullThe store's own date line, such as Reviewed in the United Kingdom on 3 May 2025.
variantstring | nullThe variant the review is for, such as Size: X-Large, Colour Name: Black.
isVerifiedPurchasebooleanWhether the review is marked as a verified purchase.
helpfulVotesintegerHow many people found the review helpful. 0 when the page does not say.
imageUrlsstring[]Image URLs attached to the review.
positionintegerThe 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/wishlist

Input

Unknown fields are rejected.

FieldTypeDescription
liststringRequired. 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.
limitintegerThe 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:

FieldTypeDescription
idstringThe list's id.
urlstringThe list's amazon.com page.
namestringThe list's name.
descriptionstring | nullThe description the list's owner wrote.
unpurchasedOnlybooleanTrue when the list shows visitors only items still to be bought, so an item bought in full is left out of items.
itemsobject[]The list's items, most recently added first, up to limit.
items[].itemIdstringThe item's id within the list.
items[].positionintegerThe item's position in the list, from 1.
items[].asinstring | nullThe product's ASIN; null for an item added from another site.
items[].titlestring | null—
items[].bylinestring | nullThe brand or author line under the title, such as by Lysol (Health and Beauty)
items[].urlstring | nullThe product's amazon.com page.
items[].imageUrlstring | null—
items[].pricenumber | nullThe price shown, in currency; null when the item has no current offer.
items[].currencystring | nullThe price's ISO currency code, USD.
items[].ratingnumber | nullThe product's average star rating, out of 5.
items[].requestedinteger | nullHow many the owner wants in all, the list's Needs count; it does not go down as copies are bought.
items[].purchasedinteger | nullHow many have been bought from the list so far, the list's Has count; null when the list hides it from visitors.
items[].prioritystring | nullThe priority the owner set, such as highest; null when left at the default.
items[].commentstring | nullThe owner's note on the item.
items[].badgestring | nullA 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.