Skip to main content

Events

Maps to: events

Events are real-world occurrences — campaigns, product launches, news — that can be overlaid on analyses as annotations. These endpoints let you browse and retrieve them independently of any analysis.

List events​

GET /v1/events

Returns the events available to your account. Optional query parameter:

  • is_listed (true/false) — filter to listed events.

Archived events are excluded.

Get one event​

GET /v1/events/{uuid}

Returns a single event by UUID, including its date and scope.

Relationship to analysis events​

To get only the events relevant to a specific analysis (aligned to its brands, sectors and dates), use the analysis events endpoints instead.