API docs

Publisher API Reporting

Initial Setup

Note: If you are looking for the previous publisher API reporting docs, you can find them here.

We offer an API that your system can call daily to retrieve revenue statistics.

In order to access the API, you must have already created and setup your offerwall in our portal. Once you have done so, you will have the option to retrieve the API key for your account on this page. Please ensure you are using your account API Key and not the individual offerwall API key.

Summary API

1. Endpoint

Here is the template link your server should call:

http://publishers.revenueuniverse.com/affiliates/api.php?key=APIKEYHERE&action=summary&grouping=total&start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&dau=1

2. Parameters

key: This should be the API Key available in your account
startDate: This should be the start date of the period of time you are retrieving data for in the format of YYYY-MM-DD.
endDate: This should be the end date of the period of time you are retrieving data for in the format of YYYY-MM-DD.
(optional) timeZone: This parameter sets the time zone for the summary period. You can pass an IANA timezone, or an offset (e.g., -02:00 or America/Los_Angeles). If not provided, the default timezone is America/Chicago.
(optional) groupBy: This parameter will group the summary by the provided values. Possible values are country, wall, platform, and day. For example, if set to groupBy=wall,day, the results would contain a separate summary for each wall and day. As you add groupBy values, the API may take longer to process your request. If you find it takes longer than expected, please try to reduce the amount of grouping, or reduce the date range and try again.
(optional) include: This parameter will include additional fields in the summary response. The possible values are deu, awardedCurrency.
(optional) filter[wall]: This parameter will filter the walls returned. This can be a single wall ID, or a comma separated list of wall IDs, e.g. filter[wall]=300,301.
(optional) filter[country]: This parameter will filter the data by country. This can be a single country code, or a comma separated list of country codes, e.g. filter[country]=US,AU
(optional) filter[platform]: This parameter will filter the data by platform. This can be a single platform, or a comma separated list of platforms. The possible values are ios, android, and web, e.g. filter[platform]=ios,web

Results

Your call will return the following response.

{
  "publisherId": 123,
  "results": [
    {
      "impressions": 1000,
      "clicks": 200,
      "conversions": 50,
      "revenue": 75.50,
      "awardedCurrency": 100,
      "actualCurrencyRatio": 0.75,
      "platform": "IOS",
      "day": "2025-09-01",
      "country": "US",
      "wallId": 3,
      "wallName": "Offer Wall A",
      "bundleId": "com.example.app",
      "appName": "Example App",
      "deu": 10,
      "duc": 20,
      "epc": 0.15,
      "cvr": 0.25,
      "ecpm": 5.0,
      "arpdeu": 7.55,
      "arpduc": 3.78
    }
  ]
}

{
  "publisherId": 123,
  "results": [
    {
      "impressions": 1000,
      "clicks": 200,
      "conversions": 50,
      "revenue": 75.50,
      "awardedCurrency": 100,
      "actualCurrencyRatio": 0.75,
      "platform": "IOS",
      "day": "2025-09-01",
      "country": "US",
      "wallId": 3,
      "wallName": "Offer Wall A",
      "bundleId": "com.example.app",
      "appName": "Example App",
      "deu": 10,
      "duc": 20,
      "epc": 0.15,
      "cvr": 0.25,
      "ecpm": 5.0,
      "arpdeu": 7.55,
      "arpduc": 3.78
    }
  ]
}

{
  "publisherId": 123,
  "results": [
    {
      "impressions": 1000,
      "clicks": 200,
      "conversions": 50,
      "revenue": 75.50,
      "awardedCurrency": 100,
      "actualCurrencyRatio": 0.75,
      "platform": "IOS",
      "day": "2025-09-01",
      "country": "US",
      "wallId": 3,
      "wallName": "Offer Wall A",
      "bundleId": "com.example.app",
      "appName": "Example App",
      "deu": 10,
      "duc": 20,
      "epc": 0.15,
      "cvr": 0.25,
      "ecpm": 5.0,
      "arpdeu": 7.55,
      "arpduc": 3.78
    }
  ]
}

publisherId: ID number of the publisher
impressions: Number of impressions for specified time period
clicks: Number of clicks for specified time period
conversions: Number of conversions for specified time period
revenue: Revenue for specified time period
awardedCurrency: Awarded currency for the specified time period. This will only exist when include=awardedCurrency is passed.
actualCurrencyRatio: Actual currency ratio for the specified time period. This will only exist when include=awardedCurrency is passed.
platform: Platform for the specified time period. This will only exist when groupBy includes platform
day: Day for the specified time period. This will only exist when groupBy includes day
country: Country for the specified time period. This will only exist when groupBy includes country
wallId: Wall ID for the specified time period. This will only exist when groupBy includes wall
wallName: Wall name for the specified time period. This will only exist when groupBy includes wall
bundleId: Bundle id for the specified time period. This will only exist when groupBy includes wall
appName: App name for the specified time period. This will only exist when groupBy includes wall
deu: Daily engaged users in specified time period. This will only exist when include=deu is passed.
duc: Daily unique converters in specified time period
cvr: Conversion ratio specified time period
ecpm: Average eCPM for specified time period
arpdeu: Average revenue per daily engaged user for specified time period. This will only exist when include=deu is passed.
arpduc: Average revenue per daily unique converter for specified time period

Limits

The API will return click data for the last 90 days.
When retrieving larger time periods of data and grouping by multiple parameters, you may see the API timeout. If this happens, try to retrieve a smaller set of data over multiple requests. We recommend a time period of 30 days when not using the groupBy parameter, but this will depend on the amount of traffic you receive.

User-Level Offer API

Desktop integration (old)