HomeGuidesAPI reference
Analytics APIEndpoints

Statistics used by the turbo dashboard

Returns one item per Turbo speed of the player, with views, plays, engagement, pitch retention, clicks and conversions. Dates are read in UTC. If the player does not exist in the company, the response is `400` with `{"error": ["Player could not be found for the current request"]}`.

POST
/turbo/stats_by_player

Authorization

apiToken apiVersion userAgent
X-Api-Token<token>

Access the application and copy your api token, then, just set the header X-Api-Token with it.

In: header

X-Api-Version<token>

The API version to use. Currently supported versions are:

  • v1: The current stable version

A request without this header, or with any other value, is answered by the edge with 404 and {"error_msg":"404 Route Not Found"}.

In: header

User-Agent<token>

A non-empty User-Agent identifying your integration is required. Requests without it are rejected at the edge before reaching the API.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/turbo/stats_by_player" \  -H "Content-Type: application/json" \  -d '{    "start_date": "2026-09-01 00:00:00",    "end_date": "2026-09-30 23:59:59",    "player_id": "64a5c8072e6fd10009828db2",    "video_duration": 1200,    "pitch_time": 300  }'
[  {    "speed": 1,    "views": 150,    "plays": 60,    "engagement": 0.38,    "pitch": 0.21,    "clicks": 9,    "conversions": 2,    "amount_brl": 39400,    "amount_usd": 0,    "amount_eur": 0,    "conversion_rate": 3.51  },  {    "speed": 1.2,    "views": 148,    "plays": 57,    "engagement": 0.41,    "pitch": 0.24,    "clicks": 11,    "conversions": 3,    "amount_brl": 59100,    "amount_usd": 0,    "amount_eur": 0,    "conversion_rate": 5.56  }]

Counts the query parameters recorded for a player POST

Returns how many times each query parameter of the page URL was recorded for the player, such as `utm_source`, `utm_campaign`, `src` or `sck`. Any query parameter is counted, not only UTMs.

List all players GET

Returns the players of the company of the API key, with the duration of their video and their pitch time. Deleted players are not listed.