Skip to main content
If your platform hosts creators (influencers, streamers, newsletter authors, affiliates), give each of them a permanent tracking link per campaign. The creator drops the link into their content; every click creates a new tracked transaction, so any number of their audience can claim and complete the same offer from one link, and completions and payouts attribute back to the creator automatically. There is no fetch at render time and no impression to confirm: you mint links once (idempotently), the link itself carries the attribution, and a stats endpoint powers your creator dashboard. The shared claim and activation semantics are in the overview; the endpoint contracts are in the Creator Links reference.

​
The pattern

1

Mint the links on every dashboard load

Call POST /creators/links with your own opaque creatorId. You get one stable linkUrl per campaign your app is entitled to, each with catalog-grade display fields and a payout block. Idempotent: the same creator always gets the same links, so never store them; render whatever comes back, and new campaigns simply appear as new entries.
2

The creator shares the link

They drop linkUrl into a bio, a video description, a post, a newsletter. It never expires, and it is never “used up”: each open creates a fresh transaction and 302-redirects to the offer with attribution, so multiple claims and multiple completions from one link are expected and correct.
3

Render the creator's performance

Call GET /creators/{creatorId}/stats for real-time clicks, completions, and earnings per campaign, plus totals and a chart-ready daily series. Optional startDate/endDate scope everything; an unknown creatorId returns a 200 with zeros, so a brand-new creator needs no special-casing.

​
Gotchas

  • Surface targetCountries to your creators. It tells them where an offer converts, so they can pick campaigns matching their audience. Clicks from outside a campaign’s target countries still open and create a transaction, but they won’t complete.
  • You control which campaigns appear, and in what order. links contains only the campaigns enabled for your app, in the campaign order you configure in the dashboard; manual priority overrides are honored.
  • Correlate by campaignId. The stats endpoint is keyed by the same campaignId as the mint endpoint, so joining links to performance is a direct id match.
  • Clicks count opens, not unique users. Each open creates a transaction; don’t read clicks as reach.
Build a rich surface from one call. Each mint entry carries everything for a full offer card (the advertiser organization, perk, badgeLabel, oldPrice/newPrice, payout, creatives, and categories for filter tabs). Two patterns publishers commonly build on top:
  • Vanity links: mount a pretty route on your own domain (for example you.com/go/summer) that 302-redirects to the entry’s linkUrl. The creator shares your branded URL; attribution is unchanged.
  • Branded claim page: host your own offer page (your card plus a “Claim” button) that sends the tap to linkUrl, which then 302s to the advertiser. Your brand, Encore’s attribution.