Analytics APIEndpoints

Returns the conversions of a player for each second of the video

Returns, for each second of the video, the conversions whose buyer clicked at that second, with running totals. A conversion is dated by the click that led to it.

POST
/conversions/video_timed

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/conversions/video_timed" \  -H "Content-Type: application/json" \  -d '{    "player_id": "64a5c8072e6fd10009828db2",    "start_date": "2026-09-01 00:00:00",    "end_date": "2026-09-30 23:59:59",    "timezone": "America/Sao_Paulo",    "pitch_time": 300,    "video_duration": 1200  }'
[  {    "timed": 300,    "timed_conversions": 2,    "cumulative_conversions": 2,    "timed_amount_usd": 0,    "cumulative_amount_usd": 0,    "timed_amount_brl": 39400,    "cumulative_amount_brl": 39400,    "timed_amount_eur": 0,    "cumulative_amount_eur": 0  },  {    "timed": 420,    "timed_conversions": 1,    "cumulative_conversions": 3,    "timed_amount_usd": 0,    "cumulative_amount_usd": 0,    "timed_amount_brl": 19700,    "cumulative_amount_brl": 59100,    "timed_amount_eur": 0,    "cumulative_amount_eur": 0  }]