API Stats

Each request must be authorized using Header:

Authorization: Bearer {apiToken}

{apiToken} you can see on account page

Stats by country

API Endpoint

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

Available parameters: {widgetId} - ID of widget you see on Widget Page.
startDate - format YYYY-MM-DD - example - 2025-03-01
endDate - format YYYY-MM-DD - example - 2025-03-01

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

Response example:

[
  {
    "id": "US",
    "value": "US",
    "clicks": 0,
    "revenue": 0.0319,
    "impressions": 13,
    "ctr": 0,
    "cpm": 2.5
  },
  {
    "id": "PL",
    "value": "PL",
    "clicks": 3,
    "revenue": 0.0088,
    "impressions": 4,
    "ctr": 75,
    "cpm": 2.2
  },
]