REreacherapp
Meta Ads

Meta Ads campaign leaderboard + totals

Changed on

The Creators-tab view for one campaign: five summary-card totals (attributed GMV, impressions/views, GMV per video, ad spend, commission owed) plus a per-creator leaderboard with each creator's attributed GMV, ad spend, impressions, distinct attributed ads, lifetime vs. outstanding commission, and Partnership-ad whitelist status. Every metric is Meta-side (from the attribution ledger) — TikTok organic stats are not mixed in. All cents are in the shop's Meta ad account currency (echoed as currency). Single shop only.

get/meta-ads/campaigns/{campaign_id}/rollups

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/meta-ads/campaigns/{campaign_id}/rollups
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Path parameters

campaign_idstring required

Query parameters

pageinteger

1-indexed leaderboard page.

page_sizeinteger

Leaderboard rows per page. Defaults to the maximum so a caller that ignores paging still receives a full page; read creator_total / total_pages to walk the rest.

Response

Successful Response

creator_totalinteger

Creators on the campaign across all pages, unaffected by search.

filtered_totalinteger

Creators matching the request's search across all pages — the paging denominator. Equals creator_total when no search is set.

pageinteger

1-indexed page these creators came from.

page_sizeinteger

Rows requested per page.

total_pagesinteger

Pages available at this page_size.

currencystring nullable

ISO 4217 currency of the shop's connected Meta ad account (all cents amounts are in this currency). Null when no ad account is connected or the currency is unknown.

Changes

  • 291230805105Revision changes
    • warning

      added the new accepted enum value to the // response property for the response status

    • warning

      added the new active enum value to the // response property for the response status

    • warning

      added the new invited enum value to the // response property for the response status

    • warning

      added the new pending enum value to the // response property for the response status

    • info

      api operation id campaign_rollups_meta_ads_campaigns__campaign_id__rollups_get removed and replaced with meta_ads_campaign_rollups

    • info

      added the optional property to the response with the status

    • info

      added subschema #1 to the // response property anyOf list for the response status

  • 02635188ace8Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status