Statistics functions

The Revive Adserver REST API provides API calls to retrieve statistics for all of the entities in the application. For your convenience, we’ve grouped the documentation in the following categories:

Note about time zones

It should be noted that the Revive Adserver REST API does not currently support retrieving statistics in any other time zone than UTC. This is a result of the history of how the REST API was developed initially, when it was decided to develop it so that not just the Administrator user type could access it but also all other user types. The consequence of this was that some custom logic was needed, and in the interest of speedy delivery, no code for time zone preferences was included. There have been a few questions about this over the years, and as a result, time zone support has been added to the roadmap.

Note about hourly statistics

It should be noted that the Revive Adserver REST API does not currently support retrieving statistics broken down by hour, whereas this is supported in the web user interface. At the time of the initial development of the REST API, this was deemed not necessary. There have been a few questions about this over the years, and as a result, breaking down statistics by hour has been added to the roadmap.

Current version

The most recently released version of the Revive Adserver REST API is v4.3.0 (publication date May 28, 2018).

See Release Notes

Compatibility

Revive Adserver REST API is compatible with all versions of Revive Adserver v4.0 and higher. It may also be compatible with Revive Adserver v3.x (and also with OpenX Source v2.8 and higher), but this can not be guaranteed.

Revive Adserver REST API is compatible with all supported versions of PHP, including PHP7.

Also see Technical Requirements, Product Content, and Installation Instructions.

Our Recent Tweets