AdnovaDocs
Competitor Reviews

List a source's reviews

Lists the reviews crawled for a review source, 25 per page, optionally for one product and from a minimum star rating. Pass metadata.nextPageToken back as pageToken for the next page. Free; consumes no credits.

POST
/{reviewSourceId}/reviews

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Path Parameters

reviewSourceId*string

reviewSourceId from POST /competitor-reviews/v1/sources.

Header Parameters

x-org-id*string

Organization ULID that scopes the request.

x-workspace-id*string

Workspace ULID that scopes the request.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/competitor-reviews/v1/string/reviews" \  -H "x-org-id: 01K8Z23F1QQ1ZA93B8WYBS40GH" \  -H "x-workspace-id: 01KJ7S42FHQTCTKD6KKFJKTZBC" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": [
    {
      "reviewId": "01KS9QV0T2YVZ8TA042S5MY5YH",
      "productId": "01KS9QV0T2YVZ8TA042S5MY5YG",
      "productName": "Cork yoga mat",
      "rating": 2,
      "title": "Slippery when wet",
      "body": "Great grip dry, but it slides once my hands sweat.",
      "author": "Dana R.",
      "reviewedAt": "2026-04-02T18:21:00.000Z"
    }
  ],
  "metadata": {
    "nextPageToken": "string",
    "totalRecords": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests."
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}