Export
Export raw events and chart data from your Pieowl sites with the Export API.
Authentication
Requires a read or root client. The default write client does not have access. See the Authentication guide.
A read client can only export its own site. A root client can export any site in your team by passing its site ID (projectId).
Endpoints
| Endpoint | What it returns |
|---|---|
GET /export/events | A paged list of raw events, with optional filters |
GET /export/charts | Time-series chart data, with optional breakdowns |
Export events
/export/events accepts these query parameters:
| Parameter | Description |
|---|---|
projectId | The site ID of the site to export. Optional for a read client. |
event | Only return events with this name. Repeat it for more names. |
start, end | Date range, for example 2026-09-01 |
profileId | Only return events for one profile |
page | Page number, starting at 1 |
limit | Events per page. Default 50, max 1000. |
filters | JSON array of property filters |
includes | Extra fields to return, comma separated, for example profile,meta,properties,referrer |
curl 'https://api.pieowl.com/export/events?projectId=YOUR_PROJECT_ID&event=signup&start=2026-09-01&end=2026-09-30&limit=100&includes=properties' \
-H 'pieowl-client-id: YOUR_CLIENT_ID' \
-H 'pieowl-client-secret: YOUR_CLIENT_SECRET'The response has a meta object (count, totalCount, pages, current) and a data array with the events.
Export chart data
/export/charts takes a series array. Each item names an event and can add filters, a segment (event, user, session, property_sum and more) and a property. You can also pass range or startDate and endDate, an interval and breakdowns.
For every query parameter and the full response schema, see the API Reference.
Other ways to get your data out
You can also send raw events to your own S3 or Google Cloud Storage bucket. Set this up under Integrations in the dashboard.