meta_get_breakdowns
LIVE Meta call: performance for the period (or any since/until within Meta's 37 months — this one does not need the warehouse) broken down by age, gender, country, publisher_platform or device_platform, account-wide (cached ten minutes).
read meta_get_breakdowns
LIVE Meta call: performance for the period (or any since/until within Meta's 37 months — this one does not need the warehouse) broken down by age, gender, country, publisher_platform or device_platform, account-wide (cached ten minutes). With adId, ONE ad's split as the creative sheet shows it — by placement (platform × position, e.g. IG Reels; under 2% of spend folded into Other) or age_gender — counted on that ad's resolved goal event with its target, plus the sheet's one-line takeaway (cached for hours per ad). With adId and by: retention, the video's retention curve (share of viewers still watching, per second when the upload's length is known), weighted by plays; empty for a static.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
period | 7d | 14d | 30d | this_week | last_week | No | Reporting window. 7d/14d/30d are the last N complete days, ending yesterday (as in Ads Manager); weeks are Monday-based, this_week runs to today. UTC. |
since | string | No | Custom window start, YYYY-MM-DD, UTC. Overrides period. The result's coverage says what the warehouse holds. |
until | string | No | Custom window end, YYYY-MM-DD, inclusive. Default today. |
by | age | gender | country | publisher_platform | device_platform | placement | age_gender | retention | Yes | |
adId | string | No | One ad's breakdown instead of the account's. Needs by: placement, age_gender or retention. |
get_ad_performanceread
Per-ad metrics for a period: spend, View Content, Add to Cart, VC→ATC rate, cost per ATC, leads (form / website) and cost per lead, conversations, plus purchase ROAS/CPA/AOV when that pixel fired, CPC (link), landing page views (cost, rate per link click), click→lead rate, checkouts and registrations with their costs, hook/hold, video retention (25/50/75/95/100% view rates over 3-second plays, average watch time — null on statics and on days synced before retention was stored), and the persona / angle / concept parsed from the ad name.
get_audience_breakdownread
LIVE Meta read (cached about an hour per workspace and window): who responds to each Value of a creative Dimension — goal cost per Value × age, gender, age × gender or placement (platform × position), the heat table behind a Value's "Who responds" (Library, /app/library?value=…) and Ads › Group by.