API/Analytics API

Analytics API

Query clicks, identified customers, conversions, and revenue with bounded date ranges.

Analytics endpoints return live daily attribution separately from historical snapshots imported from other platforms.

Organization analytics

curl "https://linkquick.melvynx.dev/api/v1/analytics?dateFrom=2026-07-01&dateTo=2026-07-31" \
  -H "Authorization: Bearer $LINKQUICK_API_KEY"

The response contains:

  • totals: clicks, identified users, conversions, conversion rate, and revenue;
  • daily: an ordered time series for charts and reporting;
  • topLinks: the best-performing parent links in the period;
  • truncated: whether the bounded query reached its safety limit.
curl "https://linkquick.melvynx.dev/api/v1/links/LINK_ID/analytics?dateFrom=2026-07-01&dateTo=2026-07-31" \
  -H "Authorization: Bearer $LINKQUICK_API_KEY"

For a parent, summary.metrics compares the parent and up to 100 sublinks, while summary.daily provides the combined time series. imported contains separate historical snapshots and must not be added to a specific live day.

Date and currency rules

Dates use YYYY-MM-DD, are interpreted as inclusive UTC days, and may cover at most 367 days. Revenue is returned in minor units. When a result combines multiple currencies, its aggregate currency is null instead of inventing a conversion rate.