Data Export
Download your links and click statistics as CSV files (Pro+)
The data export endpoints let you download your account data in CSV format for use in spreadsheets, data warehouses, or BI tools. Two exports are available: all your links as a single file, and per-link click statistics. Both require Pro or higher.
Base URL
https://awsys.co
Authentication
Both export endpoints require a valid API key (Pro+). See the Authentication page for details.
Authorization: Bearer YOUR_API_KEY
Export All Links
GET /api/export/links
Downloads all short links in your account as a CSV file, ordered by creation date (newest first). Fields include the full short URL, destination, click count, creation date, expiry date, assigned folder name, and semicolon-separated tags.
Response
Content-Type: text/csv
Content-Disposition: attachment; filename="links.csv"
CSV columns
| Column | Description |
|---|---|
short_url | Full short URL (e.g. https://awsys.co/abc123) |
destination | Destination URL |
clicks | Total click count |
created | ISO 8601 creation timestamp |
expires | ISO 8601 expiry timestamp, or empty if no expiry |
folder | Name of the assigned folder, or empty |
tags | Semicolon-separated tag list, or empty |
curl example
curl https://awsys.co/api/export/links \
-H "Authorization: Bearer YOUR_API_KEY" \
--output links.csv
Sample output
short_url,destination,clicks,created,expires,folder,tags
https://awsys.co/abc123,https://example.com/landing,47,2026-05-01T10:00:00.000Z,,Marketing,campaign-q3;email
https://awsys.co/def456,https://example.com/blog,12,2026-04-15T08:30:00.000Z,2026-06-01T00:00:00.000Z,,
Export Click Statistics for a Link
GET /api/export/stats/:short
Downloads the raw click event log for a single short link as CSV. Each row is one click event with timestamp, geographic location, browser, OS, device type, and referrer.
Path parameters
| Parameter | Description |
|---|---|
short | The short code of the link (e.g. abc123) |
Response
Content-Type: text/csv
Content-Disposition: attachment; filename="stats_abc123.csv"
CSV columns
| Column | Description |
|---|---|
timestamp | ISO 8601 click timestamp |
city | City of visitor (GeoIP) |
region | Region / state of visitor |
country | ISO 3166-1 alpha-2 country code |
browser | Browser name parsed from User-Agent |
os | Operating system parsed from User-Agent |
device | Device type: mobile, desktop, or tablet |
referrer | HTTP Referer header, or Direct if absent |
curl example
curl "https://awsys.co/api/export/stats/abc123" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output stats_abc123.csv
Error Codes
| Code | HTTP | Description |
|---|---|---|
TIER_REQUIRED | 403 | CSV export requires Pro or higher. |
| — | 403 | Access denied — the link belongs to a different user. |
| — | 404 | Link not found — the short code does not exist. |