Analytics
Namespace for all routes that are used broadly across vturb, this ultimately delivers the data to the front-end for our clients.
Returns a list with the company active platforms.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
["kiwify","clickfunnels"]Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list with the company conversions grouped by day in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list with the company conversions grouped by timed in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns the number of times the events happened as well as the count considering unique device and sessions
Returns a list with the companies and events with the number of times the event happened in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Names of the events to filter by. Can be ['started', 'finished', 'viewed']
The ID of the player to filter the results by.
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list with the companies grouped by its players and the number of times each event happened for each one in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Names of the events to filter by. Can be ['started', 'finished', 'viewed']
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list with the companies grouped by day and the number of times each event happened for each day in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Names of the events to filter by. Can be ['started', 'finished', 'viewed']
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Provides leaderboard rankings of players based on their video engagement metrics (views, plays, pauses, etc...) within specified time periods. Multiple leaderboards with different player limits can be requested in a single call.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the company to search for
The timezone to use for date calculations (defaults to 'Etc/UCT' if not provided)
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized
Returns an object containing the overall engagement of the users in a given period for the specified player.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
The total duration of the video in seconds
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns an array containing the overall engagement of the users in a given period for the specified player per day.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
The total duration of the video in seconds
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns an array containing the overall engagement of the users in a given period for the specified player per day.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
The field to group the engagement by, possible values are 'country', 'browser', 'device_type', 'utm_campain', 'utm_source', 'utm_medium', 'utm_content', 'utm_term' If 'no_attribution' is passed, all values that have been set to null or that are empty strings will be returned.
The values to filter the field by, for example ['Brazil', 'Romenia'] or ['Chrome', 'Firefox']
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns an array containing the overall engagement of the users in a given period for the specified player per day.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
The query param key to group the engagement by, possible values example: 'utm_campain', 'utm_source', 'utm_medium', 'utm_content', 'utm_term'
The values to filter the query key parameter by, for example ['Facebook', 'Google', 'Campaign 1', 'Campaign 2']
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns an object containing the all the clicks grouped by the time in seconds it happened related to the video.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list with the company clicks grouped by day in a given period.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The timezone to use for the date filtering
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns several statistics used by the headlines dashboard. Engagement, views and play rate are among these metrics
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Start date of the period for event querying.
The player being analysed.
The duration of the video
The time in seconds that the video must be watched to be considered a pitch
Successful operation
If a 400 error occurs, it means parameters were incorrectly passed, and the response body will contain an explanation.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics of sessions for a player given a date range
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The total duration of the video in seconds, if not provided we will use the duration of the video based on our database
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch, if not provided we will use the pitch time of the video based on our database
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics of sessions for a player given a date range by day
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The total duration of the video in seconds, if not provided we will use the duration of the video based on our database
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch, if not provided we will use the pitch time of the video based on our database
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics for sessions grouped by a specified field for a given company and player within a date range.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The field to group the statistics by
The total duration of the video in seconds
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics for sessions grouped by a specified field for a given company and player within a date range and broke by day.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The field to group the statistics by
The total duration of the video in seconds
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns the number of live users for a player
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The ID of the player to search for
65fb3c74ab21c70007b3e0ddThe number of minutes to search for live users, defaults to 60 minutes
60Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics for traffic origin grouped by a specified query key for a given company and player within a date range.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The query key to group the statistics by
The total duration of the video in seconds
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns statistics for traffic origin grouped by a specified query key for a given company and player within a date range and grouped by day.
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The ID of the player to search for
Start date of the period for event querying. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
End date of the period for event querying. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC" or "2023-10-26"
The query keys to group the statistics by
The total duration of the video in seconds
The timezone to use for the date filtering
The time in seconds that the video must be watched to be considered a pitch
Successful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Counts the utms of the given player. The values are src, sck, utm_source, utm_medium, utm_campaign, utm_term, utm_content, among any other valid query parameter
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Start date of the period for event querying.
Start date of the period for event querying.
The player being analysed.
Successful operation
If a 400 error occurs, it means parameters were incorrectly passed, and the response body will contain an explanation.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns several statistics used by the turbo dashboard. Speed, engagement, views, pitch and clicks are among these metrics
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
Start date of the period for event querying.
The player being analysed.
The duration of the video
The time in seconds that the video must be watched to be considered a pitch
Successful operation
If a 400 error occurs, it means parameters were incorrectly passed, and the response body will contain an explanation.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list of all players belonging to the authenticated user's company
Access the application and copy your api token, then, just set the header X-Api-Token with it.
Start date of the period for player filtering. This will be used as >=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
2023-10-26 00:00:00End date of the period for player filtering. This will be used as <=. Format examples "2023-10-26T18:24:05.000+00:00" or "2023-10-26 18:24:05 UTC"
2023-11-26 00:00:00The timezone to use for the date filtering
America/Sao_PauloSuccessful operation
Bad request: the request was bad formatted and some of the arguments were missing or wrong, look at the response body for more information.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Returns a list of all custom metrics of a player and the calculated engagement rate for them
Access the application and copy your api token, then, just set the header X-Api-Token with it.
The API version to use. Currently supported versions are:
- v1: The current stable version
The player being analysed.
Start date of the period for event querying.
End date of the period for event querying.
The timezone to use for the date filtering, if not provided UTC will be used
Successful operation
If a 400 error occurs, it means parameters were incorrectly passed, and the response body will contain an explanation.
Unauthorized, missing proper X-Api-Token or X-Api-Version
Last updated