API Docs

Get Stats/Analytics (alltime)

Get stats/analytics data for single tag or list of URLs for all-time, by using REST API endpoint: /api/v1/stats/alltime

Request

Parameter Type Position # Description
apikey string Header Required Enter your 20-30 characters unique api key.
apisecret string Header Required Enter your 12-20 characters unique api secret.
tag
or
url_keys		 string Query Required Enter the tag name for which you want to see the stats data.
or
Enter a comma-separated list of short URL keys (slashtags only) for which you want to see the stats data. Max 100 keys.
For example, your short URLs are:
  • https://yourdomain.co/offer2020
  • https://yourdomain.co/Ghkr3dU
Then url_keys value can be offer2020,Ghkr3dU
timezone string Query Optional Enter the timezone in UTC format. Example: -06:00. Default is +00:00

Sample GET request


  1. https://t2mio.com/api/v1/stats?tag=tag1
  2. https://t2mio.com/api/v1/stats?tag=tag1&timezone=-06:00
  3. https://t2mio.com/api/v1/stats?url_keys=key1,key2,key3&timezone=-06:00

Response

{
  "status": 200,
  "message": "ok",
  "data": {
    "clicks_total": 7475,
    "clicks_unique": 1781,
    "clicks_repeated": 5694,
    "clicks_breakdown": {
      "2020": {
        "1": 0,
        "2": 0,
        "3": 0,
        "4": 0,
        "5": 0,
        "6": 0,
        "7": 0,
        "8": 0,
        "9": 368,
        "10": 386,
        "11": 348,
        "12": 544
      },
      "2021": {
        "1": 332,
        "2": 202,
        "3": 243,
        "4": 206,
        "5": 182,
        "6": 128,
        "7": 215,
        "8": 473,
        "9": 145,
        "10": 250,
        "11": 211,
        "12": 953
      },
      "2022": {
        "1": 205,
        "2": 105,
        "3": 123,
        "4": 499,
        "5": 219,
        "6": 315,
        "7": 219,
        "8": 317,
        "9": 241,
        "10": 46,
        "11": 0,
        "12": 0
      }
    },
    "browser": {
      "Chrome": "5658",
      "Firefox": "427",
      "unknown.": "409",
      "Safari": "405",
      "Mozilla": "203",
      "Internet Explorer": "115",
      "Opera": "91",
      "iPhone": "72",
      "Android": "33",
      "GoogleBot": "16",
      "iPad": "8",
      "YandexBot": "7",
      "Edge": "6",
      "Opera Mini": "6",
      "Yandex": "6",
      "Bing Bot": "5",
      "Lynx": "2",
      "Vivalidi": "2",
      "Iceweasel": "1",
      "iPod": "1",
      "Netscape Navigator": "1",
      "Shiretoko": "1"
    },
    "country": {
      "US": "1287",
      "TH": "1119",
      "CO": "474",
      "BR": "441",
      "TG": "5",
      "unknown.": "4",
      "CM": "4",
      "JO": "4",
      ...
    },
    "device": {
      "Desktop": "3114",
      "Tablet": "99",
      "Mobile": "4262"
    },
    "languages": {},
    "platform": {
      "Android": "3885",
      "Windows": "1569",
      "Apple": "758",
      "iPhone": "423",
      "Bot": "282",
      "unknown.": "233",
      "Linux": "158",
      "WhatsApp": "65",
      "iPad": "36",
      "iPhone/iPad": "33",
      "Chrome OS": "20",
      "Facebook": "6",
      "Postman": "2",
      "Terminal": "2",
      "FreeBSD": "1",
      "iPod": "1",
      "Java/Android": "1"
    },
    "referrer": {
      "Direct": 7408,
      "www.google.com": "41",
      "facebook.com": "5",
      "www.t2mio.com": "4",
      "l.instagram.com": "2",
      "com.google.android.gm": "1",
      ...
    },
    "timezone": {
      "America/Sao_Paulo": "174",
      "America/Bogota": "173",
      "Asia/Bangkok": "166",
      "America/New_York": "149",
      "America/Mexico_City": "105",
      "America/Chicago": "85",
      "America/Los_Angeles": "65",
      "Asia/Kolkata": "56",
      "America/Lima": "54",
      "America/Fortaleza": "48",
      "America/Argentina/Buenos_Aires": "46",
      "Europe/Berlin": "41",
      "America/Toronto": "39",
      "Europe/Istanbul": "39",
      ...
    }
  }
}
											
{
    "status": 400,
    "message": "Bad request. <error-message-here>",
    "data": []
}