Choose how to show offers
If you run a rewarded app, start with the Hosted Offerwall: one iframe, link or webview, and we handle the list, the order and the reward math. Build your own offer screen with the Offer API, take our ranked short list with the Top Offers Feed, or, for a site or a newsletter, have our team pick offers and send you Offer Links.
On this page
| Option | What you build | Who orders the list | Best for |
|---|---|---|---|
| Hosted Offerwall | Only the frame: an iframe, a link or a webview that carries your user’s ID | We do | Rewarded apps. Start here. |
| Offer API | Your own offer screen, filled from one server call | You do | Teams with their own offer screens |
| Top Offers Feed | Your own screen, from the same call with segment=top | We do: our picks and offers proven in the last 30 days | A short list without ranking it yourself |
| Offer Links | Nothing. Our team picks offers for your audience and sends a tracking link for each | Our team | Sites and newsletters |
Every option sends conversions to the same postback URL, so set that up first: from invite to your first conversion.
Open Docs, then Hosted Offerwall. When your account has one wall that opens with simple links, the snippet there already carries your wall’s ID: choose Copy snippet and put your user’s ID where it says uid. That ID comes back as sub_id on every postback.
- What your users see the reward called, and what share of your payout they’re shown: My Profile, then Offerwall.
- A wall set to signed links needs each link made on your server, so the secret never reaches your app. The offerwall docs have the signing code.
- If Properties & Apps is in your menu, each property keeps its own wall instructions: open the property, then Integrations.
More on the Hosted Offerwall page.
One call returns every offer your account can run, with your payout for each step and a tracking link. You choose what to show and in what order, then put your user’s ID in each link’s sub_id.
curl -G "https://affiliateos.xyz/publisher/offers" \
-d platform=iOS -d country=US \
-H "x-api-key: $AFFILIATEOS_KEY"Your key comes from My Profile, then API Keys: see Create, rotate and revoke API keys. Every filter and field is in the Offer API reference, and the Offer API page shows it with live offers.
The same call with segment=top. It returns our picks and the offers proven by conversions across AffiliateOS in the last 30 days, in an order we set and refresh daily. Each row still carries your own payout, tracking link and filters, and sort is ignored. Details in the Top Offers Feed reference and on the Top Offers Feed page.
No code. Our team picks offers that fit your audience and sends you a tracking link for each one. When new offers go live, we post them in your Slack channel. Under Email alerts you can get an email when an offer you run changes its payout or stops running. See the Offer Links page.
Example. Pebble Rewards, a rewarded app paying 1,000 pebbles per $1, launches with the Hosted Offerwall. Under My Profile, then Offerwall, it names its currency pebbles at 1,000 per dollar, and pastes the snippet into its Earn tab with each player’s ID, such as u_48213, as the uid.
Two months later it adds a Featured games row to its home screen from the Top Offers Feed. Both send conversions to https://. Its server credits each player from user_payout, which both send, and books its own earnings from revenue on wall postbacks and payout on feed postbacks.
- You can run more than one option at once. They share your postback URL and your user IDs.
- Games paid per install pay you once, at install. Later steps reward the player: they post back with
payout=0through the Offer API, the feed or a link, and withrevenue=0on the wall. - If the Top Offers Feed is switched off,
segment=topreturns an empty list, not an error. Fall back to the full Offer API list.