api_v3_stats

Publisher stats

Returns publisher statistics for the given period. Optionally grouped by date, country, and/or sub_id.

get/api/v3/stats

Request

  • Base URL: https://api.richads.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.richads.com/api/v3/stats
  • Auth: HTTP bearer

Query parameters

date_fromstring date required
Example:2025-01-01

Start date (YYYY-MM-DD). Date range cannot exceed one month.

date_tostring date required
Example:2025-01-07

End date (YYYY-MM-DD). date_to must be >= date_from; range cannot exceed one month.

group_bystring
Example:date,country,sub_id

Comma-separated groupings: date, country, sub_id

zone_idinteger required
Example:357658

Zone ID

sub_idstring
Example:sub_123

Sub ID

Response

Stats

Example response

{
  "data": [
    {
      "date": "2025-01-01",
      "country": "USA",
      "sub_id": "[SUB_ID]",
      "zone_id": 1,
      "impressions": 12000,
      "clicks": 340,
      "revenue": 45.67
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.