Skip to main content
GET
/
v1
/
stats
/
links
/
{link_id}
/
summary
Link Stats Summary
curl --request GET \
  --url https://api.taap.it/v1/stats/links/{link_id}/summary \
  --header 'Authorization: <authorization>'
{
  "link_id": "<string>",
  "total_clicks": 123,
  "top_countries": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "top_devices": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "top_browsers": [
    {
      "name": "<string>",
      "count": 123
    }
  ],
  "qr_code_usage": 123,
  "date_range": {
    "start": "<string>",
    "end": "<string>"
  }
}
Request:
cURL
curl -X GET 'https://api.taap.it/v1/stats/links/link_987654321/summary?start_date=2024-01-01&end_date=2024-01-31' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
Response: 
{
  "link_id": "link_987654321",
  "total_clicks": 1250,
  "top_countries": [
    {"name": "US", "count": 650},
    {"name": "CA", "count": 280},
    {"name": "UK", "count": 180}
  ],
  "top_devices": [
    {"name": "mobile", "count": 750},
    {"name": "desktop", "count": 400},
    {"name": "tablet", "count": 100}
  ],
  "top_browsers": [
    {"name": "Chrome", "count": 800},
    {"name": "Safari", "count": 300},
    {"name": "Firefox", "count": 100}
  ],
  "qr_code_usage": 45,
  "date_range": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  }
}

​
Authorization

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
link_id
string
required
Unique identifier for the link

​
Query Parameters

​
start_date
string
Start date for statistics (YYYY-MM-DD format)
​
end_date
string
End date for statistics (YYYY-MM-DD format)

​
Response Fields

​
link_id
string
required
Unique identifier for the link
​
total_clicks
integer
required
Total number of clicks on the link
​
top_countries
array
required
Array of top countries by click count
​
top_devices
array
required
Array of top devices by click count
​
top_browsers
array
required
Array of top browsers by click count
​
qr_code_usage
integer
required
Number of times the QR code was scanned
​
date_range
object
Date range for the statistics