Clair API
  • All APIs
  • Pricing
  • Docs
Web Scraping
  • Web Scraper API
E-commerce
  • Amazon API
    • Product
    • Reviews
    • Search
    • Price
    • Best sellers
    • Seller
    • ASIN lookup
  • Google Shopping API
SERP & Search
  • Google Search API
  • Google Maps API
    • Scraper
    • Place
AI Search
  • ChatGPT API
  • Google AI Overview API
  • Google AI Mode API
Jobs & Hiring
  • Glassdoor API
    • Jobs
    • Reviews
    • Salary
  • Indeed API
Company Data & Reviews
  • Trustpilot API
  • Crunchbase API
    • Company
    • People
Video & Social
  • YouTube API
  • TikTok API
  • Instagram API
News & Media
  • Google News API
  • Reuters API
  • Bloomberg API
  • Associated Press API
  • Use cases
  • Comparisons
  • Glossary
Ecommerce and reviews
  • Amazon price monitoring
  • Trustpilot review monitoring
  • MAP enforcement on Amazon
  • Amazon rating monitoring
  • Amazon category research
  • Trustpilot competitor benchmarking
  • Google Shopping price tracking
Search and local
  • Google rank tracking
  • Local lead generation
  • Local SEO competitor audit
  • Grounding LLM answers in search results
  • Content research from People also ask
AI search
  • AI visibility tracking
  • Find the sites AI answers cite
  • AI Overview tracking for SEO keywords
Leads and companies
  • Account research briefs
Jobs and hiring
  • Salary benchmarking
  • Job market analytics
  • Employer reputation tracking
News
  • Brand and media monitoring
  • Financial news tracking
  • News corpus for research and RAG
Social and video
  • YouTube transcripts for RAG
  • Instagram engagement rate
  • Influencer campaign tracking
Comparisons
  • Clair vs SerpApi
  • Clair vs Google Places API
  • Clair vs Google Custom Search API
GlossarySERPSERP APIPeople also askGoogle place IDASINBuy BoxGTINSalary percentilesTrustScoreRating distributionAll 47 terms →
PricingDocsStatus
Dashboard
  • Use cases
  • Amazon API
  • Rating distribution
  • ASIN
  • Best Sellers Rank

Amazon rating monitoring

Kaan Ersoy·2 min read·Oct 29, 2026

{ }
Record each product's star rating, number of ratings, and rating distribution every week, next to its competitors, and, outside amazon.com, read the critical reviews the product page shows. A drop in the average, or a rise in 1-star ratings, is usually the first sign of a quality or listing problem.
Try the Amazon API →

On this page

  1. Who
  2. Pipeline
  3. Code
  4. Cost
  5. Response times
  6. Limits
  7. FAQ

Who runs this, and what for

TeamWhat they decide with it
Brands and sellersWhether a product batch, packaging, or listing change hurt ratings.
Category analystsHow ratings compare across a category, as a quality signal.

The calls, step by step

  1. 1. Amazon product details

    GET /v1/amazon/product

  2. 2. Amazon product reviews

    GET /v1/amazon/reviews

The endpoints this pipeline calls, in order. Each step below shows a recorded response from one of them.
  1. 1. Snapshot the rating and distribution

    The product endpoint returns the product's rating, ratings count, and distribution as the percentage of ratings at each star, on every marketplace including amazon.com. Store it with the date; Amazon shows only the current numbers.

    The amazon.com page this step reads
    The page on amazon.com that this call reads, as a signed-out visitor sees it. The response below is what Clair returns from it.

    GET /v1/amazon/product?asin=B0CF3VGQFL · product.rating_distribution

    [
      {
        "stars": 5,
        "percent": 69
      },
      {
        "stars": 4,
        "percent": 12
      },
      {
        "stars": 3,
        "percent": 7
      },
      {
        "stars": 2,
        "percent": 4
      },
      {
        "stars": 1,
        "percent": 8
      }
    ]
    Recorded response. Live values differ.
  2. 2. Read the reviews shown

    Outside amazon.com, the reviews endpoint returns the reviews the product page shows signed-out shoppers, up to about 13, with rating, title, text, date, verified purchase, and the variant bought. Flag the 1- and 2-star ones.

    GET /v1/amazon/reviews?asin=B0CF3VGQFL&country=ca · results.0

    {
      "review_id": "RTVMWBZE2ID5P",
      "title": "Smooooth",
      "body": "TLDR: for the price it’s a nice entry level mechanical keyboard to get into mechanical keyboards without braking the bank.",
      "rating": 5,
      "author": "FreddyTheBearCat",
      "date": "2026-08-03",
      "country": "Canada",
      "verified_purchase": true,
      "variant": "Colour Name: Deep Blacck",
      "helpful_votes_count": null,
      "url": "https://www.amazon.ca/gp/customer-reviews/RTVMWBZE2ID5P"
    }
    Recorded response. Live values differ.
  3. 3. Tie ratings to rank

    The same product response has Best Sellers Rank per category. Ratings falling while rank holds is a warning; both falling is a problem.

    GET /v1/amazon/product?asin=B0CF3VGQFL · product.best_sellers_rank

    [
      {
        "rank": 12,
        "category": "PC Gaming Keyboards"
      }
    ]
    Recorded response. Live values differ.

