Campaigns

get/api/v2/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/v2/stats
  • Auth: HTTP bearer

Query parameters

dateFromstring date required
Example:2024-01-01
dateTostring date required
Example:2024-02-29

Max 2 months range

groupBy'date' | 'hour' | 'country' | 'site-id' | 'publisher-id' | 'ssp-id' | 'subscription-list' | 'isp' | 'carrier' | 'os' | 'browser' | 'region' | 'city' | 'device' | 'connection-type' | 'browser-language' | 'campaign-id'
Example:date
pageinteger
perPageinteger
status'active' | 'paused'
channel'push' | 'pops' | 'display' | 'telegram' | 'xml_native'
searchstring

Response

Returns aggregated campaign statistics for the advertiser.

Example response

{
  "data": [
    {
      "date": "2024-01-01",
      "impressions": 15000,
      "clicks": 350,
      "conversions": 25,
      "conversions1": 20,
      "conversions2": 15,
      "conversions3": 10,
      "spend": 175.5,
      "ctr": 2.33,
      "conversionRate": 7.14,
      "cpc": 0.5,
      "cpa": 7.02
    }
  ],
  "pagination": {
    "totalPages": 3,
    "page": 1,
    "perPage": 20,
    "totalItems": 42
  }
}

Changes

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