Count reviews

Number of reviews by status and star rating, for a product or a date range.

GET https://cotlet.dev/api/v1/judge-me/reviews/count

read

Returns the total and the split by star rating for the filters you give. Use it to check the size of a job before listing, for example how many pending reviews wait or how large an export will be. It reads counts only and returns no review text.

Parameters

Parameters: count_reviews
NameTypeDescription
status enum enum published, to_curate, hidden or archived. Default: all statuses.
product string string Product title or handle.
since date date Only reviews created on or after this date.

Request

cURL
curl https://cotlet.dev/api/v1/judge-me/reviews/count \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("judge-me", "count_reviews")
Node.js
const result = await cotlet.call('judge-me', 'count_reviews');
CLI
cotlet call judge-me count_reviews

Example response

JSON

{
  "total": 14,
  "by_rating": {
    "1": 3,
    "2": 1,
    "3": 2,
    "4": 3,
    "5": 5
  },
  "status": "to_curate"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.