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
- Pick a store. List review sources returns each source's
reviewSourceId. - Pick a product. List a source's products returns each product's
productId. - Read the reviews. List a source's reviews, optionally filtered by
productIdandminRating.
Auth & request context
Every request needs three headers:
api-key: YOUR_KEY_HERE
x-workspace-id: YOUR_WORKSPACE_ID
x-org-id: YOUR_ORG_IDx-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.nextPageTokenback aspageToken;nullmeans 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.