A script to start from

amazon_ratings.py

# Weekly rating snapshot for your products and competitors on Amazon,
# with the share of 1- and 2-star ratings and any new critical reviews.
import csv, datetime, os, requests

API = "https://api.clair.im"
HEADERS = {"Authorization": f"Bearer {os.environ['CLAIR_API_KEY']}"}
ASINS = ["B0CF3VGQFL", "B004YAVF8I"]
COUNTRY = "gb"  # reviews are not available on amazon.com (us); ratings are

def get(path, **params):
    r = requests.get(f"{API}{path}", headers=HEADERS, timeout=90,
                     params={**params, "country": COUNTRY})
    r.raise_for_status()
    return r.json()

today = datetime.date.today().isoformat()
with open("ratings.csv", "a", newline="") as f:
    out = csv.writer(f)
    for asin in ASINS:
        p = get("/v1/amazon/product", asin=asin)["product"]
        dist = p["rating_distribution"] or []
        low = sum(d["percent"] for d in dist if d["stars"] <= 2)  # percent of ratings
        out.writerow([today, asin, p["rating"], p["ratings_count"], low])
        if COUNTRY == "us":
            continue
        for review in get("/v1/amazon/reviews", asin=asin)["results"]:
            if review["rating"] <= 2:
                print(f"{asin} {review['rating']} stars {review['date']}: {review['title']}")

Set CLAIR_API_KEY to your Clair key; one plan covers the Amazon API. Each call spends that API's rate from the plan's monthly balance.

What it costs per month

ScheduleRequestsPlanPer monthPer 1,000
50 ASINs, weekly50 × 4 weeks × (product + reviews) = 400 requests.400Starter$30$75
500 ASINs on amazon.com, weekly, ratings only500 × 4 weeks × product = 2,000 requests.2,000Starter$30$15
200 ASINs, daily200 × 30 × (product + reviews) = 12,000 requests.12,000Standard$100$8.33
The cheapest Clair plan whose monthly balance covers each volume, every API spending from the same balance. USD, before tax. The free tier is $1 of usage a month, for trying the pipeline.

Response times

Amazon API
Succeeded6 of 7
Median response time15.1 s
95th percentile18.5 s
Had price83%
Had availability100%
Had sold by100%
Had rating100%
Had best sellers rank100%
Had variants83%
Amazon product detail pages on amazon.com, delivery to ZIP 10001. ASINs from the recorded examples. 7 requests, one at a time, on September 27, 2026.

What to plan for

  • amazon.com shows reviews only to signed-in shoppers, so review text is not available for the US marketplace; ratings and the distribution are. Elsewhere the product page shows up to about 13 reviews and puts the full list behind sign-in, so this does not collect every review.
  • The distribution is in whole percentages, so small shifts on products with few ratings are rounding.
  • Ratings and reviews are per marketplace. Check each country separately.

Common questions

Does this work on amazon.com?

The rating, ratings count, and distribution do. Review text does not: amazon.com shows reviews only to signed-in shoppers, and Clair does not sign in, so the reviews endpoint returns 400 for country=us without a charge.

Can I download all reviews for a product?

No. Amazon requires sign-in for the full review list, and Clair does not sign in. Snapshot weekly to collect new reviews as they appear among those shown.

What is the difference between ratings and reviews?

A rating is stars only; a review adds text. ratings_count counts both, and is usually many times the number of written reviews.

How often should I check?

