Reports and earnings

Use these read-only endpoints to get the numbers from your publisher dashboard: your profile, daily earnings, the ad request funnel, and results by device and country.

GET `/publisher-dashboard/info`

Returns your publisher profile and lifetime totals.

string

required

Your Gravity API key.

Request

curl https://platform.trygravity.com/publisher-dashboard/info \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "publisher_id": "abc-123",
  "name": "My Platform",
  "url": "https://myplatform.com",
  "payout_model": "CPM",
  "total_impressions": 7800000,
  "total_clicks": 42000
}

GET `/publisher-dashboard/stats`

Returns a daily time series of impressions, clicks, revenue, CPM, CPC, and CTR. The values are the same as on the Overview and Earnings pages of the dashboard.

integer

default:"30"

The number of days to look back, from 1 to 3650.

string

The start date (YYYY-MM-DD). Use it with end_date. A date range replaces days.

string

The end date (YYYY-MM-DD).

string

default:"UTC"

The IANA time zone for the daily buckets, for example America/New_York.

The response has more fields than the example. The example shows the main fields.

Request

curl "https://platform.trygravity.com/publisher-dashboard/stats?days=7&tz=America/New_York" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "totalImpressions": 250000,
  "totalClicks": 1200,
  "totalRevenue": 1250.50,
  "avgCpm": 5.00,
  "avgCpc": 1.04,
  "avgCtr": 0.48,
  "timeSeries": [
    {
      "date": "2025-05-20",
      "impressions": 35000,
      "clicks": 170,
      "revenue": 178.50,
      "cpm": 5.10,
      "cpc": 1.05,
      "ctr": 0.49
    }
  ]
}

GET `/publisher-dashboard/activity`

Returns the ad request funnel: requests, wins, impressions, fill rate, and show rate.

integer

default:"7"

The number of days to look back, from 1 to 30.

string

The start date (YYYY-MM-DD). Use it with end_date. A date range replaces days.

string

The end date (YYYY-MM-DD).

string

default:"UTC"

The IANA time zone for the daily buckets, for example America/New_York.

Field	Description
`fill_rate`	How often a campaign matched: `wins / requests`.
`show_rate`	How often a matched ad became visible: `impressions / wins`.
`bot_requests`, `total_bot_requests`, `bot_request_rate`	The requests that the engine marked as bot traffic.

Request

curl "https://platform.trygravity.com/publisher-dashboard/activity?days=7" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "data": [
    {
      "date": "2025-05-20",
      "requests": 50000,
      "bot_requests": 500,
      "wins": 35000,
      "impressions": 30000
    }
  ],
  "total_requests": 350000,
  "total_bot_requests": 3500,
  "bot_request_rate": 0.01,
  "total_wins": 245000,
  "total_impressions": 210000,
  "fill_rate": 0.70,
  "show_rate": 0.8571
}

GET `/publisher-dashboard/devices`

Returns the results for each device type (desktop, mobile, and tablet).

integer

default:"30"

The number of days to look back, from 1 to 365.

string

The start date (YYYY-MM-DD). Use it with end_date. A date range replaces days.

string

The end date (YYYY-MM-DD).

string

default:"UTC"

The IANA time zone for the daily buckets, for example America/New_York.

Request

curl "https://platform.trygravity.com/publisher-dashboard/devices?days=30" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "devices": [
    {
      "device_type": "desktop",
      "impressions": 150000,
      "clicks": 750,
      "ctr": 0.005,
      "revenue": 750.00,
      "cpm": 5.00,
      "cpc": 1.00,
      "daily": [
        {
          "date": "2025-05-20",
          "device_type": "desktop",
          "impressions": 5000,
          "clicks": 25,
          "ctr": 0.005,
          "revenue": 25.00,
          "cpm": 5.00,
          "cpc": 1.00
        }
      ]
    }
  ],
  "period_days": 30
}

GET `/publisher-dashboard/geography`

Returns the results for each country.

integer

default:"30"

The number of days to look back, from 1 to 365.

string

The start date (YYYY-MM-DD). Use it with end_date. A date range replaces days.

string

The end date (YYYY-MM-DD).

string

default:"UTC"

The IANA time zone for the daily buckets, for example America/New_York.

Request

curl "https://platform.trygravity.com/publisher-dashboard/geography?days=30" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "countries": [
    {
      "country_code": "US",
      "impressions": 500000,
      "clicks": 2500,
      "ctr": 0.005,
      "revenue": 2500.00,
      "cpm": 5.00,
      "cpc": 1.00
    }
  ],
  "period_days": 30
}

GET `/publisher-dashboard/countries`

Returns your top countries by number of requests, with the number of unique users in each country.

integer

default:"20"

The number of countries to return, from 1 to 100.

Request

curl "https://platform.trygravity.com/publisher-dashboard/countries?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "countries": [
    {
      "country_code": "US",
      "requests": 200000,
      "ads_served": 140000,
      "unique_users": 8000,
      "pct_requests": 57.1
    }
  ]
}

Get started

Advertisers

Publishers

API reference

Resources

Reports and earnings

GET `/publisher-dashboard/info`

GET `/publisher-dashboard/stats`

GET `/publisher-dashboard/activity`

GET `/publisher-dashboard/devices`

GET `/publisher-dashboard/geography`

GET `/publisher-dashboard/countries`

​GET /publisher-dashboard/info

​GET /publisher-dashboard/stats

​GET /publisher-dashboard/activity

​GET /publisher-dashboard/devices

​GET /publisher-dashboard/geography

​GET /publisher-dashboard/countries

GET `/publisher-dashboard/info`

GET `/publisher-dashboard/stats`

GET `/publisher-dashboard/activity`

GET `/publisher-dashboard/devices`

GET `/publisher-dashboard/geography`

GET `/publisher-dashboard/countries`