Query Parameters

This API is now deprecated. Access to this API will be removed in late June 2023 after which the Tapjoy GraphQL API must be used for reporting purposes.

1. Query Parameters

Parameter Required? Values Description
date YES YYYY-MM-DD The date you are requesting data for
page_size NO 0 < Integer value <= number of apps in your account This is how many apps you want returned in the JSON response in one page. The larger this value is the longer the response will take. The default value is 1 if you do not pass a value.
page NO 0 < Integer value <= max pages The page you want returned, we will return the first page if no page is specified.
time_increment NO hourly, daily Returns the data in broken down by hour or day. Daily is the default.
group_by NO placements, content_types, content_cards Returns the data by content type by default. If you use placements or content_cards, it will return the revenue broken down by placement or content card instead.
mock NO 0, 1 Passing 1 will return test data so you can verify that your parsing script is correct. Not having this parameter or using 0 returns real data from your account.

2. JSON Example

A. Example response when grouping by apps

{
  "Date": "2016-10-01",
  "TotalApps": 2,
  "PageSize": 1,
  "TotalPages": 2,
  "CurrentPage": 1,
  "Apps": [
    {
      "Name": "MyTapjoy",
      "Platform": "android",
      "AppKey": "bba49f11-b87f-4c0f-9632-21aa810dd6f1",
      "ContentTypes": [
        {
          "ContentType": "DirectPlay",
          "Global": {
            "Clicks": 0,
            "Conversions": 0,
            "Impressions": 0,
            "Revenue": 0,
            "ECPM": 0
          },
          "Countries": []
        },
        {
          "ContentType": "FullScreenInterstitial",
          "Global": {
            "Clicks": 0,
            "Conversions": 0,
            "Impressions": 0,
            "Revenue": 0,
            "ECPM": 0
          },
          "Countries": []
        },
        {
          "ContentType": "Offerwall",
          "Global": {
            "Revenue": 6010.0208,
            "Impressions": 176610,
            "Clicks": 91910,
            "Conversions": 24910,
            "DAU": 100203,
            "DUV": 100203,
            "DUC": 17028,
            "ECPM": 34.0299
          },
          "Countries": [
            {
              "Country": "ae",
              "Revenue": 0,
              "Impressions": 7,
              "Clicks": 3,
              "Conversions": 0,
              "DAU": 1,
              "DUV": 1,
              "DUC": 0,
              "ECPM": 0
            },
            {
              "Country": "ar",
              "Revenue": 0,
              "Impressions": 6,
              "Clicks": 0,
              "Conversions": 0,
              "DAU": 1,
              "DUV": 1,
              "DUC": 0,
              "ECPM": 0
            },
            {
              "Country": "at",
              "Revenue": 0.056,
              "Impressions": 32,
              "Clicks": 21,
              "Conversions": 1,
              "DAU": 20,
              "DUV": 20,
              "DUC": 1,
              "ECPM": 1.75
            },
            {
              "Country": "au",
              "Revenue": 0.3304,
              "Impressions": 7,
              "Clicks": 6,
              "Conversions": 2,
              "DAU": 3,
              "DUV": 3,
              "DUC": 2,
              "ECPM": 47.2
            },
            {
              "Country": "ba",
              "Revenue": 0,
              "Impressions": 1,
              "Clicks": 0,
              "Conversions": 0,
              "DAU": 1,
              "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "bd",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "be",
                "Revenue": 0.42364,
                "Impressions": 19,
                "Clicks": 6,
                "Conversions": 3,
                "DAU": 11,
                "DUV": 11,
                "DUC": 3,
                "ECPM": 22.29684
              },
              {
                "Country": "bg",
                "Revenue": 0.0476,
                "Impressions": 4,
                "Clicks": 4,
                "Conversions": 1,
                "DAU": 2,
                "DUV": 2,
                "DUC": 1,
                "ECPM": 11.9
              },
              {
                "Country": "bh",
                "Revenue": 0.056,
                "Impressions": 2,
                "Clicks": 1,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 28
              },
              {
                "Country": "br",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ca",
                "Revenue": 0.84952,
                "Impressions": 9,
                "Clicks": 6,
                "Conversions": 3,
                "DAU": 4,
                "DUV": 4,
                "DUC": 2,
                "ECPM": 94.39111
              },
              {
                "Country": "ch",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "cl",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "co",
                "Revenue": 0.224,
                "Impressions": 19,
                "Clicks": 7,
                "Conversions": 1,
                "DAU": 8,
                "DUV": 8,
                "DUC": 1,
                "ECPM": 11.78947
              },
              {
                "Country": "cz",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "de",
                "Revenue": 2.4528,
                "Impressions": 6,
                "Clicks": 3,
                "Conversions": 1,
                "DAU": 3,
                "DUV": 3,
                "DUC": 1,
                "ECPM": 408.8
              },
              {
                "Country": "dk",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "dm",
                "Revenue": 0,
                "Impressions": 5,
                "Clicks": 2,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "dz",
                "Revenue": 0,
                "Impressions": 20,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 17,
                "DUV": 17,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ec",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 2,
                "DUV": 2,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "eg",
                "Revenue": 0,
                "Impressions": 11,
                "Clicks": 8,
                "Conversions": 0,
                "DAU": 8,
                "DUV": 8,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "es",
                "Revenue": 6.0648,
                "Impressions": 321,
                "Clicks": 166,
                "Conversions": 57,
                "DAU": 302,
                "DUV": 302,
                "DUC": 50,
                "ECPM": 18.89346
              },
              {
                "Country": "fi",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "fr",
                "Revenue": 10.44092,
                "Impressions": 219,
                "Clicks": 143,
                "Conversions": 50,
                "DAU": 202,
                "DUV": 202,
                "DUC": 47,
                "ECPM": 47.67543
              },
              {
                "Country": "gb",
                "Revenue": 18.75832,
                "Impressions": 351,
                "Clicks": 216,
                "Conversions": 69,
                "DAU": 312,
                "DUV": 312,
                "DUC": 64,
                "ECPM": 53.44251
              },
              {
                "Country": "gh",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "gr",
                "Revenue": 0.3094,
                "Impressions": 2,
                "Clicks": 1,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 154.7
              },
              {
                "Country": "hk",
                "Revenue": 0.0532,
                "Impressions": 3,
                "Clicks": 2,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 17.73333
              },
              {
                "Country": "hr",
                "Revenue": 0,
                "Impressions": 6,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 5,
                "DUV": 5,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "id",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ie",
                "Revenue": 0.056,
                "Impressions": 33,
                "Clicks": 20,
                "Conversions": 1,
                "DAU": 15,
                "DUV": 15,
                "DUC": 1,
                "ECPM": 1.69697
              },
              {
                "Country": "il",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 2,
                "Conversions": 0,
                "DAU": 2,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "in",
                "Revenue": 0.084,
                "Impressions": 20,
                "Clicks": 8,
                "Conversions": 1,
                "DAU": 19,
                "DUV": 19,
                "DUC": 1,
                "ECPM": 4.2
              },
              {
                "Country": "iq",
                "Revenue": 0,
                "Impressions": 15,
                "Clicks": 7,
                "Conversions": 0,
                "DAU": 12,
                "DUV": 12,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "is",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "it",
                "Revenue": 0.6608,
                "Impressions": 25,
                "Clicks": 13,
                "Conversions": 5,
                "DAU": 18,
                "DUV": 18,
                "DUC": 5,
                "ECPM": 26.432
              },
              {
                "Country": "je",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "jo",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 2,
                "Conversions": 0,
                "DAU": 2,
                "DUV": 2,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "jp",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ke",
                "Revenue": 0,
                "Impressions": 8,
                "Clicks": 2,
                "Conversions": 0,
                "DAU": 4,
                "DUV": 4,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "kw",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "lb",
                "Revenue": 0,
                "Impressions": 3,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "lt",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ma",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "mk",
                "Revenue": 0.3094,
                "Impressions": 2,
                "Clicks": 2,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 154.7
              },
              {
                "Country": "mt",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "mx",
                "Revenue": 0.14,
                "Impressions": 18,
                "Clicks": 3,
                "Conversions": 1,
                "DAU": 5,
                "DUV": 5,
                "DUC": 1,
                "ECPM": 7.77778
              },
              {
                "Country": "ng",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "nl",
                "Revenue": 2.5634,
                "Impressions": 191,
                "Clicks": 107,
                "Conversions": 16,
                "DAU": 123,
                "DUV": 123,
                "DUC": 8,
                "ECPM": 13.42094
              },
              {
                "Country": "no",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "nz",
                "Revenue": 0,
                "Impressions": 5,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "pe",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "pk",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "pm",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "pr",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "ps",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "pt",
                "Revenue": 0,
                "Impressions": 8,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "qa",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "re",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "rs",
                "Revenue": 0,
                "Impressions": 4,
                "Clicks": 3,
                "Conversions": 0,
                "DAU": 2,
                "DUV": 2,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "sa",
                "Revenue": 9.48556,
                "Impressions": 257,
                "Clicks": 101,
                "Conversions": 15,
                "DAU": 56,
                "DUV": 56,
                "DUC": 9,
                "ECPM": 36.90879
              },
              {
                "Country": "sc",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "se",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 0,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "sg",
                "Revenue": 0.4732,
                "Impressions": 13,
                "Clicks": 5,
                "Conversions": 2,
                "DAU": 2,
                "DUV": 2,
                "DUC": 1,
                "ECPM": 36.4
              },
              {
                "Country": "si",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "sk",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "sy",
                "Revenue": 0,
                "Impressions": 0,
                "Clicks": 1,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "th",
                "Revenue": 0.448,
                "Impressions": 3,
                "Clicks": 1,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 149.33333
              },
              {
                "Country": "tr",
                "Revenue": 0,
                "Impressions": 2,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "tt",
                "Revenue": 0,
                "Impressions": 3,
                "Clicks": 2,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 1,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "us",
                "Revenue": 5944.4562,
                "Impressions": 174787,
                "Clicks": 90955,
                "Conversions": 24647,
                "DAU": 6003,
                "DUV": 6003,
                "DUC": 2004,
                "ECPM": 34.0097
              },
              {
                "Country": "uy",
                "Revenue": 0,
                "Impressions": 1,
                "Clicks": 0,
                "Conversions": 0,
                "DAU": 1,
                "DUV": 0,
                "DUC": 0,
                "ECPM": 0
              },
              {
                "Country": "za",
                "Revenue": 0.28,
                "Impressions": 2,
                "Clicks": 1,
                "Conversions": 1,
                "DAU": 1,
                "DUV": 1,
                "DUC": 1,
                "ECPM": 140
              }
            ]
          },
          {
            "ContentType": "Tapjoy.com",
            "Global": {
              "Revenue": 0,
              "Impressions": 0,
              "Clicks": 0,
              "Conversions": 0,
              "ECPM": 0
            },
            "Countries": []
          },
          {
            "ContentType": "Banner",
            "Global": {
              "Revenue": 0,
              "Impressions": 0,
              "Clicks": 0,
              "Conversions": 0,
              "ECPM": 0
            },
            "Countries": []
          }
        ]
      }
    ]
}

