List ad accounts
Lists the Meta ad accounts this connector is configured to read, with their names, currencies and status. Start here when you do not know which account a question is about. Accounts outside this list cannot be read by this connector at all.
Get an ad account
Returns the detail for one ad account: name, currency, timezone, status, total spent, and any spend cap. Use it to establish the currency and timezone before interpreting spend figures, or to check whether an account is active.
Search campaigns
Lists campaigns in an ad account, with their status, objective, budget and schedule. Filter by status to see only what is running. Use it to find a campaign before asking about its performance. This returns setup detail, not results: use get_performance for spend and outcomes.
Get a campaign
Returns the full setup detail for one campaign: objective, status, budget, buying type and schedule. Use it once you have a campaign id from search_campaigns.
List ads
Lists the ads in an account with their status, campaign and ad set. Use it to find an ad id when you do not have one from a performance query, or to see what is live right now. For what an ad actually says, use get_ad.
Get an ad and its creative
Returns one ad with the creative it is actually running: the headline, the body text, the call to action, the image or video, and where it sends people. Use it when performance shows one ad beating another and you want to know what the winning ad said, rather than inferring it from the ad name. Ad ids come from get_performance at ad level.
Get an ad set
Returns the setup for one ad set: what it is optimising for, how it bids, its budget and schedule, and who it is targeting by age, location and audience. Use it when performance shows an ad set spending and you want to know who it spent on. Ad set ids come from get_performance at adset level or from get_ad.
Get performance
Returns spend and results for a period, broken down by account, campaign, ad set or ad. This is the main reporting tool: use it for what an account spent, which campaigns are working, what a campaign cost per result, or how spend moved day by day. Rows come back highest spend first. Always report the currency it returns rather than assuming one.
Get an audience breakdown
Returns spend and results split by who saw the ads or where they saw them: age, gender, country, region, or the platform and placement. Use it for questions about which audience is responding, where budget is going, or whether Instagram is outperforming Facebook. Ask about one breakdown at a time.