Fetch events

post

https://{account}.piwik.pro/api/analytics/v1/events/

API that allows fetching raw events from the database. Please note that
each request must be authenticated.

Compression

When requesting large amount of data, make sure to include
an Accept-Encoding: gzip header to enable
compression.s

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

website_id

uuid

required

ID of a website or a meta site.

columns

array of objects

required

Definitions of additional columns that should be returned (timestamp and
identifiers will be returned by default).

columns*

date_from

Cannot be used with relative_date field at the same time. Mandatory if relative_date is not used.

Start date for the query (inclusive, in website's timezone).

date_to

Cannot be used with relative_date field at the same time. Mandatory if relative_date is not used.

End date (inclusive, in website's timezone).

relative_date

string

enum

Use relative date in query. Cannot be used with absolute date fields at
the same time. X in last_X_days must be in range 1 <= X <= 365.
Note that last_X_days does not include data from today.
Mandatory if absolute date fields are not used.

Allowed:

filters

object

Dimension filters for the query. The top-level object must specify
AND/OR clause, but any nested objects may either specify another AND/OR
clause or a single filter.

offset

integer

≥ 0

Defaults to 0

Number of rows to skip before beginning to return rows.

limit

integer

1 to 100000

Defaults to 100

Number of rows to return.

format

string

enum

Defaults to json

Data format of a successful response (error responses are always in json).

Allowed:

column_format

string

enum

Defaults to id

Format of the columns header (in CSV responses) and metadata labels
(in JSON responses). By default uses identifiers (id option), set to
name to use human-readable names.

Allowed:

Responses

200OK

400Bad Request

401Unauthorized

403Forbidden