B. Example response when grouping by content cards

{
  "Date": "2021-05-21",
  "TotalApps": 1,
  "PageSize": 1,
  "TotalPages": 1,
  "CurrentPage": 1,
  "Apps": [
    {
      "Name": "MyTapjoy",
      "Platform": "iphone",
      "AppKey": "13b0ae6a-8516-4405-9dcf-fe4e526486b2",
      "ContentCards": []
    }
  ]
}

C. Example response when grouping by placements

{
  "Date": "2021-05-21",
  "TotalApps": 1,
  "PageSize": 1,
  "TotalPages": 1,
  "CurrentPage": 1,
  "Apps": [
    {
      "Name": "MyTapjoy",
      "Platform": "iphone",
      "AppKey": "13b0ae6a-8516-4405-9dcf-fe4e526486b2",
      "Placements": [
        {
          "Name": "offerwall_unit",
          "Global": {
            "Revenue": 0,
            "Impressions": 5,
            "Clicks": 1,
            "Conversions": 0,
            "DUV": 1,
            "DUC": 0,
            "ECPM": 0
          },
          "Countries": [
            {
              "Country": "us",
              "Revenue": 0,
              "Impressions": 5,
              "Clicks": 1,
              "Conversions": 0,
              "DUV": 1,
              "DUC": 0,
              "ECPM": 0
            }
          ]
        }
      ]
    }
  ]
}

