String docs
Site integrations

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
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
reviewsRead 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 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.

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.
  • 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.

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.
  • 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.

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.
  • 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/reviews

Input

Unknown fields are rejected.

FieldTypeDescription
productstringRequired. An Amazon ASIN or an amazon.com product or review page URL. At least 1 character.
starsintegerOnly reviews with this star rating, 1 to 5. Omitted, every rating. From 1 to 5.
sorttop recenttop (the default), Amazon's top reviews first, or recent, newest first.
verifiedOnlybooleanOnly reviews from verified purchases.
pagesintegerAccepted 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.
coveragepage maxpage (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:

FieldTypeDescription
asinstring—
positionintegerThe review's position in this star filter and sort order, from 0; with coverage max, its position in the deduplicated union.
ratinginteger | null—
titlestring | null—
textstring | null—
authorstring | null—
reviewDatestring | nullThe date the review was written, YYYY-MM-DD, read from origin.
reviewedInstring | nullThe country the review was written in, such as United States, read from origin.
originstring | nullAmazon's line naming the review's country and date, such as Reviewed in the United States on October 4, 2026.
helpfulVotesinteger | null—
isVerifiedPurchaseboolean | null—
isVineReviewboolean | null—
imageUrlsstring[]—
videoUrlsstring[]—

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.