Meta Ads

List Meta Ads rev-share campaigns

Changed on

List the shop's Meta Ads (Cross-channel) rev-share campaigns, newest first, optionally filtered by status. Each row carries its lifecycle settings (commission base/rate, attribution window, usage-rights and whitelist grants) plus lightweight rollups: active_creators, lifetime attributed_revenue_cents, and unpaid commission_owed_cents. Single shop only.

get/meta-ads/campaigns

Request

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

Query parameters

statusstring nullable

Filter by lifecycle status: draft | active | paused.

Response

Successful Response

currencystring nullable

ISO 4217 currency of the shop's Meta ad account for the cents fields on each campaign; null when no ad account is connected.

Changes

    • warning

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

    • info

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • info

      api operation id list_campaigns_meta_ads_campaigns_get removed and replaced with meta_ads_campaigns_list

    • info

      response property campaigns/items/id deprecated

    • info

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