Conversion Tracking

Record a conversion (GET)

Records a conversion for a click from query parameters. Suited to image pixels and affiliate postback URLs.

Auth: none. The click id is the credential; no cookie or API key is read. CORS is open to every origin.

Plan: no caller plan check. The click's link must have conversion tracking on (a Pro link setting), and the click must be at most 30 days old.

Rate limit: 60 requests per 60 s per client IP, shared by GET and POST on /api/conversion and /api/postback (fixed window, in memory per server instance). The 429 has no Retry-After.

A HEAD request is answered by this same handler and also records a conversion.

get/api/conversion

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/conversion
  • Auth: none required

Query parameters

click_idstring required

Per-click id Flyn appended to the destination as flyn_id. Also accepted as clickId, flyn_id, clickid or cid; the first one present wins, so an empty click_id hides a valid cid.

eventstring

Goal name, trimmed and lower-cased; empty means conversion. Also accepted as type.

valuestring

Value in major units. Also accepted as payout, sum or amt. Characters other than digits, dot, comma and minus are stripped; a European decimal comma is understood; above 1,000,000 in size or unparseable becomes 0. Stored in cents; a negative value records a refund.

currencystring

ISO 4217 code, upper-cased; anything but three letters becomes USD.

txidstring

Transaction id, first 64 characters kept. Also accepted as transaction_id. Part of the (click, event, txid) de-duplication key.

Response

Recorded, or already recorded for this (click, event, txid) (duplicate: true).

okboolean required
duplicateboolean

Present and true when the same (click, event, txid) was already recorded.

errorstring

Present when ok is false.

Changes

No recorded changes to this operation across all 1 revision of this API.