API

Create links and read statistics programmatically. The API is available on the Business plan. Base address — https://funnellink.cc/api/v1.

Authorization

Get a key in the API section and pass it in the header. Limit — 120 requests per minute.

Authorization: Bearer fll_key

Create a link

POST /links. The minimum is the url field. You can set slug, title, campaign, domain.

curl -X POST https://funnellink.cc/api/v1/links \
  -H "Authorization: Bearer fll_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/landing", "title": "Promo", "campaign": "Spring"}'

Response:

{ "slug": "aB3xYz", "short_url": "https://funlnk.cc/aB3xYz" }

A/B test — pass the variants array (up to 5):

{"variants": [
  {"url": "https://example.com/a", "weight": 50},
  {"url": "https://example.com/b", "weight": 50}
]}

List of links

GET /links

curl https://funnellink.cc/api/v1/links -H "Authorization: Bearer fll_key"

Stats for a link

GET /links/{slug}/stats — clicks, conversions and a breakdown by variant and target action.

curl https://funnellink.cc/api/v1/links/aB3xYz/stats -H "Authorization: Bearer fll_key"

{
  "slug": "aB3xYz",
  "clicks": 128,
  "conversions": 17,
  "conversion_rate": 13.28,
  "variants": [
    {"id": "a", "url": "...", "clicks": 64, "conversions": 5, "conversion_rate": 7.81}
  ],
  "goals": [{"code": "aB3xYz_g1", "label": "Lead", "conversions": 12}]
}

Errors

401 — missing/invalid key, 403 — plan is not Business, 422 — invalid data, 429 — request limit exceeded. The error body is { "error": "..." }.