> AffiliateOS Help Center. Index of every article for AI tools: https://www.affiliateos.ai/help/llms.txt

# Choose how to show offers

Getting started · For publishers · Updated 30 October 2026
Web version: https://www.affiliateos.ai/help/getting-started/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.

## Four ways, side by side

| 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](https://www.affiliateos.ai/glossary#tracking-link) for each | Our team | Sites and newsletters |

Every option sends conversions to the same [postback](https://www.affiliateos.ai/glossary#postback) URL, so set that up first: [from invite to your first conversion](https://www.affiliateos.ai/help/getting-started/publisher-first-conversion).

## Hosted Offerwall

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](https://www.affiliateos.ai/help/developers#offerwall) have the signing code.
- If **Properties & Apps** is in your menu, each property keeps its own wall instructions: open the property, then **Integrations**.

> **On wall postbacks, revenue is what you earn.** On the Hosted Offerwall, `revenue` is your earnings and `payout` is the player's reward. Through the Offer API, the Top Offers Feed or a link, `payout` is your earnings.

More on the [Hosted Offerwall page](https://www.affiliateos.ai/product/offerwall).

## Offer API

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`.

```bash
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](https://www.affiliateos.ai/help/account/create-rotate-revoke-api-keys). Every filter and field is in the [Offer API reference](https://www.affiliateos.ai/help/developers#offer-api), and the [Offer API page](https://www.affiliateos.ai/product/offer-api) shows it with live offers.

## Top Offers Feed

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](https://www.affiliateos.ai/help/developers#top-offers-feed) and on the [Top Offers Feed page](https://www.affiliateos.ai/product/top-offers-feed).

## Offer Links

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](https://www.affiliateos.ai/product/offer-links).

## Example: one app, two options

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://api.pebble.example/afos`. 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.

## Good to know

- 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=0` through the Offer API, the feed or a link, and with `revenue=0` on the wall.
- If the Top Offers Feed is switched off, `segment=top` returns an empty list, not an error. Fall back to the full Offer API list.