Skip to main content
GET
Publisher performance
The same figures as the Index page of your Gravity dashboard (revenue, index calls, recommendations, clicks, click-through rate, conversions, conversion rate, plus the daily series behind the chart), as JSON, for any window in the last 90 days. Both are computed from one shared query, so the API and the dashboard always agree for the same UTC date range.
Days are UTC. The dashboard buckets by UTC day too, so a range that matches the dashboard’s date picker returns the same totals as its cards.

Authentication

Send your publisher API key (the key you already use for POST /search) as the X-API-Key header. X-Platform-Api-Key is accepted as an alias.
string
required
Publisher API key. The publisher is resolved from the key alone; there is no publisher parameter.

Request

string
default:"publisher"
Must be publisher (the default). Any other value is 422.
string
First UTC day, YYYY-MM-DD. Defaults to 29 days before end_date (a 30-day window). Must be on or after available_from (today minus 90 days).
string
Last UTC day, YYYY-MM-DD, inclusive. Defaults to today (UTC). Cannot be in the future or before start_date.
Only side, start_date and end_date are accepted with an API key. Anything else (limit, status, …) is 422; those parameters belong to the dashboard session’s view of this route, which returns a different payload.

Response

string
Your publisher ID
string
Always UTC
string
First day in the window (YYYY-MM-DD)
string
Last day in the window (YYYY-MM-DD)
string
Earliest day you can request (today minus 90 days)
object
Totals over the window, the dashboard’s cards.
array
One entry per UTC day from start_date to end_date, ascending, zero-filled.
index_calls is usually higher than recommendations: searches that return no match, and consumer product searches, still count as calls. For a publisher on CPA-only programs this gap is expected, not a sign that calls are being lost.

Example

Omit both dates for the last 30 days ending today. Polling once a day is plenty; the limit is 60 requests per minute per publisher.