• All Articles

Guide to Statistics API for Ad Serving

By Francisco Carvalho

June 1, 2023

In the fast-paced digital advertising industry, being able to quickly and accurately analyze your performance is critical to success. However, given the vast amount of data to manage, analyzing and interpreting it all can be overwhelming without the right tools and resources. This is where our RESTful Statistics API comes in. 

Table of contents:

What is an API?

An API, or Application Programming Interface, is a set of protocols and tools that enable software applications to communicate with each other. APIs provide a standard way for different software systems to interact and exchange data, making it easier for businesses to integrate different applications and services into their workflow.

What is a RESTful API?

A RESTful API, which stands for Representational State Transfer, is a type of API architecture that is widely used for web-based applications. RESTful APIs are designed to be lightweight and scalable, making them an ideal choice for businesses of all sizes.

Normal REST API usage

Example of a normal REST API usage

Why use Statistics APIs?

When it comes to digital advertising, using an API for statistics and reporting can provide both advertisers and publishers with several key benefits. By integrating their data sources with statistics API, businesses can quickly generate insights and reports that help them make data-driven decisions about their advertising campaigns or ad zones.

For example, by using statistics and reporting API, advertisers can monitor the ad performance in real-time, and identify trends and patterns that can inform future advertising strategies. Such API also offers them the flexibility and customization they need to tailor their analytics and reporting solutions to their unique needs and requirements.

Statistics API enables publishers to gain deep insights into the performance of their ad inventory. They can access real-time data on a variety of metrics like impressions, clicks, conversions, CTRs and revenue generated from their ad placements. This level of granular data empowers them to understand which ad formats are performing well and optimize their inventory accordingly. This, in turn, leads to higher user engagement, increased ad performance, and ultimately, revenue growth.

Overall, using a Statistics API can help advertisers and publishers to have full control and visibility over their advertising, and stay ahead of the competition.

EXADS Statistics API request parameters and result data

EXADS offers a full range of APIs and among these, our Statistics API provides businesses with access to a wide range of data and statistics related to their advertising campaigns:

  • Over 25 dimensions
  • Over 50 metrics
  • Over 25 filters

EXADS Statistics API, or Global Statistics API request parameters and result data allows advertisers and publishers to quickly and easily gather real-time insights and information about their campaigns or about their ad inventory, which they can use to optimize their overall performance. 

Request parameters

The Statistics API provides businesses with a range of metrics related to their ad campaigns, including impressions, clicks, conversions, and revenue. These real-time metrics can be filtered and segmented in a variety of ways, allowing for a deep campaign or ad zone performance analysis.

Example of a Statistics API Request:

    "detailed": true,
    "filter": {
        "date_from": "2023-05-01",
        "date_to": "2023-05-30"
    "group_by": [
    "projection": {
        "base": [
    "limit": 10,
    "order_by": [
            "field": "clicks",
            "order": "desc"

In addition to traditional performance metrics, the EXADS Statistics API also provides access to a range of geographic data about audiences. This data can be used to target specific groups of users and optimize ad campaigns for maximum effectiveness, while allowing publishers to offer a better end-user experience for their website visitors.

The API offered by EXADS is also highly customizable, allowing businesses to tailor their analytics solutions to their unique needs and requirements. EXADS Statistics API allows the flexibility to fetch statistics grouped by multiple dimensions at the same time, while also providing the ability to filter this data by criteria such as country or even a single ad zone.

Example of a Statistics API Response:

    "request_metadata": {
        "limit": 2,
        "offset": 0,
        "count": 664175
    "result": [
            "clicks": 420913,
            "group_by": {
                "country_iso": {
                    "country_iso": "JPN",
                    "country_short_name": "Japan",
                    "country_long_name": "Japan"
                "site_id": {
                    "id": "123",
                    "name": "mysite.video"
            "impressions": 6760532
            "clicks": 189366,
            "group_by": {
               "country_iso": {
                    "country_iso": "CHE",
                    "country_short_name": "Switzerland",
                    "country_long_name": "Swiss Confederation"
                "site_id": {
                    "id": "321",
                    "name": "othersite.com"
            "impressions": 121143302

By leveraging this data, advertisers can make informed decisions about their ad spend and drive better results from their campaigns. In addition, publishers can evaluate and identify in real-time the best converting or the most profitable ad zones.

Statistics API use cases

Using filters to segment data

A business can use the filters provided by the API to segment their data based on specific criteria, such as ad placement, geographic location, or time of day. For example, they could retrieve data only for ads that were placed on mobile devices in North America during the evening hours, giving them a better understanding of how their ads are performing in that specific segment.

Using dimensions to analyze ad performance

The dimensions provided by the API can be used to analyze ad performance in a variety of ways. For example, businesses could retrieve data on ad performance broken down by device type, browser, or language, allowing them to gain deeper insights into their audience and how different segments are responding to their ads.

Using the API for real-time monitoring

The Statistics API can also help monitor ad performance in real-time, allowing businesses to make adjustments to their ad strategy as needed. For example, they could set up alerts to notify them when certain metrics, such as CTR or conversion rate, fall below a certain threshold, allowing them to quickly take action to optimize their ad performance.

Benefits of EXADS Statistics API

  • Customizable projections: Retrieve exactly the data that businesses need for their specific use case. By using projections, businesses can define the exact set of data that they want to retrieve from the API, eliminating the need to retrieve and process data that is not relevant to their needs. 
  • Real-time data retrieval: Statistics API provides businesses with real-time data, which means that underperforming campaigns can be quickly identified. These campaigns can then be automatically adjusted with the help of EXADS Automation APIs that allow businesses to set up their own optimization algorithms. 
  • Comprehensive set of metrics: The API provides businesses with over 50 different performance metrics, giving them a comprehensive view of their ad campaign performance.
  • Segment data with dimensions: Businesses can segment their data in a variety of ways using the 25+ dimensions provided, allowing them to gain deeper insights into their audience and ad performance.
  • Customize data retrieval with filters: Businesses can customize their data retrieval based on specific criteria using over 25 different filters, ensuring that they only retrieve the data they need.
  • Efficient and cost-effective: The API is designed to be lightweight and scalable, reducing server and bandwidth resources and providing cost-effective solutions for businesses.
  • RESTful API architecture: The RESTful API architecture ensures that the EXADS Statistics API can handle large amounts of data requests without slowing down or crashing.
  • Higher ROI: By providing businesses with real-time data and customizable projections, the API can help businesses optimize their ad campaigns and achieve a higher return on investment.


Overall, the Statistics API offered by EXADS provides advertisers and publishers with a powerful tool for gathering and analyzing data related to their advertising campaigns. With its ability to provide real-time data and customizable projections, businesses can retrieve only the data that is relevant to their needs and make informed decisions to maximize their ad revenue.

If you are interested in learning more about how the EXADS Statistics API can help your business achieve its advertising goals, please do not hesitate to contact us. Our team of experts is here to help you with any questions you may have and guide you through the process of setting up your own reporting solution or build your own ad platform based on our core modules.

Don't let your advertising business suffer from a lack of insights and data, contact EXADS today!

Share this article on

Francisco Carvalho