Weekly for most products. Daily for a launch or after a change, when the first reviews come in.

Keep reading

APIs

  • Amazon API

Glossary

  • Rating distribution
  • ASIN
  • Best Sellers Rank
    Clair API

    Live data APIs for search, news, jobs, marketplaces, companies, reviews, and social video, plus a scraper for any public page. Each call fetches the page when you ask.

    contact@serinlabs.com@clair_api

    APIs

    Web Scraping
    • Web Scraper API
    E-commerce
    • Amazon API
      • Amazon Product API
      • Amazon Reviews API
      • Amazon Search API
      • Amazon Price API
      • Amazon Best Sellers API
      • Amazon Seller API
      • Amazon ASIN Lookup API
    • Google Shopping API
    SERP & Search
    • Google Search API
    • Google Maps API
      • Google Maps Scraper API
      • Google Maps Place API
    AI Search
    • ChatGPT API
    • Google AI Overview API
    • Google AI Mode API
    Jobs & Hiring
    • Glassdoor API
      • Glassdoor Jobs API
      • Glassdoor Reviews API
      • Glassdoor Salary API
    • Indeed API
    Company Data & Reviews
    • Trustpilot API
    • Crunchbase API
      • Crunchbase Company API
      • Crunchbase People API
    Video & Social
    • YouTube API
    • TikTok API
    • Instagram API
    News & Media
    • Google News API
    • Reuters API
    • Bloomberg API
    • Associated Press API

    Use cases

    Ecommerce and reviews
    • Amazon price monitoring
    • Trustpilot review monitoring
    • MAP enforcement on Amazon
    • Amazon rating monitoring
    • Amazon category research
    • Trustpilot competitor benchmarking
    • Google Shopping price tracking
    Search and local
    • Google rank tracking
    • Local lead generation
    • Local SEO competitor audit
    • Grounding LLM answers in search results
    • Content research from People also ask
    AI search
    • AI visibility tracking
    • Find the sites AI answers cite
    • AI Overview tracking for SEO keywords
    Leads and companies
    • Account research briefs
    Jobs and hiring
    • Salary benchmarking
    • Job market analytics
    • Employer reputation tracking
    News
    • Brand and media monitoring
    • Financial news tracking
    • News corpus for research and RAG
    Social and video
    • YouTube transcripts for RAG
    • Instagram engagement rate
    • Influencer campaign tracking

    Compare and learn

    Comparisons
    • Clair vs SerpApi
    • Clair vs Google Places API
    • Clair vs Google Custom Search API
    Glossary
    • SERP
    • SERP API
    • People also ask
    • Google place ID
    • ASIN
    • Buy Box
    • All 47 terms
    Developers
    • Documentation
    • Quickstart
    • API catalog
    • Pricing
    • Status
    • All resources
    Featured onCITABLEClair API - Featured on Startup FameFeatured on Twelve Tools Listed on Turbo0 Featured on Wired BusinessClair API on Nick Launches Featured on neeed.directory Featured on DailyPings ShareSpeak on SaaSGrow Startup Benchmarks Featured on LaunchVault Featured on EasyLaunch Featured on SubmitMySaas Featured on DodoDirectory Featured on LaunchZone Featured on LemonLaunch 'LiftOff' Default v2 badge Launched on LaunchBoard - Product Launch Platform Listed on CurlShip aListed onamaze.directory Featured on Brick Launch Featured on saas.fyi Featured on Wall of Tools Featured onfreeboard.lolFeatured on Yo.directory Featured on TheDevToolsIndex
    Featured onCITABLEClair API - Featured on Startup FameFeatured on Twelve Tools Listed on Turbo0 Featured on Wired BusinessClair API on Nick Launches Featured on neeed.directory Featured on DailyPings ShareSpeak on SaaSGrow Startup Benchmarks Featured on LaunchVault Featured on EasyLaunch Featured on SubmitMySaas Featured on DodoDirectory Featured on LaunchZone Featured on LemonLaunch 'LiftOff' Default v2 badge Launched on LaunchBoard - Product Launch Platform Listed on CurlShip aListed onamaze.directory Featured on Brick Launch Featured on saas.fyi Featured on Wall of Tools Featured onfreeboard.lolFeatured on Yo.directory Featured on TheDevToolsIndex
    © 2026 Serin Technologies, LLC
    • About Clair
    • Terms of Service
    • Privacy Policy