Traffic Source Analytics
Short URL Analytics
Traffic Source Analytics
Get aggregated traffic source data for your links
GET
Traffic Source Analytics
Understand where your traffic is coming from. This endpoint categorizes engagement by source type, such as Direct, Social, Referral, Email, and Search.
Query Parameters
Predefined date range:
last_hour, last_24_hours, last_7_days, last_30_days, last_year, all_time, custom.Filter by URL type:
all, standard, branded, subdomain.Filter by Campaign UUID or name.
Comma-separated list of tags to filter by.
Filter clicks by country name (e.g.
Pakistan, United States).Filter clicks by ISO country code (e.g.
pk, us). Supports alias country_code.Filter clicks by region name (e.g.
Sindh, California).Filter clicks by city name (e.g.
Karachi, New York).Filter clicks by device type. Options:
desktop, mobile, tablet. Supports alias device_type.Filter clicks by browser (e.g.
chrome, firefox, safari).Filter clicks by OS (e.g.
windows, macos, android, ios).Filter clicks by UTM Source. Supports alias
utm_source.Filter clicks by UTM Medium. Supports alias
utm_medium.Filter clicks by UTM Campaign. Supports alias
utm_campaign.Filter clicks by UTM Term. Supports alias
utm_term.Filter clicks by UTM Content. Supports alias
utm_content.Filter clicks by referrer URL.
Filter clicks by referrer domain (e.g.
t.co, facebook.com). Supports alias referrer_domain.Response
Whether the request was successful.
Request Examples
- cURL
- Node.js
- TypeScript
- Python
- PHP
- Go
- Java
Response Example
Use Cases
Audit traffic quality
Audit traffic quality
Monitor the percentage of “Direct” vs “Referral” traffic to evaluate the health of your link distribution. High direct traffic often indicates strong brand recall or private messaging sharing (e.g., Slack, WhatsApp).
Verify ad campaign attribution
Verify ad campaign attribution
Compare “Social” and “Search” traffic spikes with your active ad periods to verify that your marketing spend is driving the expected volume of engagement through your shortened links.
Identify unexpected referral sources
Identify unexpected referral sources
Discover new websites or platforms that are linking to your content. If a specific “Referral” source is consistently high, you may want to establish a more formal partnership with that entity.