Amazon API

Get Amazon data with one API

The Amazon Product Data API returns product, review, offer and search data across Amazon marketplaces as clean JSON.

A
/amazon/v1

14 active endpoints, on 0, 1, 2 and 5 credit tiers.

  • POST/amazon/v1/product/detail
  • POST/amazon/v1/product/reviews
  • POST/amazon/v1/product/offers
  • POST/amazon/v1/search
  • POST/amazon/v1/products_batch
  • POST/amazon/v1/bestsellers
  • POST/amazon/v1/new-releases
  • +7 more

What Amazon endpoints does ReefAPI ship?

14 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

14 endpoints

product/detail

2 cr

full product page (title/price/currency/rating/count/brand/features/images/categories/variati…

required
asin
optional
marketplace

product/reviews

1 cr

Amazon product reviews by ASIN.

required
asin
optional
marketplace, marketplaces

product/offers

2 cr

pinned buybox + all-offers (AOD aodAjaxMain).

required
asin
optional
marketplace

search

1 cr

product search with optional filters (price range, minimum rating, deals, brand) → results[]{…

required
query
optional
marketplace, page, max_results, sort, price_min, price_max, min_rating, deals, discount, prime, brand

products_batch

5 cr

Look up MANY Amazon products in ONE call by ASIN.

required
asins
optional
marketplace

bestsellers

1 cr

best-sellers ranking for a department (category slug required).

required
category
optional
marketplace, max_results

new-releases

1 cr

new-releases ranking for a department (category slug required).

required
category
optional
marketplace, max_results

seller/profile

1 cr

seller profile (name, feedback %, lifetime ratings, rating).

required
seller_id
optional
marketplace

autocomplete

0 cr

search autocomplete suggestions.

required
query
optional
marketplace

seller/products

1 cr

a seller's catalog/storefront by seller_id (paginated).

required
seller_id
optional
marketplace, page

seller/reviews

1 cr

seller FEEDBACK reviews (rating/text/rater/date) by seller_id.

required
seller_id
optional
marketplace

deals

1 cr

Amazon deal-products (today's deals / goldbox).

required
optional
marketplace

product/related

1 cr

Amazon related & recommended products by ASIN.

required
asin
optional
marketplace

gtin-to-asin

1 cr

Amazon barcode lookup.

required
optional
gtin, marketplace

Every parameter, every allowed value →

Amazon API

3 of 14 endpoints, ready to run

View docs ↗

full product page (title/price/currency/rating/count/brand/features/images/categories/variati…

2 credits1 required · 0 optional
POST/amazon/v1/product/detail
ok3405 ms · 1 records · sample
{
  "ok": true,
  "meta": {
    "api": "amazon",
    "endpoint": "product/detail",
    "mode": "live",
    "latency_ms": 3404.5,
    "record_count": 1,
    "cache_hit": false,
    "completeness_pct": 85.7
  },
  "data": {
    "product": {
      "asin": "B0DGHMNQ5Z",
      "title": "Apple AirPods 4 Wireless Earbuds",
      "price": null,
      "price_str": null,
      "currency": null,
      "list_price": null,
      "rating": 4.5,
      "rating_count": 34065,
      "availability": "This item cannot be shipped to your selected delivery location. Please choose a different delivery location.",
      "brand": "Apple",
      "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.*"
      ],
      "images": [
        "https://m.media-amazon.com/images/I/61iBtxCUabL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/31bzJADEOkL._AC_.jpg",
        "https://m.media-amazon.com/images/I/51ppBwqC4xL._AC_SL1500_.jpg"
      ],
      "categories": [],
      "variations": {
        "count": 4,
        "asin_map": {
          "B0DGHMNQ5Z": [
            "Without Active Noise Cancellation",
            "Without AppleCare+"
          ],
          "B0DGJ7HYG1": [
            "With Active Noise Cancellation",
            "Without AppleCare+"
          ],
          "B0DGW54P27": [
            "Without Active Noise Cancellation",
            "With AppleCare+ (2 Years)"
          ],
          "B0DGVT3T92": [
            "With Active Noise Cancellation",
            "With AppleCare+ (2 Years)"
          ]
        },
        "asin_map_sample": {
          "B0DGHMNQ5Z": [
            "Without Active Noise Cancellation",
            "Without AppleCare+"
          ],
          "B0DGJ7HYG1": [
            "With Active Noise Cancellation",
            "Without AppleCare+"
          ],
          "B0DGW54P27": [
            "Without Active Noise Cancellation",
            "With AppleCare+ (2 Years)"
          ],
          "B0DGVT3T92": [
            "With Active Noise Cancellation",
            "With AppleCare+ (2 Years)"
          ]
        },
        "dimension_values": {
          "configuration": [
            "With AppleCare+ (2 Years)",
            "Without AppleCare+"
          ],
          "style_name": [
            "With Active Noise Cancellation",
            "Without Active Noise Cancellation"
          ]
        },
        "dimensions": [
          "style_name",
          "configuration"
        ],
        "asin_dimensions": {
          "B0DGHMNQ5Z": {
            "style_name": "Without Active Noise Cancellation",
            "configuration": "Without AppleCare+"
          },
          "B0DGJ7HYG1": {
            "style_name": "With Active Noise Cancellation",
            "configuration": "Without AppleCare+"
          },
          "B0DGW54P27": {
            "style_name": "Without Active Noise Cancellation",
            "configuration": "With AppleCare+ (2 Years)"
          },
          "B0DGVT3T92": {
            "style_name": "With Active Noise Cancellation",
            "configuration": "With AppleCare+ (2 Years)"
          }
        },
        "total_children": 4,
        "parent_asin": "B0GGJGSPPP"
      },
      "tech_specs": {
        "Product Dimensions": "3.25 x 3.25 x 1.5 inches",
        "Item Weight": "4.2 ounces",
        "Manufacturer": "Apple",
        "ASIN": "B0DGHMNQ5Z",
        "Item model number": "MXP63LL/A",
        "Batteries": "3 Lithium Ion batteries required. (included)",
        "Date First Available": "September 9, 2024",
        "Units": "1 Count",
        "Number Of Items": "1"
      },
      "aplus": null,
      "compare_similar": [],
      "gtin": null,
      "upc": null,
      "ean": null,
      "isbn": null,
      "barcodes": [],
      "coupon": null,
      "campaign": null
    },
    "reviews": [
      {
        "review_id": "R2R1RGOKYFHHFO",
        "profile_id": "amzn1.account.AG2QUKKAK66PIPTMDFONNGZ3FO4Q",
        "rating": 5,
        "title": "Airpods",
        "date": "August 18, 2026",
        "location": "the United States",
        "verified": true,
        "format": "Style: Without Active Noise Cancellation Set: Without AppleCare+",
        "helpful_count": 6,
        "body": "Brief content visible, double tap to read full content. Full content visible, double tap to read brief content. AirPods work really well and have great sound quality. They’re comfortable to wear, easy to connect, and convenient for listening to music, watching videos, or taking calls. The battery lasts a good amount of time, and I like how easy they are to use. Overall, a great pair of earbuds and definitely worth it. Read more Read less",
        "images": [],
        "marketplace": "www.amazon.com"
      },
      {
        "review_id": "R2D8KB3HLQDFXH",
        "profile_id": "amzn1.account.AFERPL2WPOSG4IPILCXSBFIOGI6A",
        "rating": 5,
        "title": "Easy to use and very clear",
        "date": "August 3, 2026",
        "location": "the United States",
        "verified": true,
        "format": "Style: Without Active Noise Cancellation Set: Without AppleCare+",
        "helpful_count": 11,
        "body": "Brief content visible, double tap to read full content. Full content visible, double tap to read brief content. I wasn’t going to review them, but after finding out a few things, I thought I should share. When you’re wearing them and get a phone call, they’ll ask you if you’d like to answer or go to voice mail. YOU CAN NOD YES OR SHAKE YOUR HEAD NO. Seriously. It works. They’ll also ask if they can read your texts” messages. They’re a great accompaniment for my workouts. They’ll tell you when your Move ring and Exercise ring close. I’m never wearing them when my Standing ring closes, but I imagine they’d tell me if I was. It also announces your pace when you finish jogging a mile at each mile. I’m no jogging expert other than going to a jogging store and the sales lady checked my running form before suggesting shoes and socks. I initially fought buying them because they fell out of my ears when trying them on, but I bought ear hooks and that problem disappeared. Would definitely buy another pair if anything happens to mine. Read more Read less",
        "images": [],
        "marketplace": "www.amazon.com"
      },
      {
        "review_id": "R2H2UN7ZX841M6",
        "profile_id": "amzn1.account.AF4LQKYLIL2VFYSEDW6OUY5MHSMQ",
        "rating": 5,
        "title": "Great Everyday Earbuds With a Comfortable Fit",
        "date": "July 26, 2026",
        "location": "the United States",
        "verified": true,
        "format": "Style: Without Active Noise Cancellation Set: Without AppleCare+",
        "helpful_count": 17,
        "body": "Brief content visible, double tap to read full content. Full content visible, double tap to read brief content. I’ve been using the AirPods 4 for a while now, and they have been a great upgrade for my daily listening. The design feels lightweight and comfortable, and I can wear them for long periods without my ears feeling tired. They are easy to connect, and switching between my Apple devices is smooth and convenient. The sound quality is clear, with good detail for music, podcasts, and phone calls. I especially like how simple everything feels — just open the case, put them in, and they are ready to go. The battery life is reliable for my daily use, and the charging case is small enough to carry anywhere. The only thing to keep in mind is that the open-style fit may not block outside noise as much as in-ear earbuds. However, for everyday use, commuting, working, and relaxing at home, they are comfortable, easy to use, and very enjoyable. Read more Read less",
        "images": [],
        "marketplace": "www.amazon.com"
      }
    ],
    "review_insights": {
      "summary": "Customers find the earbuds sound clear and well worth the money. However, the fit receives mixed feedback, with some saying they fit comfortably while others report they don't stay in place. Moreover, the reliability, battery life, and connectivity are also mixed aspects - while some say they work great and recharge quickly, others report issues with the left bud stopping working, the case not holding a charge, and the earbuds disconnecting from phones.",
      "aspects": [
        {
          "keyword": "sound quality",
          "sentiment": "positive",
          "positive": true,
          "negative": false,
          "mentions": 2054,
          "mentions_positive_pct": 84
        },
        {
          "keyword": "fit",
          "sentiment": "negative",
          "positive": false,
          "negative": true,
          "mentions": 1243,
          "mentions_positive_pct": 34
        },
        {
          "keyword": "value for money",
          "sentiment": "positive",
          "positive": true,
          "negative": false,
          "mentions": 1122,
          "mentions_positive_pct": 65
        }
      ],
      "quotes": [
        {
          "text": "Great sound, light, and fit and stay in your ear, you just have place them so they stay, very happy with these. Call me pleasantly surprised.",
          "review_id": null,
          "aspect": "sound quality"
        },
        {
          "text": "Love them, i recently lost my pro 2 set and I was thinking maybe I’ll wait for the 4 pro noise cancellation better sound, but I decided to get this...",
          "review_id": null,
          "aspect": "sound quality"
        },
        {
          "text": "...I angled them a little bit, then they don’t fall out at all and are nice and snug, and usually earbuds in general don’t fit my ears.",
          "review_id": null,
          "aspect": "sound quality"
        }
      ]
    },
    "total_review_count": 34065,
    "average_rating": 4.5
  }
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows, with seller names left out. Press Try it for the untrimmed response.

How the Amazon API works

Amazon is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 185 engines.

02
Call
POST /amazon/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 or 2 or 5 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Marketplace codes, and the currency symbol each one returns

marketplace picks the Amazon site, which sets both the language of every text field and the currency of every price. The currency field is the symbol Amazon prints, not an ISO-4217 code, so it is not unique - com and com.mx both return "$". Always store the marketplace next to the price. These values were measured with one search per site on 2026-08-26.

marketplaceSitecurrency value returned
com (default)amazon.com - United States$
co.ukamazon.co.uk - United Kingdom£
deamazon.de - Germany
co.jpamazon.co.jp - Japan¥ (fullwidth yen)
inamazon.in - India
com.tramazon.com.tr - TürkiyeTL
plamazon.pl - Polandzł (null on cards with no price)
seamazon.se - Swedenkr
aeamazon.ae - United Arab EmiratesAED
com.bramazon.com.br - BrazilR$
com.mxamazon.com.mx - Mexico$ (the same symbol as com, and not USD)

fr, it, es, ca, com.au, nl, sg and sa are accepted by the same enum but were not measured in this pass. An ASIN is per-marketplace: B0DGHMNQ5Z resolves on com and comes back in not_found on co.uk, de, co.jp, in, com.tr, com.br, pl, se and ae, because that listing does not exist on those sites.

What people build with Amazon

The jobs this data is most often used for.

14

endpoints

0/1/2/5

credits per call

01

Pricing teams call product/offers to monitor the buy-box winner and third-party prices for an ASIN.

02

Catalog-enrichment tools use product/detail to fill product pages with images, specs and A+ content.

03

Review-analysis products pull product/reviews to track sentiment and rating trends over time.

What Amazon data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 185 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/amazon/v1/product/detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"asin":"B0DGHMNQ5Z"}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/amazon/v1/product/detail",
    headers={"x-api-key": REEF_KEY},
    json={
  "asin": "B0DGHMNQ5Z"
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Amazon.

Get a free key →
Why is currency "$" instead of "USD"?

Because it is read from the page, where Amazon prints a symbol. Measured values are $, £, €, the fullwidth ¥, ₹, R$, and the word-like TL, zł, kr and AED. Two consequences: it is not an ISO code, so do not hand it to a currency library unmapped, and it is not unique - amazon.com and amazon.com.mx both return "$" for very different amounts (a laptop at 4999 on com.mx is pesos). Derive your own currency from meta.marketplace, which every response echoes, and use currency only for display.

Is an ASIN always 10 characters?

Every ASIN measured was exactly 10 uppercase alphanumeric characters - B0DGHMNQ5Z, B01GJOMWVA, B0CKM9F15Z - and parent ids follow the same shape (B0GGJGSPPP, B0F15CGHY5). It is the code after /dp/ in a product URL. If all you have is a barcode, gtin-to-asin converts a UPC, EAN, ISBN or GTIN-14 into the matching ASIN or ASINs rather than making you guess.

Why does products_batch report a much smaller rating_count than product/detail?

products_batch reads Amazon's compact card, where the review count is abbreviated, and it passes that number through unchanged. Measured on the same two ASINs on 2026-08-26: batch returned rating_count 34 where product/detail returned 34,056, and 501 where detail returned 50,194. The star rating itself agrees (4.5 and 4.4). Use products_batch for cheap price and availability refreshes - one upstream call covers up to 15 ASINs - and read rating_count from product/detail whenever the exact number matters.

Why did my parent ASIN come back in not_found?

Because a parent ASIN is a grouping node, not a buyable listing, and Amazon does not serve it as a product page. A measured batch of four returned two products plus not_found ["B0ZZZZZZZZ", "B0GGJGSPPP"] - the first is nonsense, the second is the legitimate parent of the AirPods listing. Query a child ASIN instead. not_found is why the batch action is safe to run blind: nothing is silently dropped, and meta.batch reports requested, resolved, not_found and the ceiling of 15.

How do variations and the parent ASIN relate?

product/detail returns a variations object that maps the whole family in one call: total_children, parent_asin, dimensions (the axes, e.g. style_name and configuration), dimension_values (the options on each axis), asin_map (child ASIN to its option labels) and asin_dimensions (child ASIN to a keyed object). A measured AirPods 4 listing returned 4 children across two axes - Active Noise Cancellation yes/no crossed with AppleCare+ yes/no - under parent B0GGJGSPPP. So you can enumerate every variant with one detail call, then price only the children you care about.

How do the buy box and the third-party offers differ, and where is the seller name?

product/offers returns pinned (the offer Amazon is featuring) as a sibling of offers[] (everything else), and offer_count counts only the latter - a measured call returned meta.record_count 10 for 1 pinned plus 9 offers. Read the merchant from ships_from, which carried real storefront names like "VR Top Sell" and "D' Lolas House"; the seller field currently returns the row label rather than the name. Expect pinned and product/detail to disagree on price - the same ASIN measured 129.00 pinned against 99.00 on the detail page - so capture both rather than assuming either is the price.

What do condition values look like on an offer?

They are Amazon's own English grade strings, not a numeric enum: "New", and for used stock "Used - Like New", "Used - Very Good", "Used - Good" and "Used - Acceptable", all measured on live listings. delivery is a free-text promise line that includes Prime alternatives and an order-within countdown, so treat it as display copy rather than a date. Because offers[] mixes new and used, filter on condition before you compute a lowest price - the cheapest row on one measured ASIN was a used unit at 20.39 against a 34.99 new pinned price.

Why do review bodies start with "Brief content visible, double tap to read full content"?

That is Amazon's own screen-reader text, rendered inside the review block on the product page, and it is returned verbatim rather than being silently edited away. Strip that prefix and its "Full content visible, double tap to read brief content" twin before running sentiment analysis. The rest of the row is clean: review_id, author, profile_id, rating as a float, date as a localized long date ("August 18, 2026"), location, verified, format naming the variant bought, helpful_count and marketplace. Note also that product/detail returns reviews[] as a sibling of product, not nested inside it.

Which fields come back null when Amazon does not print them?

Barcodes and rich content are the usual blanks. On a measured mainstream ASIN, gtin, upc, ean and isbn were all null with barcodes an empty array, aplus was null, categories was empty, and coupon and campaign were null because that listing had no clippable coupon or deal ribbon. availability is null on a normally stocked card by design - Amazon only prints a stock line when stock is low or gone, and the engine does not invent one. Absent means "Amazon did not print it", never "zero".

What is the Amazon API?

Amazon API is a ReefAPI endpoint group for product details, prices, ratings and reviews. It returns live JSON through POST requests under /amazon/v1.

Is the Amazon API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Amazon calls use the same shared credit balance as every other ReefAPI engine.

Do I need an Amazon login or account?

No login to Amazon is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Amazon data?

The page example is captured from a live product/detail call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Amazon API use?

Amazon actions currently cost 1-5 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

37 E-commerce & Marketplaces APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Amazon, you are one call away from the rest of the category — no second contract, no second integration.

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 184 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts.