report/demand-comparison

Field and value reference · Markdown

curl -X GET "https://provisioning.cloudx.io/api/v1/report/demand-comparison?start_time=1712462400&end_time=1713067200" \
  -H "Authorization: Bearer $CLOUDX_API_KEY"

Responses

{
  "rows": [
    {
      "cloudx_revenue": 12.34,
      "partner_revenue": 12.34,
      "revenue_delta": 12.34,
      "revenue_delta_percent": 12.34,
      "cloudx_ecpm": 12.34,
      "partner_ecpm": 12.34,
      "ecpm_delta": 12.34,
      "ecpm_delta_percent": 12.34,
      "cloudx_impressions": 12.34,
      "partner_impressions": 12.34,
      "impression_delta": 12.34,
      "impression_delta_percent": 12.34,
      "demand_source": "<string>",
      "status": "comparable",
      "matched_ad_units": 12.34,
      "cloudx_ad_units": 12.34,
      "has_mapping_gaps": true,
      "partner_latest_report_date": "<string>",
      "partner_report_days": 12.34
    }
  ],
  "row_count": 123
}

Demand Comparison summary reference

This endpoint rolls up the full requested calendar-date window by demand source. It does not expose day, country, platform, mediator, or raw partner-report rows. CloudX-recognized values are CloudX reporting facts. Partner values come from the selected partner report.

start_time and end_time are required Unix seconds. CloudX converts each timestamp to a calendar date in timezone, which is an IANA time zone and defaults to UTC. The converted window is inclusive. The start date must be on or after 2020-01-01, and the end date must not precede it. Select any length of completed calendar-date window within available history. At or after 12:00 UTC, yesterday is the most recent complete date; before 12:00 UTC, it is the day before yesterday. Timezone conversion selects dates; it does not rebucket partner facts. Requested dates may have no CloudX or partner data.

demand_source is optional. Omit it to include every supported source, or repeat it for up to five unique values. The complete enum is digitalturbine, inmobi, liftoff, meta, and moloco. provider_business_id, provider_property_id, and cloudx_ad_unit_id are optional comma-separated filters. They accept live provider or CloudX identifiers, not closed enums. Provider IDs identify the partner account or property. CloudX IDs identify CloudX ad units.

The response contains rows and row_count. row_count is the number of returned source rows. Each supported source appears at most once.

Every row has these CloudX metrics:

The following partner and delta fields are numbers only when the partner data is available for the row. An absent field means unavailable. It does not mean zero. A comparable status confirms mapped report-date coverage, not that every metric is present. Providers can suppress revenue for low-volume slices.

JSON example

{
  "rows": [
    {
      "cloudx_revenue": 14.25,
      "partner_revenue": 13.9,
      "revenue_delta": 0.35,
      "revenue_delta_percent": 2.5179856115107913,
      "cloudx_ecpm": 11.875,
      "partner_ecpm": 11.583333333333334,
      "ecpm_delta": 0.2916666666666661,
      "ecpm_delta_percent": 2.5179856115107864,
      "cloudx_impressions": 1200,
      "partner_impressions": 1200,
      "impression_delta": 0,
      "impression_delta_percent": 0,
      "demand_source": "meta",
      "status": "comparable",
      "matched_ad_units": 2,
      "cloudx_ad_units": 2,
      "has_mapping_gaps": false,
      "partner_latest_report_date": "2026-04-01",
      "partner_report_days": 1
    }
  ],
  "row_count": 1
}