AdnovaDocs
Competitor Reviews

Competitor Reviews API

Competitor store reviews — review sources, their products, and the reviews.

The Competitor Reviews API exposes the product reviews Adnova crawls from competitor stores: the review sources (stores) a workspace collects, the products crawled for each source, and the reviews themselves. Only Judge.me, Loox, Okendo and Yotpo stores are crawled.

What you can do

  • List review sources — the stores whose reviews the workspace collects, with brand-name search.
  • List a source's products — the products crawled for a review source, with product-name search.
  • List a source's reviews — optionally for one product and from a minimum star rating.

Typical flow

  1. Pick a store. List review sources returns each source's reviewSourceId.
  2. Pick a product. List a source's products returns each product's productId.
  3. Read the reviews. List a source's reviews, optionally filtered by productId and minRating.

Auth & request context

Every request needs three headers:

api-key: YOUR_KEY_HERE
x-workspace-id: YOUR_WORKSPACE_ID
x-org-id: YOUR_ORG_ID

x-workspace-id and x-org-id are required on every endpoint. The same api-key works across the Adnova APIs; the Competitor Reviews API uses the same access as the Inspiration API — contact Adnova to enable it.

Credits & pricing

Every Competitor Reviews endpoint is free and never consumes credits.

Conventions

  • Pagination — pass metadata.nextPageToken back as pageToken; null means the last page.
  • Rate limits — ~100 requests per minute per user, shared with the Inspiration API.
  • Errors — { "error": { "code", "message" } }. See Rate limits and versioning.