List AI events

Lists the AI Events of a project, the explained spikes in mentions or reach.

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

read

Returns the events marked with the exclamation point on the chart: the date and the explanation Brand24 gives. An empty list means no spike was detected in the range, or the project's plan has no Events.

Parameters

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

Request

cURL
curl https://cotlet.dev/api/v1/brand24/projects/1/events \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("brand24", "list_events", {"project_id":1})
Node.js
const result = await cotlet.call('brand24', 'list_events', {"project_id":1});
CLI
cotlet call brand24 list_events --data '{"project_id":1}'

Example response

JSON

{
  "events": [
    {
      "date": "2026-10-15",
      "description": "Mentions rose after a coffee blog reviewed the new grinder, mostly on news sites and blogs."
    }
  ]
}

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.