Link stats (simple)

Daily clicks and the top countries and devices for one link.

GEThttps://api.clicklookup.com/v1/links/{link_id}/stats

Requires an API key

Path parameters1

link_idstring · uuidrequired

Query parameters1

daysinteger
Length of the period, counted back from now. Ignored when from_ is set.
Default 301–365

Response · 2006

byCountryarray of objectsrequired
Show 3 child attributesHide child attributes
- clicksintegerrequired
  0–9007199254740990
- keystringrequired
  Date (YYYY-MM-DD), country code, device type… depending on the breakdown
- uniqueClicksintegerrequired
  0–9007199254740990
byDayarray of objectsrequired
Show 3 child attributesHide child attributes
- clicksintegerrequired
  0–9007199254740990
- keystringrequired
  Date (YYYY-MM-DD), country code, device type… depending on the breakdown
- uniqueClicksintegerrequired
  0–9007199254740990
byDevicearray of objectsrequired
Show 3 child attributesHide child attributes
- clicksintegerrequired
  0–9007199254740990
- keystringrequired
  Date (YYYY-MM-DD), country code, device type… depending on the breakdown
- uniqueClicksintegerrequired
  0–9007199254740990
daysintegerrequired
Length of the period, counted back from now. Ignored when from_ is set.
1–365
linkIdstring · uuidrequired
UUID primary key
totalsobjectrequired
Show 6 child attributesHide child attributes
- botClicksintegerrequired
  0–9007199254740990
- clicksintegerrequired
  0–9007199254740990
- conversionRatenumberrequired
  conversions / uniqueClicks, 0..1
  min 0
- conversionsintegerrequired
  0–9007199254740990
- revenuenumberrequired
  min 0
- uniqueClicksintegerrequired
  0–9007199254740990

Request

curl "https://api.clicklookup.com/v1/links/9a1d7e42-3c5b-4f8e-b2a6-0d4e8f1c7b35/stats?days=30" \
  -H "Authorization: Bearer $CLICKLOOKUP_API_KEY"

Response

{
  "byCountry": [
    {
      "clicks": 1280,
      "key": "US",
      "uniqueClicks": 1280
    }
  ],
  "byDay": [
    {
      "clicks": 1280,
      "key": "US",
      "uniqueClicks": 1280
    }
  ],
  "byDevice": [
    {
      "clicks": 1280,
      "key": "US",
      "uniqueClicks": 1280
    }
  ],
  "days": 1,
  "linkId": "3f6c2a1e-8b4d-4c2a-9e1f-5a7b3c9d2e10",
  "totals": {
    "botClicks": 1280,
    "clicks": 1280,
    "conversionRate": 42,
    "conversions": 42,
    "revenue": 1.5,
    "uniqueClicks": 1280
  }
}