Tracker

Tracking endpoint

Endpoint for tracking events such as page views, goal conversions, and custom events.

This endpoint requires the same parameters as the GET request.

Tracking parameters can be provided in three ways:

As a JSON object in the request body (as shown in the example),
As a query string in the request body (e.g., ?idsite=892d04bd-6e2b-4914-bfb4-bac721b37235&url=http%3A%2F%2Fex.com%2F&rec=1),
As a query string in the URL with an empty request body (similar to a GET request but sent using the POST method).

post/ppms.php

Request

Base URL
https://example.piwik.pro
Auth
OAuth 2
Client credentials
Token URL/auth/token
TypeScript
https://skmtc.dev/piwik/apis/web-api/docs/ppms.php/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

requestsstring[] required

List of requests to track (bulk processing).

Example request

{
  "requests": [
    "?idsite=892d04bd-6e2b-4914-bfb4-bac721b37235&url=http%3A%2F%2Fexample.com%2F&action_name=pageview&rec=1",
    "?idsite=892d04bd-6e2b-4914-bfb4-bac721b37235&url=http%3A%2F%2Fexample.com%2Fsub%2Fpage.html&action_name=pageview&rec=1"
  ]
}

Response

Request accepted and waiting for processing

Changes

No recorded changes to this operation across all 2 revisions of this API.