Analyze estimated ad spend
get_top_ads_statsRead-onlyIdempotent
Public demo: Alex Hormozi only (page_id 116482854782233). Ad listings/details expose only approved public creatives; statistics describe this advertiser only. Analyze latest cumulative estimated spend in EUR for your tracked advertisers. page_id is an exact advertiser filter. timeframe filters when ads were last seen, NOT spend accrued during that period. Creative breakdowns sample the top 1,000 ads; response metadata states matched and sampled counts and full-match aggregate spend. Zero can mean unavailable estimates.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| page_id | No | Meta advertiser page ID, kept as a string. | |
| project | No | Only all is available in the public demo. | |
| category | No | ||
| timeframe | No | Last-seen window; never a period-spend calculation. | 30d |
| media_type | No | all | |
| active_only | No |