3. Field Descriptions

General Object Description Value
Date Date of the data in following format: YYYY-MM-DD Date String in following format: YYYY-MM-DD
TotalApps The total number of apps Integer number
PageSize The number of apps we will return per page. If you want all your apps in one response, you can set this to your total number of apps. We basically return the value you passed to us in the parameter so it could be larger than the number of apps in your app list. Integer number
TotalPages The total number of pages for this report Integer number
CurrentPage Current page number Integer number
Name App Name String
AppKey Unique app id for this app (not the SDK key) appID, not normalized
Platform Platform of this app android, ios
Status This will return a message to let you know if there was an error String
Country The country where the revenue/spend occurred. (2 letter country code) us, ca, gb, … all lowercase
Content Type Object Description Value
Type This is the content’s type. The available types are: "DirectPlay" (rewarded video), "Offerwall", "FullScreenInterstitial", "Tapjoy.com" (deprecated), and "Banner" (deprecated). You can see these all in the JSON sample response above (2A). String
Impressions For M2E, N2E, P2E, this would be the primary offer’s impressions Integer number
Clicks The primary content’s clicks Integer number
Conversions The primary content’s conversions Integer number
Revenue The primary content’s total revenue in USD Float number
eCPM eCPM of this content unit for the specified day. There is no hourly version of this metric. Integer number
DUV Number of unique users that viewed an Offerwall in the app Integer number
DUC Number of unique users that converted on an Offerwall ad in the app Integer number
Placement Object Description Value
Name The placement name as listed in the dashboard String
Impressions Total number of impressions for this placement for ad units, this excludes impressions from non-revenue generating sources like the message in M2E. Integer Number
Clicks Total number of clicks for this placement Integer Number
Conversions Total number of conversions for this placement Integer Number
Revenue Total revenue for this placement in USD Float Number
eCPM eCPM for this placement. There is no hourly version of this metric. Float Number
DUV Number of unique users who viewed an ad in this placement or content card Integer number
DUC Number of users who converted on an ad from this placement or content card Integer number

4. Errors

Error Code Meaning Solution
400 Bad Request Check that your parameters are correct.
401 Bad or missing authentication token Check your authentication token to make sure it is correct and hasn’t expired.
500 Internal server error Try again or contact support@tapjoy.com if the problem persists.
429 Too many requests Lower the frequency of your calls.