meta_get_audience_breakdown
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.
read meta_get_audience_breakdown
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. Every cell counts ONE event — the account goal (basis: account), else the most-spent event (basis: dominant) — over only the ads bought for it; ads bought for other events are left out of every cell and reported in excluded ({ ads, spend }), so unlike events are never summed. An ad carrying two Values of the Dimension counts under each (rows do not add up to totals). Cells under 3 results carry no cost and scored: false: too few to rank best or worst. With valueId (a Value id or slug) only that Value's row. Observational: Meta chose who saw each ad, so a cell is a lead to test, not a verdict.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
by | angle | persona | awareness | offer | offer_type | pain | season | asset_type | format | hook | headline_tactic | talent | visual | Yes | The creative Dimension whose Values are the rows. |
cross | age | gender | age_gender | placement | No | The audience axis: age, gender, age_gender or placement. |
period | 7d | 14d | 30d | this_week | last_week | No | Window: the last N complete days (as in Ads Manager), or a week. |
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. |
valueId | string | No |
get_breakdownsread
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).
get_cross_analysisread
Cross analysis inside ONE funnel: one Dimension (rows) or two against each other (rows × columns) — angle, persona, awareness, offer, pain, format, hook, talent, visual, copy, cta, language, market, landing, media.