Get Offers API

Overview

The Get Offers API returns the full eligible offer catalog for a publisher wall. A single authenticated request returns every offer currently eligible for your offerwall. The response is a static catalog suitable for caching for a few minutes between calls. This call provides you with everything you need to display offers within your product, including payouts, multi-step reward events, targeting restrictions, capping state, dayparting, creatives, and performance metrics.

The API supports filtering options to limit results by country, state, dayparting, capping, and platform. Note that this endpoint returns the same catalog for every user on a wall and does not support per-user personalization. For user-level offer recommendations, use the Get Personalized API instead.

How It Works

1. Make a single GET request for a given wall, authenticated with your API key.

2. RevU returns the eligible offer catalog for that wall as JSON.

3. Cache the response (a few minutes is ideal), render the offers, and send users to each offer's tracking link.

4. Conversions are reported back to you via postback, configured separately in your account.

Use Cases

• Render a publisher's full offerwall with the complete available offer catalog.

• Cache and serve offer listings efficiently without making a call on every page load.

• Real-time check on capping state to determine whether an offer should be shown or suppressed for a given session.

API Key

This call requires your Account API key, which can be retrieved in the Publisher Portal under My Account > Account API Key.