# Export

URL: https://pieowl.com/docs/api/export



Authentication [#authentication]

Requires a `read` or `root` client. The default `write` client does not have access. See the [Authentication](/docs/api/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 [#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]

`/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` |

```bash
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-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](/docs/api-reference).

Other ways to get your data out [#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.