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

ColumnDescription
short_urlFull short URL (e.g. https://awsys.co/abc123)
destinationDestination URL
clicksTotal click count
createdISO 8601 creation timestamp
expiresISO 8601 expiry timestamp, or empty if no expiry
folderName of the assigned folder, or empty
tagsSemicolon-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

ParameterDescription
shortThe short code of the link (e.g. abc123)

Response

Content-Type: text/csv
Content-Disposition: attachment; filename="stats_abc123.csv"

CSV columns

ColumnDescription
timestampISO 8601 click timestamp
cityCity of visitor (GeoIP)
regionRegion / state of visitor
countryISO 3166-1 alpha-2 country code
browserBrowser name parsed from User-Agent
osOperating system parsed from User-Agent
deviceDevice type: mobile, desktop, or tablet
referrerHTTP 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

CodeHTTPDescription
TIER_REQUIRED403CSV export requires Pro or higher.
403Access denied — the link belongs to a different user.
404Link not found — the short code does not exist.