Connect Keitaro to OnlyFans API Smart Links

Report OnlyFans subscription conversions back to Keitaro via Smart Links postbacks, so each new subscriber is attributed to the Keitaro click that drove it.

What the Keitaro integration does

Keitaro is a self-hosted traffic tracker and redirect platform used by media buyers. This integration connects Keitaro to OnlyFans API Smart Links so that every new subscriber you generate is reported straight back to Keitaro for attribution.

There are two halves: getting Keitaro's click ID into your Smart Link, then sending the conversion back to Keitaro when a subscription happens. Because Keitaro isn't a built-in Ad Platform, you wire it up with a Smart Links Postback (a plain GET request) rather than a paste-a-token connector.

What you'll need

An active OnlyFans API account with Smart Links enabled
A Smart Link created for the creator you're promoting
A Keitaro campaign with an offer, plus your Keitaro postback URL (its domain and key)

How the pieces connect

Keitaro's {subid} (its click ID) is passed into your Smart Link as ?ecid={subid}, where it's saved as your external click ID. When a fan subscribes, the postback sends that value back to Keitaro as {external_click_id}, which Keitaro matches to the original click. The subscription amount flows the same way: OnlyFans API's {amount_gross} becomes Keitaro's payout.

Step-by-step setup

Point Keitaro's offer URL at your Smart Link

In your Keitaro campaign, set the offer URL to your Smart Link with ?ecid={subid} on the end:

https://trk.of-traffic.com/go/YOUR_SMART_LINK_ID?ecid={subid}

Replace YOUR_SMART_LINK_ID with the ID from your Smart Links dashboard. {subid} is Keitaro's macro for the click ID: Keitaro swaps it for the real click ID when it redirects the visitor, and the Smart Link reads it from the ecid parameter and saves it.

This has to be the offer URL set inside Keitaro so Keitaro performs the {subid} substitution, not a raw link posted straight to your traffic source. If you post the link directly, {subid} is never replaced and no click ID is captured.

Create the postback in OnlyFans API

Log into your OnlyFans API Dashboard, open Smart Links → Postbacks, and create a new postback with these settings:

HTTP method: GET
Conversion type: new_subscriber
Scope: Global (or Campaign-specific with this Smart Link attached)
URL:

https://YOUR_KEITARO_DOMAIN/YOUR_POSTBACK_KEY/postback?subid={external_click_id}&status=sale&payout={amount_gross}

A quick note on each value:

{external_click_id} outputs the Keitaro click ID captured in Step 1. This is what lets Keitaro match the conversion to the original click.
status=sale because a paid subscription is a confirmed sale. If this link is a free trial with no payment, use status=lead instead.
{amount_gross} is the subscription amount. Free-trial links send 0.00 here, which is expected.

Keep the YOUR_KEITARO_DOMAIN and YOUR_POSTBACK_KEY parts exactly as they appear in your own Keitaro postback URL, those are yours from Keitaro.

Don't use status=subscription, Keitaro doesn't recognize that value. Use status=sale for a paid subscription or status=lead for a free trial.

Confirm it works after one real subscription

Open your Smart Link and go to the Clicks report. The External Click ID column should show a value. If it does, Step 1 is working.
In the Conversions report, you should see a new_subscriber row with an External Click ID next to it.
The conversion should then show up in your Keitaro dashboard.

If the External Click ID column is empty in the Clicks report, the issue is Step 1 (Keitaro isn't passing the click ID in). Fix that first, no postback settings can work without it.

Keitaro ↔ OnlyFans API variables

Keitaro	OnlyFans API	Notes
`{subid}` macro (offer URL)	passed in via `?ecid={subid}`	Keitaro replaces it with the click ID at redirect
`subid` postback param	`{external_click_id}`	Matches the conversion back to the original click
`payout` postback param	`{amount_gross}`	Gross subscription amount; `0.00` for free trials
`status` postback param	static `sale` / `lead`	`sale` = paid sub, `lead` = free trial; never `subscription`

For the full list of postback variables (net vs gross amounts, fan and creator info, transaction details) and every available conversion type, see the Smart Links guide.

Troubleshooting

Problem	Fix
External Click ID column is empty in the Clicks report	Keitaro isn't passing the click ID. Make sure `?ecid={subid}` is on the offer URL inside Keitaro (not a raw link at your traffic source) so Keitaro substitutes `{subid}`.
Conversion shows in OnlyFans API but not in Keitaro	Check the postback URL's domain and key match your Keitaro postback exactly, and that `subid={external_click_id}` is present.
Keitaro ignores or rejects the conversion status	Use `status=sale` (paid) or `status=lead` (free trial). `status=subscription` is not recognized by Keitaro.
`payout` shows `0.00`	Expected for free-trial links (no payment). Paid subscriptions send the gross amount via `{amount_gross}`.

Connect Keitaro to OnlyFans API Smart Links

On this page