Get project stats

Returns mentions, reach and sentiment of a project for a date range.

GET https://cotlet.dev/api/v1/brand24/projects/{project_id}/stats

read

Returns the totals the Mentions & Reach and Sentiment charts show for the range: mentions, social and non-social reach, and the positive, neutral and negative counts. Use it before and after a cleanup to show the effect.

Parameters

Parameters: get_project_stats
NameTypeDescription
project_id integer required integer Project ID from list_projects.
date_from string required string Start of the date range, YYYY-MM-DD.
date_to string required string End of the date range, YYYY-MM-DD.

Request

cURL
curl "https://cotlet.dev/api/v1/brand24/projects/1/stats?date_from=date+from&date_to=date+to" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("brand24", "get_project_stats", {"project_id":1,"date_from":"date from","date_to":"date to"})
Node.js
const result = await cotlet.call('brand24', 'get_project_stats', {"project_id":1,"date_from":"date from","date_to":"date to"});
CLI
cotlet call brand24 get_project_stats --data '{"project_id":1,"date_from":"date from","date_to":"date to"}'

Example response

JSON

{
  "project_id": 123456789,
  "date_from": "2026-10-12",
  "date_to": "2026-10-18",
  "mentions": 315,
  "reach": {
    "social": 410000,
    "non_social": 2150000
  },
  "sentiment": {
    "positive": 120,
    "neutral": 150,
    "negative": 45
  }
}

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.