API Stats

Each request must be authorized using Header:

Authorization: Bearer {apiToken}

{apiToken} you can see on account page

Stats by country/source

API Endpoint

https://api.tg-ads.co/api/v1/campaign/stats/{campaignId}/?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD&viewBy={viewBy}

Available parameters: {campaignId} - ID of campaign you see on Campaign Page.
{viewBy} - source/country startDate - format YYYY-MM-DD - example - 2025-03-01
endDate - format YYYY-MM-DD - example - 2025-03-01

Valid URL Example by country: https://api.tg-ads.co/api/v1/campaign/stats/64352/?startDate=2025-03-01&endDate=2025-03-01&viewBy=country

Response example:

[
  {
    "id": "BD",
    "value": "BD",
    "clicks": 18122,
    "spend": 283.23,
    "impressions": 117704,
    "conversions": 0,
    "cvr": 0,
    "ctr": 15.4,
    "cpc": 0.02,
    "cpm": 2.41,
    "cpa": 0
  },
  {
    "id": "NG",
    "value": "NG",
    "clicks": 8396,
    "spend": 157.08,
    "impressions": 66336,
    "conversions": 0,
    "cvr": 0,
    "ctr": 12.66,
    "cpc": 0.02,
    "cpm": 2.37,
    "cpa": 0
  }
]

Valid URL Example by source: https://api.tg-ads.co/api/v1/campaign/stats/64352/?startDate=2025-03-01&endDate=2025-03-01&viewBy=source

Response example:

[
  {
    "id": "QQ789X",
    "value": "QQ789X",
    "clicks": 3696,
    "spend": 86.42,
    "impressions": 36108,
    "conversions": 0,
    "cvr": 0,
    "ctr": 10.24,
    "cpc": 0.02,
    "cpm": 2.39,
    "cpa": 0
  },
  {
    "id": "QQ7L3Y",
    "value": "QQ7L3Y",
    "clicks": 2222,
    "spend": 34.98,
    "impressions": 14229,
    "conversions": 0,
    "cvr": 0,
    "ctr": 15.62,
    "cpc": 0.02,
    "cpm": 2.46,
    "cpa": 0
  }
]