{"id":5244,"date":"2024-08-14T12:24:07","date_gmt":"2024-08-14T09:24:07","guid":{"rendered":"https:\/\/adsterra.com\/blog\/?p=5244"},"modified":"2026-06-18T13:31:49","modified_gmt":"2026-06-18T10:31:49","slug":"how-to-use-adsterra-publishers-api","status":"publish","type":"post","link":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/","title":{"rendered":"Adsterra Publisher API: Easily Pull Data to Power Your Monetization Strategy"},"content":{"rendered":"\n

Many websites, many ads, and many stats. It’s easy to get confused by the data and waste hours checking every ad code. Adsterra Publisher API<\/strong> is a solution for those who need to flawlessly track every ad placement.<\/p>\n\n\n\n

With API, website owners save hours pulling metrics like CPM, clicks, or revenue. They use a fantastic hack of using one Smartlink on several pages! If you, too, want to enhance your monetization strategy, check out this post and grab practical tips!<\/p>\n\n\n\n

<\/div>\n\n\n\n

What is the Adsterra Publisher API?<\/strong><\/h2>\n\n\n\n
<\/div>\n\n\n\n
\n

API<\/strong><\/em> \u2014 the acronym for Application Programming Interface \u2014 is a means of communication between applications. Rephrasing this, API requests data from Adsterra and displays it in a publisher’s application or platform.<\/i><\/p>\n<\/blockquote>\n\n\n\n

<\/div>\n\n\n\n

Publishers automate monetization tasks by only telling Adsterra to send the correct data to the right place in the correct order and at the correct frequency. You keep control over the core metrics across all domains.<\/b><\/p>\n\n\n\n

To make it all happen, you need to know how to call out to the API and how to make it pull the stats. So let\u2019s dive into some tech stuff and find out which datasets you can get.<\/p>\n\n\n\n

<\/div>\n\n\n\n
\"\"\/<\/figure>\n\n\n\n
<\/div>\n\n\n\n

Data you can retrieve with API<\/strong><\/h2>\n\n\n\n
<\/div>\n\n\n\n
    \n
  1. Websites you added to Adsterra, including their names and unique IDs.<\/li>\n\n\n\n
  2. Ad placements on every website added to your account.<\/li>\n\n\n\n
  3. A list of placements on all websites.<\/li>\n\n\n\n
  4. A list of your Smartlinks with current stats reports and performance metrics.<\/li>\n\n\n\n
  5. A report containing the following metrics: impressions, clicks, CTR, CPM, and revenue by date.<\/li>\n\n\n\n
  6. You can also specify a domain_id, placement_id and placement_sub_id, start and finish dates, as well as a specific GEO.<\/li>\n<\/ol>\n\n\n\n
    <\/div>\n\n\n\n
    \n

    For now, Adsterra Publishers API supports only the <\/i>GET method<\/i><\/b>. This means that you can get the data without changing its structure or quantity.<\/i><\/p>\n<\/blockquote>\n\n\n\n

    <\/div>\n\n\n\n

    How to apply API: Top use cases from publishers<\/strong><\/h2>\n\n\n\n

    These are not only CPM rates you can monitor regularly. Let\u2019s explore how publishers automate their business with the Adsterra Publisher API. Here are some of the popular use cases:<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    1. Control how every ad placement performs<\/b><\/h3>\n\n\n\n

    Imagine you run 20 websites with 40 ad placements (Popunders and Banners). You add one more Banner on a main page of one of these sites. With API, you can get critical stats, grouping them by placements inside every domain:<\/b> impressions, clicks, CTR, and revenue.<\/p>\n\n\n\n

    We’ll lay out a more detailed example for this case in the Practice chapter.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    2. Check best-performing countries to add more traffic<\/b><\/h3>\n\n\n\n

    Group stats by country to catch which geos deliver the highest revenue on every website.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    \"\"\/<\/figure>\n\n\n\n
    <\/div>\n\n\n\n

    Grouping filters will help you out when you need to focus on dates, domains, and placements, as well.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    3. Place and manage multiple Smartlinks outside Adsterra<\/b><\/h3>\n\n\n\n

    Many publishers monetize multi-page websites, putting Smartlinks on all pages. They need to generate a unique code for every page to get correct stats. But with Adsterra Publisher API, you can easily create a unique code. Simply add a placement_sub_id <\/i>parameter to any of your URLs.<\/p>\n\n\n\n

    Another opportunity is retrieving a list of all your Smartlinks<\/a> via the GET request to manage them and collect statistics without logging in to Adsterra or contacting support.<\/p>\n\n\n\n

    <\/div>\n\n\n\n
    \n

    Smartlink<\/i><\/a> is a simple URL you place inside the content. It looks like a hyperlink. Every user click opens up a new advertisement. A placement_sub_id parameter will make one URL taken from Adsterra unique and easy to track.<\/i><\/p>\n<\/blockquote>\n\n\n\n

    <\/div>\n\n\n\n

    Getting started with the Adsterra Publisher API<\/strong><\/h2>\n\n\n\n
    <\/div>\n\n\n\n

    Our API is free of charge, and any publisher can benefit from it. To access all our features, follow this short instruction:<\/p>\n\n\n\n