{"id":5244,"date":"2024-08-14T12:24:07","date_gmt":"2024-08-14T09:24:07","guid":{"rendered":"https:\/\/adsterra.com\/blog\/?p=5244"},"modified":"2025-09-12T14:05:35","modified_gmt":"2025-09-12T11:05:35","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":"\t\t<div data-elementor-type=\"wp-post\" data-elementor-id=\"5244\" class=\"elementor elementor-5244\">\n\t\t\t\t\t\t<section class=\"penci-section penci-disSticky penci-structure-10 elementor-section elementor-top-section elementor-element elementor-element-6b054223 elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"6b054223\" data-element_type=\"section\">\n\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"penci-ercol-100 penci-ercol-order-1 penci-sticky-ct    elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-5bd5fcd\" data-id=\"5bd5fcd\" data-element_type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-280a515c elementor-widget elementor-widget-text-editor\" data-id=\"280a515c\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">Many websites, many ads, and many stats. It&#8217;s easy to get confused by the data and waste hours checking every ad code. <strong>Adsterra Publisher API<\/strong> is a solution for those who need to flawlessly track every ad placement.<\/span><\/p><p>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>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b9c5e79 elementor-widget elementor-widget-menu-anchor\" data-id=\"b9c5e79\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"what-is-api\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-49a2807 elementor-widget elementor-widget-text-editor\" data-id=\"49a2807\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>What is the Adsterra Publisher API?<\/strong><\/h2><blockquote style=\"font-size: 16px;\"><p><em><span style=\"font-weight: 400;\"><strong>API<\/strong><\/span><\/em><i><span style=\"font-weight: 400;\"> \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&#8217;s application or platform.<\/span><\/i><\/p><\/blockquote><p><span style=\"font-weight: 400;\">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. <\/span><b>You keep control over the core metrics across all domains.<\/b><\/p><p><span style=\"font-weight: 400;\">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.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ef837e6 elementor-widget elementor-widget-image\" data-id=\"ef837e6\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img fetchpriority=\"high\" decoding=\"async\" width=\"780\" height=\"362\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics-780x362.png\" class=\"attachment-large size-large wp-image-32147\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics-780x362.png 780w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics-300x139.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics-768x356.png 768w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics-585x272.png 585w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-basics.png 1170w\" sizes=\"(max-width: 780px) 100vw, 780px\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-0475559 elementor-widget elementor-widget-spacer\" data-id=\"0475559\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-72bc0f3 elementor-widget elementor-widget-menu-anchor\" data-id=\"72bc0f3\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"data-to-retrieve\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-2dbd10b elementor-widget elementor-widget-text-editor\" data-id=\"2dbd10b\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>Data you can retrieve with API<\/strong><\/h2><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Websites you added to Adsterra, including their names and unique IDs.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Ad placements on every website added to your account.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A list of placements on all websites.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A list of your Smartlinks with current stats reports and performance metrics.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A report containing the following metrics: impressions, clicks, CTR, CPM, and revenue by date.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">You can also specify a domain_id, placement_id and placement_sub_id, start and finish dates, as well as a specific GEO.<\/span><\/li><\/ol><blockquote><p><i><span style=\"font-weight: 400;\">For now, Adsterra Publishers API supports only the <\/span><\/i><b><i>GET method<\/i><\/b><i><span style=\"font-weight: 400;\">. This means that you can get the data without changing its structure or quantity.<\/span><\/i><\/p><\/blockquote>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-fcbf24f elementor-widget elementor-widget-spacer\" data-id=\"fcbf24f\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-e558a5b elementor-widget elementor-widget-menu-anchor\" data-id=\"e558a5b\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"publisher-api-use-cases\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f0fae96 elementor-widget elementor-widget-text-editor\" data-id=\"f0fae96\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>How to apply API: Top use cases from publishers<\/strong><\/h2><p><span style=\"font-weight: 400;\">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:<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-392971c elementor-widget elementor-widget-spacer\" data-id=\"392971c\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ea8120c elementor-widget elementor-widget-text-editor\" data-id=\"ea8120c\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><b>1. Control how every ad placement performs<\/b><\/h3><p><span style=\"font-weight: 400;\">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. <\/span><b>With API, you can get critical stats, grouping them by placements inside every domain:<\/b><span style=\"font-weight: 400;\"> impressions, clicks, CTR, and revenue.<\/span><\/p><p><span style=\"font-weight: 400;\">We&#8217;ll lay out a more detailed example for this case in the Practice chapter.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a391741 elementor-widget elementor-widget-spacer\" data-id=\"a391741\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-dfe2455 elementor-widget elementor-widget-text-editor\" data-id=\"dfe2455\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><b>2. Check best-performing countries to add more traffic<\/b><\/h3><p><span style=\"font-weight: 400;\">Group stats by country to catch which geos deliver the highest revenue on every website.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-03aeac8 elementor-widget elementor-widget-image\" data-id=\"03aeac8\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img decoding=\"async\" width=\"594\" height=\"192\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by.png\" class=\"attachment-full size-full wp-image-32109\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by.png 594w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-300x97.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-585x189.png 585w\" sizes=\"(max-width: 594px) 100vw, 594px\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8996e76 elementor-widget elementor-widget-spacer\" data-id=\"8996e76\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-a5e3149 elementor-widget elementor-widget-text-editor\" data-id=\"a5e3149\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">Grouping filters will help you out when you need to focus on dates, domains, and placements, as well.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9d17fa9 elementor-widget elementor-widget-spacer\" data-id=\"9d17fa9\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-3c9cf10 elementor-widget elementor-widget-text-editor\" data-id=\"3c9cf10\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><b>3. Place and manage multiple Smartlinks outside Adsterra<\/b><\/h3><p><span style=\"font-weight: 400;\">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 <\/span><i><span style=\"font-weight: 400;\">placement_sub_id <\/span><\/i><span style=\"font-weight: 400;\">parameter to any of your URLs.<\/span><\/p><p>Another opportunity is <a href=\"https:\/\/docs.adsterratools.com\/public\/v3\/publishers-api\/operations\/get-smart-links\" target=\"_blank\" rel=\"noopener\">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><blockquote><p><a href=\"https:\/\/blogdev.adsterratech.com\/blog\/guide-for-working-with-direct-links\/\" target=\"_blank\" rel=\"noopener\"><i><span style=\"font-weight: 400;\">Smartlink<\/span><\/i><\/a><i><span style=\"font-weight: 400;\"> 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.<\/span><\/i><\/p><\/blockquote>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1159888 elementor-widget elementor-widget-spacer\" data-id=\"1159888\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c0130f4 elementor-widget elementor-widget-menu-anchor\" data-id=\"c0130f4\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"how-to-start-using-adsterra-publishers-api\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6f7e954 elementor-widget elementor-widget-text-editor\" data-id=\"6f7e954\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>Getting started with the Adsterra Publisher API<\/strong><\/h2><p><span style=\"font-weight: 400;\">Our API is free of charge, and any publisher can benefit from it. To access all our features, follow this short instruction:<\/span><\/p><ul><li><span style=\"font-weight: 400;\">To send API requests, first, <a href=\"https:\/\/beta.publishers.adsterra.com\/signup\/\" target=\"_blank\" rel=\"noopener\">register as Adsterra\u2019s publisher.<\/a><\/span><\/li><li><span style=\"font-weight: 400;\">Add a website with any of the following ad units: Popunder, Social Bar, Native Banner, Banner, or Smartlink.<\/span><\/li><\/ul><blockquote><p><i><span style=\"font-weight: 400;\">Check the<\/span><\/i><a href=\"https:\/\/blogdev.adsterratech.com\/blog\/set-up-publishers-dashboard\/\"><i><span style=\"font-weight: 400;\"> guide for adding websites<\/span><\/i><\/a><i><span style=\"font-weight: 400;\"> and generating ad codes if you\u2019re new to Adsterra.<\/span><\/i><\/p><p><i><span style=\"font-weight: 400;\">If you already run websites on Adsterra, skip this part and jump forward.<\/span><\/i><\/p><\/blockquote><ul><li><span style=\"font-weight: 400;\">The website and ad units you will track via API must be Active.<\/span><\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6df2050 elementor-widget elementor-widget-image\" data-id=\"6df2050\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a href=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status.png\" data-rel=\"penci-gallery-image-content\"  data-elementor-open-lightbox=\"yes\" data-elementor-lightbox-title=\"active-status\" data-e-action-hash=\"#elementor-action%3Aaction%3Dlightbox%26settings%3DeyJpZCI6MzIxMTMsInVybCI6Imh0dHBzOlwvXC9ibG9nZGV2LmFkc3RlcnJhdGVjaC5jb21cL2Jsb2dcL3dwLWNvbnRlbnRcL3VwbG9hZHNcLzIwMjBcLzExXC9hY3RpdmUtc3RhdHVzLnBuZyJ9\"><img decoding=\"async\" width=\"1551\" height=\"295\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status.png\" class=\"attachment-full size-full wp-image-32113\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status.png 1551w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-300x57.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-780x148.png 780w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-768x146.png 768w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-1536x292.png 1536w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-1170x223.png 1170w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/active-status-585x111.png 585w\" sizes=\"(max-width: 1551px) 100vw, 1551px\" \/>\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ea66e36 elementor-widget elementor-widget-spacer\" data-id=\"ea66e36\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-080d634 elementor-widget elementor-widget-text-editor\" data-id=\"080d634\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<ul><li><span style=\"font-weight: 400;\">Navigate the API page from your account and hit the GENERATE NEW TOKEN button.<\/span><\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-accd14c elementor-widget elementor-widget-image\" data-id=\"accd14c\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a href=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token.png\" data-rel=\"penci-gallery-image-content\"  data-elementor-open-lightbox=\"yes\" data-elementor-lightbox-title=\"generate-api-token\" data-e-action-hash=\"#elementor-action%3Aaction%3Dlightbox%26settings%3DeyJpZCI6MzIxMTUsInVybCI6Imh0dHBzOlwvXC9ibG9nZGV2LmFkc3RlcnJhdGVjaC5jb21cL2Jsb2dcL3dwLWNvbnRlbnRcL3VwbG9hZHNcLzIwMjBcLzExXC9nZW5lcmF0ZS1hcGktdG9rZW4ucG5nIn0%3D\"><img loading=\"lazy\" decoding=\"async\" width=\"1876\" height=\"676\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token.png\" class=\"attachment-full size-full wp-image-32115\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token.png 1876w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-300x108.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-780x281.png 780w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-768x277.png 768w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-1536x553.png 1536w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-1170x422.png 1170w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/generate-api-token-585x211.png 585w\" sizes=\"(max-width: 1876px) 100vw, 1876px\" \/>\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-48ea815 elementor-widget elementor-widget-spacer\" data-id=\"48ea815\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-74ec579 elementor-widget elementor-widget-text-editor\" data-id=\"74ec579\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">Save this token. You will then add to an API request, connecting your platform with your Adsterra publisher\u2019s account. In the following chapter, we\u2019ll learn how to create such requests.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-0c4d07c elementor-widget elementor-widget-spacer\" data-id=\"0c4d07c\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-df2c27e elementor-widget elementor-widget-menu-anchor\" data-id=\"df2c27e\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"api-requests-basics\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5a78ad6 elementor-widget elementor-widget-text-editor\" data-id=\"5a78ad6\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>API requests basics<\/strong><\/h2><p><span style=\"font-weight: 400;\">When you request data, you address the Adsterra server:<\/span><\/p><p><span style=\"color: #3366ff;\">https:\/\/api3.adsterratools.com\/publisher<\/span><\/p><p><strong>Every request contains:<\/strong><\/p><ol><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">A unique token you generate on your Adsterra account (see the previous chapter). It\u2019s also called the API Key.\u00a0<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Parameters, or which data you want Adsterra to return.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Format <\/span><span style=\"font-weight: 400;\">(JSON, CSV, XML)<\/span><\/li><\/ol><p><span style=\"font-weight: 400;\">Here is an example of a request in PHP where we request a full list of websites (domains) added to Adsterra. We request the CSV format and place the X-API-Key (or token) in the Header part:<\/span><\/p><pre><span style=\"color: #3366ff;\">&lt;?php<\/span><br \/><span style=\"color: #3366ff;\">$client = new \\GuzzleHttp\\Client();<\/span><br \/><span style=\"color: #3366ff;\">$response = $client-&gt;request('GET', 'https:\/\/api3.adsterratools.com\/publisher\/domains.csv', [<\/span><br \/><span style=\"color: #3366ff;\">'headers' =&gt; [<\/span><br \/><span style=\"color: #3366ff;\">'Accept' =&gt; 'application\/json',<\/span><br \/><span style=\"color: #3366ff;\">'X-API-Key' =&gt; '123',<\/span><br \/><span style=\"color: #3366ff;\">],<\/span><br \/><span style=\"color: #3366ff;\">]);<\/span><br \/><span style=\"color: #3366ff;\">echo $response-&gt;getBody();<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-cd4ae97 elementor-widget elementor-widget-spacer\" data-id=\"cd4ae97\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-cc828fb elementor-widget elementor-widget-menu-anchor\" data-id=\"cc828fb\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"common-api-requests\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-38d0607 elementor-widget elementor-widget-text-editor\" data-id=\"38d0607\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>Practice: Common API requests<\/strong><\/h2><p><span style=\"font-weight: 400;\">Let\u2019s now walk through a couple more examples of common requests publishers send to our server. To make all our examples more illustrative, we will see how data retrieving looks in real life.<\/span><\/p><p>You can jump to <a href=\"https:\/\/docs.adsterratools.com\/public\/v3\/publishers-api\/\" target=\"_blank\" rel=\"noopener nofollow\">Adsterra\u2019s documentation<\/a> and test various requests. You will need now to paste the API key (or token) obtained before to the appropriate field:<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-4d67360 elementor-widget elementor-widget-image\" data-id=\"4d67360\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<img loading=\"lazy\" decoding=\"async\" width=\"437\" height=\"388\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/testing-api-requests-1.png\" class=\"attachment-full size-full wp-image-32119\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/testing-api-requests-1.png 437w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/testing-api-requests-1-300x266.png 300w\" sizes=\"(max-width: 437px) 100vw, 437px\" \/>\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-58d3eb7 elementor-widget elementor-widget-spacer\" data-id=\"58d3eb7\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9c5a978 elementor-widget elementor-widget-menu-anchor\" data-id=\"9c5a978\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"group-by-placement\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b9443a0 elementor-widget elementor-widget-text-editor\" data-id=\"b9443a0\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><strong>1. Grouping stats by ad placements<\/strong><\/h3>\n<span style=\"font-weight: 400;\">Remember one of the use cases for controlling all placements&#8217; performance? Let&#8217;s examine it in more detail. Go to the<\/span><a href=\"https:\/\/docs.adsterratools.com\/public\/v3\/publishers-api\/operations\/get-statistics\" target=\"_blank\" rel=\"noopener nofollow\"> <span style=\"font-weight: 400;\">Get Statistics page<\/span><\/a><span style=\"font-weight: 400;\"> of the Adsterra Publisher API documentation. Here, you can check all the parameters to modify the final response. Include <\/span><b>domain ID<\/b><span style=\"font-weight: 400;\"> and <\/span><b>placement ID in your request, and finally,<\/b><span style=\"font-weight: 400;\"> choose the <\/span><b>group_by placement <\/b><span style=\"font-weight: 400;\">option.<\/span>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c62d7cf elementor-widget elementor-widget-image\" data-id=\"c62d7cf\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a href=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement.png\" data-rel=\"penci-gallery-image-content\"  data-elementor-open-lightbox=\"yes\" data-elementor-lightbox-title=\"group-by-placement\" data-e-action-hash=\"#elementor-action%3Aaction%3Dlightbox%26settings%3DeyJpZCI6MzIxMjMsInVybCI6Imh0dHBzOlwvXC9ibG9nZGV2LmFkc3RlcnJhdGVjaC5jb21cL2Jsb2dcL3dwLWNvbnRlbnRcL3VwbG9hZHNcLzIwMjBcLzExXC9ncm91cC1ieS1wbGFjZW1lbnQucG5nIn0%3D\"><img loading=\"lazy\" decoding=\"async\" width=\"1886\" height=\"872\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement.png\" class=\"attachment-full size-full wp-image-32123\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement.png 1886w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-300x139.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-780x361.png 780w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-768x355.png 768w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-1536x710.png 1536w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-1170x541.png 1170w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-placement-585x270.png 585w\" sizes=\"(max-width: 1886px) 100vw, 1886px\" \/>\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5a516bd elementor-widget elementor-widget-spacer\" data-id=\"5a516bd\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-887f980 elementor-widget elementor-widget-text-editor\" data-id=\"887f980\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">The request you send to Adsterra may look like this (PHP):<\/span><\/p><pre><span style=\"color: #3366ff;\">&lt;?php<\/span><br \/><span style=\"color: #3366ff;\">$client = new \\GuzzleHttp\\Client();<\/span><br \/><span style=\"color: #3366ff;\">$response = $client-&gt;request('GET', 'https:\/\/api3.adsterratools.com\/publisher\/stats.json??domain=domain_id&amp;placement=placement_id&amp;start_date=2022-03-06&amp;finish_date=2022-03-06&amp;group_by=placement&amp;country=country', [<\/span><br \/><span style=\"color: #3366ff;\">'headers' =&gt; [<\/span><br \/><span style=\"color: #3366ff;\">'Accept' =&gt; 'application\/json',<\/span><br \/><span style=\"color: #3366ff;\">'X-API-Key' =&gt; '123',<\/span><br \/><span style=\"color: #3366ff;\">],<\/span><br \/><span style=\"color: #3366ff;\">]);<\/span><br \/><span style=\"color: #3366ff;\">echo $response-&gt;getBody();<\/span><\/pre><p><span style=\"font-weight: 400;\">The same request when using JavaScript Fetch:<\/span><\/p><pre><span style=\"color: #3366ff;\">const settings = {<\/span><br \/><span style=\"color: #3366ff;\">async: true,<\/span><br \/><span style=\"color: #3366ff;\">crossDomain: true,<\/span><br \/><span style=\"color: #3366ff;\">url: 'https:\/\/api3.adsterratools.com\/publisher\/stats.json?domain=domain_id&amp;placement=placement_id&amp;start_date=2022-03-06&amp;finish_date=2022-03-06&amp;group_by=placement&amp;country=country',<\/span><br \/><span style=\"color: #3366ff;\">method: 'GET',<\/span><br \/><span style=\"color: #3366ff;\">headers: {<\/span><br \/><span style=\"color: #3366ff;\">Accept: 'application\/json',<\/span><br \/><span style=\"color: #3366ff;\">'X-API-Key': '123'<\/span><br \/><span style=\"color: #3366ff;\">}<\/span><br \/><span style=\"color: #3366ff;\">};<\/span><br \/><span style=\"color: #3366ff;\">$.ajax(settings).done(function (response) {<\/span><br \/><span style=\"color: #3366ff;\">console.log(response);<\/span><br \/><span style=\"color: #3366ff;\">});<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-475902a elementor-widget elementor-widget-spacer\" data-id=\"475902a\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5ff8eb5 elementor-widget elementor-widget-menu-anchor\" data-id=\"5ff8eb5\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"group-by-country\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f97511c elementor-widget elementor-widget-text-editor\" data-id=\"f97511c\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><strong>2. Grouping stats by country<\/strong><\/h3><p><span style=\"font-weight: 400;\">You can pull stats reports, grouping core metrics by country, in almost the same way we&#8217;ve just done. Include the <\/span><i><span style=\"font-weight: 400;\">group_by=country <\/span><\/i><span style=\"font-weight: 400;\">query<\/span> <span style=\"font-weight: 400;\">parameter in your request.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-8eb458f elementor-widget elementor-widget-image\" data-id=\"8eb458f\" data-element_type=\"widget\" data-widget_type=\"image.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<a href=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country.png\" data-rel=\"penci-gallery-image-content\"  data-elementor-open-lightbox=\"yes\" data-elementor-lightbox-title=\"group-by-country\" data-e-action-hash=\"#elementor-action%3Aaction%3Dlightbox%26settings%3DeyJpZCI6MzIxMjQsInVybCI6Imh0dHBzOlwvXC9ibG9nZGV2LmFkc3RlcnJhdGVjaC5jb21cL2Jsb2dcL3dwLWNvbnRlbnRcL3VwbG9hZHNcLzIwMjBcLzExXC9ncm91cC1ieS1jb3VudHJ5LnBuZyJ9\"><img loading=\"lazy\" decoding=\"async\" width=\"1892\" height=\"857\" src=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country.png\" class=\"attachment-full size-full wp-image-32124\" alt=\"\" srcset=\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country.png 1892w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-300x136.png 300w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-780x353.png 780w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-768x348.png 768w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-1536x696.png 1536w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-1170x530.png 1170w, https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/group-by-country-585x265.png 585w\" sizes=\"(max-width: 1892px) 100vw, 1892px\" \/>\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9984e2c elementor-widget elementor-widget-spacer\" data-id=\"9984e2c\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f408a7d elementor-widget elementor-widget-text-editor\" data-id=\"f408a7d\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">Here\u2019s how the final request may look like if sent in PHP:<\/span><\/p><pre><span style=\"color: #3366ff;\">&lt;?php<\/span><br \/><span style=\"color: #3366ff;\">$client = new \\GuzzleHttp\\Client();<\/span><br \/><span style=\"color: #3366ff;\">$response = $client-&gt;request('GET', 'https:\/\/api3.adsterratools.com\/publisher\/stats.json?domain=domain_id&amp;placement=placement_id&amp;start_date=2022-03-06&amp;finish_date=2022-03-06&amp;group_by=country&amp;country=country', [<\/span><br \/><span style=\"color: #3366ff;\">'headers' =&gt; [<\/span><br \/><span style=\"color: #3366ff;\">'Accept' =&gt; 'application\/json',<\/span><br \/><span style=\"color: #3366ff;\">'X-API-Key' =&gt; '123',<\/span><br \/><span style=\"color: #3366ff;\">],<\/span><br \/><span style=\"color: #3366ff;\">]);<\/span><br \/><span style=\"color: #3366ff;\">echo $response-&gt;getBody();<\/span><\/pre><p><span style=\"font-weight: 400;\">The same request for JavaScript Fetch:<\/span><\/p><pre><span style=\"color: #3366ff;\">const settings = {<\/span><br \/><span style=\"color: #3366ff;\">async: true,<\/span><br \/><span style=\"color: #3366ff;\">crossDomain: true,<\/span><br \/><span style=\"color: #3366ff;\">url: 'https:\/\/api3.adsterratools.com\/publisher\/stats.json?domain=domain_id&amp;placement=placement_id&amp;start_date=2022-03-06&amp;finish_date=2022-03-06&amp;group_by=country&amp;country=country',<\/span><br \/><span style=\"color: #3366ff;\">method: 'GET',<\/span><br \/><span style=\"color: #3366ff;\">headers: {<\/span><br \/><span style=\"color: #3366ff;\">Accept: 'application\/json',<\/span><br \/><span style=\"color: #3366ff;\">'X-API-Key': '123'<\/span><br \/><span style=\"color: #3366ff;\">}<\/span><br \/><span style=\"color: #3366ff;\">};<\/span><br \/><span style=\"color: #3366ff;\">$.ajax(settings).done(function (response) {<\/span><br \/><span style=\"color: #3366ff;\">console.log(response);<\/span><br \/><span style=\"color: #3366ff;\">});<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b3c1745 elementor-widget elementor-widget-spacer\" data-id=\"b3c1745\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9f50f9b elementor-widget elementor-widget-menu-anchor\" data-id=\"9f50f9b\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"subid-parameter\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6068bf9 elementor-widget elementor-widget-text-editor\" data-id=\"6068bf9\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h3><strong>3. Placing one Smartlink on several site pages<\/strong><\/h3><p><span style=\"font-weight: 400;\">API allows you to add a unique parameter to a Smartlink URL. You need to attach a <em>placement_sub_id<\/em> to the URL. Here&#8217;s a step-by-step guide.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-6441eb8 elementor-widget elementor-widget-spacer\" data-id=\"6441eb8\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ecb5f6c elementor-widget elementor-widget-text-editor\" data-id=\"ecb5f6c\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h4><b>The Sub ID parameter<\/b><\/h4><p><span style=\"font-weight: 400;\">A <\/span><b>Sub ID<\/b><span style=\"font-weight: 400;\"> parameter is a unique identifier you add to a URL link. The URL structure doesn\u2019t change, it\u2019s only one new parameter added. The Sub ID allows tracking the performance of the same Smartlink placed on different websites or pages.<\/span><\/p><p><strong>Where to place the Sub ID parameter?<\/strong><\/p><p><span style=\"font-weight: 400;\">Put the <\/span><span style=\"font-weight: 400;\"><em>&amp;psid=sub_id<\/em>_1<\/span><span style=\"font-weight: 400;\"> to the end of your Smartlink URL link, where <\/span><span style=\"font-weight: 400;\">sub_id_1<\/span><span style=\"font-weight: 400;\"> is your unique identifier. Compose it using letters, numbers, or both.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-493eecb elementor-widget elementor-widget-spacer\" data-id=\"493eecb\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ea8da58 elementor-widget elementor-widget-text-editor\" data-id=\"ea8da58\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h4><b>How to use the Sub ID in Publisher API requests<\/b><\/h4><p><span style=\"font-weight: 400;\">Here\u2019s an example of a query to get statistics grouped by the Sub ID parameter:<\/span><\/p><p><b>1.\u00a0 Add Sub ID to URL<\/b><span style=\"font-weight: 400;\">:<\/span><\/p><ul><li><span style=\"font-weight: 400;\">Append <\/span><em><span style=\"font-weight: 400;\">&amp;psid=sub_id_1<\/span><\/em><span style=\"font-weight: 400;\"> to your URL.<\/span><\/li><li><span style=\"font-weight: 400;\">Ensure <\/span><span style=\"font-weight: 400;\">sub_id_1<\/span><span style=\"font-weight: 400;\"> is a unique identifier.<\/span><\/li><li style=\"list-style-type: none;\">\u00a0<\/li><\/ul><pre><b>Example in Ruby<\/b><span style=\"font-weight: 400;\">:<\/span><span style=\"font-weight: 400;\"><br \/><\/span><span style=\"font-weight: 400;\">https:\/\/yourdomain.com\/path\/to\/ad?psid=home_page_1<\/span><\/pre><p><b>2. Place a Smartlink with Sub ID on a web page<\/b><\/p><p><b>3. Ensure you generated different Sub IDs for every page<\/b><\/p><p><span style=\"font-weight: 400;\">Examples:<\/span><\/p><ul><li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Home page: <\/span><span style=\"font-weight: 400;\">&amp;psid=home_page_1<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">About page: <\/span><span style=\"font-weight: 400;\">&amp;psid=about_page_2<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Contact page: <\/span><span style=\"font-weight: 400;\">&amp;psid=contact_page_3<\/span><\/li><\/ul><p><b>4. Get stats<\/b><span style=\"font-weight: 400;\">:<\/span><\/p><ul><li style=\"list-style-type: none;\"><ul><li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Use the Adsterra Publisher API to get the stats you need.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"2\"><span style=\"font-weight: 400;\">Group results by the <\/span><span style=\"font-weight: 400;\">placement_sub_id<\/span><span style=\"font-weight: 400;\"> parameter to see performance per location.<\/span><\/li><\/ul><\/li><\/ul><p><b>Example API Query (cURL)<\/b><span style=\"font-weight: 400;\">:<\/span><\/p><pre><span style=\"font-weight: 400; color: #3366ff;\">curl --request GET \\ --url 'https:\/\/api3.adsterratools.com\/publisher\/stats.json?domain=8356709&amp;placement=28948612&amp;start_date=2024-07-09&amp;finish_date=2024-07-09&amp;group_by%5B%5D=placement_sub_id' \\ --header 'Accept: application\/json' \\ --header 'X-API-Key: {api_token}'<\/span><\/pre>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-9ceb531 elementor-widget elementor-widget-text-editor\" data-id=\"9ceb531\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><span style=\"font-weight: 400;\">Finishing up with practice, we encourage you to take a closer look at all Adsterra monetization ad formats. Choose the most beneficial for your business and target audience and start earning with or without API.<\/span><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c2c3299 elementor-widget elementor-widget-spacer\" data-id=\"c2c3299\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-57ef52e elementor-widget elementor-widget-menu-anchor\" data-id=\"57ef52e\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"dealing-with-errors\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-c261d4c elementor-widget elementor-widget-text-editor\" data-id=\"c261d4c\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>API requests errors<\/strong><\/h2><p><span style=\"font-weight: 400;\">When everything works fine, you will get a 200 server response, which means &#8220;Success.&#8221; However, sometimes pitfalls occur. So here are the most common errors and their meanings. Use those tips to deal with them yourself or ask for help from our support team. <\/span><\/p><ul><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><strong>401<\/strong> \u2014 the token is incorrect. Please use the token from your account (see the API tab)<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><strong>403<\/strong> \u2014 the token is no longer valid. Please generate a new token<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><strong>404<\/strong> \u2014 not found. Make sure the URL is correct<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><strong>405<\/strong> \u2013 not allowed<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\"><strong>422<\/strong> \u2013 the server can\u2019t interpret the instructions, however, the syntax is correct<\/span><\/li><\/ul>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ad40d6e elementor-widget elementor-widget-spacer\" data-id=\"ad40d6e\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5d314d8 elementor-widget elementor-widget-menu-anchor\" data-id=\"5d314d8\" data-element_type=\"widget\" data-widget_type=\"menu-anchor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-anchor\" id=\"conclusion-publishers-api\"><\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-30bcd8d elementor-widget elementor-widget-text-editor\" data-id=\"30bcd8d\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<h2><strong>Summarizing the benefits <\/strong><\/h2><p><span style=\"font-weight: 400;\">Even a slight CPM change may affect your monetization strategy. With Adsterra Publishers API, you can automatically fetch important metrics from your account without building another report or exporting a CSV file.<\/span><br \/><br \/><\/p><p><span style=\"font-weight: 400;\">These are some tangible benefits you can enjoy:<\/span><\/p><ul><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Monitor the key metrics and update them automatically.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Compare the efficiency of<\/span><a href=\"https:\/\/blogdev.adsterratech.com\/blog\/quick-publishers-manual-to-ad-formats\/\" target=\"_blank\" rel=\"noopener\"> <span style=\"font-weight: 400;\">Adsterra ad formats for publishers<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Save plenty of time on building dynamic reports and collecting stats for specific periods.<\/span><\/li><li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Control your core metrics \u2014 CPM and revenue \u2014 and react faster than ever.<\/span><\/li><\/ul><p><span style=\"font-weight: 400;\">But enough theory. It&#8217;s time to make the most of Adsterra Publishers API <\/span><img decoding=\"async\" class=\"emoji\" role=\"img\" draggable=\"false\" src=\"https:\/\/s.w.org\/images\/core\/emoji\/13.0.0\/svg\/1f60a.svg\" alt=\"\ud83d\ude0a\" \/><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-ea9df36 elementor-widget elementor-widget-spacer\" data-id=\"ea9df36\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"penci-section penci-disSticky penci-structure-10 elementor-section elementor-top-section elementor-element elementor-element-412850a elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"412850a\" data-element_type=\"section\">\n\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"penci-ercol-100 penci-ercol-order-1 penci-sticky-ct    elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-6e349c2\" data-id=\"6e349c2\" data-element_type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap\">\n\t\t\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Many websites, many ads, and many stats. It&#8217;s easy to get confused by the data and waste hours checking every ad code.&hellip;<\/p>\n","protected":false},"author":2,"featured_media":32143,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[840,684],"tags":[44,97],"class_list":["post-5244","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-api","category-monetization-tools","tag-api","tag-publisher"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.3.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How To Use Adsterra Publisher API | A Quick Guide<\/title>\n<meta name=\"description\" content=\"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Use Adsterra Publisher API | A Quick Guide\" \/>\n<meta property=\"og:description\" content=\"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Adsterra Affiliate Marketing and Traffic Monetization Blog\" \/>\n<meta property=\"article:published_time\" content=\"2024-08-14T09:24:07+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-12T11:05:35+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/adsterra.com\/blog\/wp-content\/uploads\/2023\/09\/1200x628-blog-template.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"560\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Olly V\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Olly V\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\"},\"author\":{\"name\":\"Olly V\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/a1b491a0114afe94be6f869d14b67d21\"},\"headline\":\"Adsterra Publisher API: Easily Pull Data to Power Your Monetization Strategy\",\"datePublished\":\"2024-08-14T09:24:07+00:00\",\"dateModified\":\"2025-09-12T11:05:35+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\"},\"wordCount\":1473,\"publisher\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png\",\"keywords\":[\"API\",\"Publishers\"],\"articleSection\":[\"API\",\"Monetization Tools\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\",\"name\":\"How To Use Adsterra Publisher API | A Quick Guide\",\"isPartOf\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png\",\"datePublished\":\"2024-08-14T09:24:07+00:00\",\"dateModified\":\"2025-09-12T11:05:35+00:00\",\"description\":\"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png\",\"contentUrl\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png\",\"width\":1200,\"height\":560},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#website\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/\",\"name\":\"Adsterra Affiliate Marketing and Traffic Monetization Blog\",\"description\":\"Expert tips on how to monetize traffic and advertise products worldwide\",\"publisher\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#organization\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#organization\",\"name\":\"Adsterra\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2022\/10\/340x72_logo_adsterra.png\",\"contentUrl\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2022\/10\/340x72_logo_adsterra.png\",\"width\":340,\"height\":72,\"caption\":\"Adsterra\"},\"image\":{\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/AdsterraGlobal\",\"https:\/\/www.linkedin.com\/company\/adsterra\",\"https:\/\/www.instagram.com\/adsterra_network\",\"https:\/\/t.me\/adsterra_official\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/a1b491a0114afe94be6f869d14b67d21\",\"name\":\"Olly V\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2025\/03\/cropped-olly-v-preview-profile-pic-96x96.png\",\"contentUrl\":\"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2025\/03\/cropped-olly-v-preview-profile-pic-96x96.png\",\"caption\":\"Olly V\"},\"description\":\"With a content producing career spanning 17 years, today Olly is a visionary affiliate marketing content writer and producer renowned for transforming complex technologies into accessible, engaging narratives.\",\"url\":\"https:\/\/blogdev.adsterratech.com\/blog\/author\/olly-v\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How To Use Adsterra Publisher API | A Quick Guide","description":"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/","og_locale":"en_US","og_type":"article","og_title":"How To Use Adsterra Publisher API | A Quick Guide","og_description":"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.","og_url":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/","og_site_name":"Adsterra Affiliate Marketing and Traffic Monetization Blog","article_published_time":"2024-08-14T09:24:07+00:00","article_modified_time":"2025-09-12T11:05:35+00:00","og_image":[{"width":1200,"height":560,"url":"https:\/\/adsterra.com\/blog\/wp-content\/uploads\/2023\/09\/1200x628-blog-template.png","type":"image\/png"}],"author":"Olly V","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Olly V","Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#article","isPartOf":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/"},"author":{"name":"Olly V","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/a1b491a0114afe94be6f869d14b67d21"},"headline":"Adsterra Publisher API: Easily Pull Data to Power Your Monetization Strategy","datePublished":"2024-08-14T09:24:07+00:00","dateModified":"2025-09-12T11:05:35+00:00","mainEntityOfPage":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/"},"wordCount":1473,"publisher":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/#organization"},"image":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage"},"thumbnailUrl":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png","keywords":["API","Publishers"],"articleSection":["API","Monetization Tools"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/","url":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/","name":"How To Use Adsterra Publisher API | A Quick Guide","isPartOf":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage"},"image":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage"},"thumbnailUrl":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png","datePublished":"2024-08-14T09:24:07+00:00","dateModified":"2025-09-12T11:05:35+00:00","description":"\ud83d\ude80 Enhance your earning strategy! Learn how Adsterra Publisher API helps build reports with key stats: CPM, CTR, clicks, revenue and more.","inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blogdev.adsterratech.com\/blog\/how-to-use-adsterra-publishers-api\/#primaryimage","url":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png","contentUrl":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2020\/11\/publisher-api-guide-blogcover1200560.png","width":1200,"height":560},{"@type":"WebSite","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#website","url":"https:\/\/blogdev.adsterratech.com\/blog\/","name":"Adsterra Affiliate Marketing and Traffic Monetization Blog","description":"Expert tips on how to monetize traffic and advertise products worldwide","publisher":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/#organization"},"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#organization","name":"Adsterra","url":"https:\/\/blogdev.adsterratech.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2022\/10\/340x72_logo_adsterra.png","contentUrl":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2022\/10\/340x72_logo_adsterra.png","width":340,"height":72,"caption":"Adsterra"},"image":{"@id":"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/AdsterraGlobal","https:\/\/www.linkedin.com\/company\/adsterra","https:\/\/www.instagram.com\/adsterra_network","https:\/\/t.me\/adsterra_official"]},{"@type":"Person","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/a1b491a0114afe94be6f869d14b67d21","name":"Olly V","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blogdev.adsterratech.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2025\/03\/cropped-olly-v-preview-profile-pic-96x96.png","contentUrl":"https:\/\/blogdev.adsterratech.com\/blog\/wp-content\/uploads\/2025\/03\/cropped-olly-v-preview-profile-pic-96x96.png","caption":"Olly V"},"description":"With a content producing career spanning 17 years, today Olly is a visionary affiliate marketing content writer and producer renowned for transforming complex technologies into accessible, engaging narratives.","url":"https:\/\/blogdev.adsterratech.com\/blog\/author\/olly-v\/"}]}},"_links":{"self":[{"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/posts\/5244","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/comments?post=5244"}],"version-history":[{"count":65,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/posts\/5244\/revisions"}],"predecessor-version":[{"id":43412,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/posts\/5244\/revisions\/43412"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/media\/32143"}],"wp:attachment":[{"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/media?parent=5244"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/categories?post=5244"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogdev.adsterratech.com\/blog\/wp-json\/wp\/v2\/tags?post=5244"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}