Referrer Analytics
Short URL Analytics
Referrer Analytics
Get traffic source analytics for all your short URLs
GET
Referrer Analytics
Get detailed traffic source analysis showing where your clicks are coming from, including social media platforms, search engines, and direct traffic.
This endpoint returns user-level aggregated referrer data. Traffic is automatically categorized into sources like social media, search engines, messaging apps, and direct traffic.
Query Parameters
Number of days to include in analytics (1-365).
Predefined date range:
7d, 30d, 90d, 1y, all_time, custom.
Takes precedence over days if specified.Start date for custom range (ISO 8601). Required when
dateRange is custom.End date for custom range (ISO 8601). Required when
dateRange is custom.Response
Array of referrer records.
Aggregated traffic by category.
Detailed breakdown by category with clicks, unique visitors, and percentage.
Request Examples
- cURL
- Node.js
- TypeScript
- Python
- PHP
- Go
- Java
Response Examples
- 200 OK
Traffic Source Categories
The API automatically categorizes referrers into the following sources:| Category | Platforms |
|---|---|
| Social Media | Facebook, Twitter, LinkedIn, Instagram, YouTube, TikTok, Reddit, Pinterest |
| Messaging | WhatsApp, Telegram, Discord |
| Search Engines | Google, Bing, Yahoo, DuckDuckGo |
| Direct | No referrer (typed URL, bookmarks, etc.) |
| Other | Any other referring domain |
Use Cases
Marketing channel ROI analysis
Marketing channel ROI analysis
Compare performance across different marketing channels to optimize spend.
Social media performance dashboard
Social media performance dashboard
Identify unknown referrers
Identify unknown referrers
Find and analyze traffic from unexpected sources.
Related Endpoints
UTM Analytics
Track campaign performance with UTM parameters
Click Details
Get individual click records with referrer info
Analytics Overview
Get aggregated statistics for all URLs
Top Performing URLs
See which URLs are getting the most clicks