API docs

All Offers API

The All Offers API allows publishers to programmatically retrieve advertising campaigns tailored to account status, target devices, and promotion methods. This documentation covers data ingestion, multi-tier reward structures, and tracking implementation.

Quick Start

Retrieve your first batch of offers using curl:

curl "https://publishers.revenueuniverse.com/affiliates/api.php?wall=[WALL_ID]&key=[API_KEY]&action=offers&version=4"

curl "https://publishers.revenueuniverse.com/affiliates/api.php?wall=[WALL_ID]&key=[API_KEY]&action=offers&version=4"

curl "https://publishers.revenueuniverse.com/affiliates/api.php?wall=[WALL_ID]&key=[API_KEY]&action=offers&version=4"

Authentication

All requests require your private API key passed via the key parameter.

Location: Find your key in the Publisher Dashboard under My Account → API Key.
Security: ⚠️ Keep this key server-side. Never expose it in client-side code, frontend bundles, or public repositories.

API Reference

Base URL: https://publishers.revenueuniverse.com/affiliates/api.php

Request Parameters

Parameter	Type	Req	Description
`wall`	integer	Yes	Your unique Offer Wall ID.
`key`	string	Yes	Your API authentication key.
`action`	string	Yes	Must be set to `offers`.
`version`	integer	Yes	Use `4` for the latest features (including Multi-Reward support).
`offer`	integer	No	Filter by a specific Campaign ID (CID).

Data Schema

Success Response (JSON)

{
  "status": "success",
  "affiliate_id": 1234,
  "wall_id": 123,
  "offers": [
    {
      "cid": 46713,
      "name": "TikTok - Install and Watch Videos",
      "rate": 2.50,
      "currency": 250,
      "platform": "iOS",
      "countries": ["US", "CA"],
      "tiers": false,
      "url": "https://publishers.revenueuniverse.com/click.php?affiliate=1234&campaign=46713&sid2="
    }
  ]
}

{
  "status": "success",
  "affiliate_id": 1234,
  "wall_id": 123,
  "offers": [
    {
      "cid": 46713,
      "name": "TikTok - Install and Watch Videos",
      "rate": 2.50,
      "currency": 250,
      "platform": "iOS",
      "countries": ["US", "CA"],
      "tiers": false,
      "url": "https://publishers.revenueuniverse.com/click.php?affiliate=1234&campaign=46713&sid2="
    }
  ]
}

{
  "status": "success",
  "affiliate_id": 1234,
  "wall_id": 123,
  "offers": [
    {
      "cid": 46713,
      "name": "TikTok - Install and Watch Videos",
      "rate": 2.50,
      "currency": 250,
      "platform": "iOS",
      "countries": ["US", "CA"],
      "tiers": false,
      "url": "https://publishers.revenueuniverse.com/click.php?affiliate=1234&campaign=46713&sid2="
    }
  ]
}

Key Field Definitions

Category	Field	Type	Description
Financial	`rate`	float	Publisher payout in USD.
	`currency`	integer	Virtual currency amount awarded to the user.
	`epc`	float	Earnings Per Click (network-wide, last 7 days).
Targeting	`platform`	string	Target OS: `iOS`, `Android`, or `All`.
	`countries`	array	Allowed ISO 2-letter country codes.
	`user_level`	integer	Minimum user level (0 = no restriction).
Status	`cap`	object	Contains `maximum` allowed and current `position` (usage).
	`reporting`	string	Expected tracking delay: `Instant`, `Hourly`, `2-3 Days`.

Multi-Reward Offers (Tiers)

Offers with "tiers": true contain sequential milestones. To access these, use version=4.

Tier Object Properties

Field	Type	Description
`requirements`	string	Task for this specific tier (e.g., "Reach Level 10").
`rate`	float	Payout for this specific tier only.
`sid4`	string	Event Identifier: Used to distinguish specific milestones.

Integration Note: Use currency_with_tiers to display the total possible reward for completing the entire campaign sequence.

Offerwall Integration