Exports vs Pagination

Overview

Cometly’s API offers two methods for retrieving event data: real-time paginated lists and asynchronous exports.

Feature	Paginated List	Async Export
Data Volume	Up to 4,000 per request	Entire day
Format	JSON (paginated)	NDJSON (gzipped)
Use Case	Real-time, interactive	Bulk, batch processing
Rate Limit	7 requests/min	5 creates/min, 30 status checks/min
Date Range	Flexible (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.

Concepts

Overview

Export File Format

See Also

​Overview

​Export File Format

​See Also

Overview

Export File Format

See Also