API Integration (Advanced)
Get Personalized API
A per-user, server-ranked offer list with eligibility, personalization, and ban enforcement already applied.
Overview
The Get Personalized API returns a listing of offers that are right for a specific user on your wall, ranked best-first.
Unlike the Get Offers API (which hands you the full static catalog to filter yourself), this endpoint does the user-level personalization for you: the Get Personalized API checks eligibility, scores and ranks offers for that user, and suppresses any user who is banned server-side then returns a ready-to-render list of offers.
How It Works
Make a single
GETrequest for a specific user (uid) on a wall, asking for the top N offers.RevU evaluates eligibility, ranks the offers for that user, and enforces ban lists.
You receive a ranked list ready to display natively in your app or game.
This is an on-demand, per-user call. Results are tailored to the user at that moment so call it when you need the data rather than relying on cached data.
Client-side vs. server-side: Calling client-side lets RevU auto-detect the user's device and IP. If you call server-side, pass the user's device and ip so they reflect the real client environment.
Use Cases
Render a personalized offerwall tailored to a specific user's eligibility and engagement history.
Surface the most relevant offers first using server-side ranking, without additional client-side logic.
Automatically suppress RevU offers for banned or ineligible users before results are returned.
Incorporate a ban check into customer support interfaces.
Replace static catalog rendering with a dynamic, user-aware offer list for higher conversion.
API Key
No API key is required. You identify the request with your wall ID and user ID.
Info
If you're looking for the legacy User-Level Offer (/hotoffers_api.php) API documentation, you can find it here.
Share feedback on this documentation