Skip to main content

​
Overview

Cometly’s API offers two methods for retrieving event data: real-time paginated lists and asynchronous exports.
FeaturePaginated ListAsync Export
Data VolumeUp to 4,000 per requestEntire day
FormatJSON (paginated)NDJSON (gzipped)
Use CaseReal-time, interactiveBulk, batch processing
Rate Limit7 requests/min5 creates/min, 30 status checks/min
Date RangeFlexible (any range)Max 1 day per export
Best For< 10,000 events> 10,000 events

​
Export File Format

Exports are delivered as gzipped NDJSON (Newline-Delimited JSON): 
{"id":123,"event_name":"purchase","amount":99.99,"event_time_utc":"2024-01-15T10:23:45Z"}
{"id":124,"event_name":"sign_up","amount":0,"event_time_utc":"2024-01-15T10:24:12Z"}
Each line is a complete JSON object, making it easy to stream and process line-by-line without loading the entire file into memory.

​
See Also