Facebook Ads API

  • Facebook Ads API (Meta Marketing API) — Full Profile (English, 2026-09)

    Meta Platforms Inc., Menlo Park CA; Graph API surface formerly “Facebook Ads API” renamed Marketing API​ (covers Facebook + Instagram + Messenger + Audience Network + Threads placements); public-traded NASDAQ: META; ships official MCP server beta Apr 2026​ (https://mcp.facebook.com/ads, 29 tools) — first major ads platform with agent surface at launch; not a SaaS product, not per-seat, not per-call-billed.

    Website

    Field Value
    Official Website https://developers.facebook.com/docs/marketing-api · Graph API overview: https://developers.facebook.com/docs/graph-api · versioning: v21.0 current (2-yr deprecation clock) · MCP: https://mcp.facebook.com/ads (beta Apr 2026, OAuth DCR)
    Company Meta Platforms Inc. (NASDAQ:META), Menlo Park; Marketing API is a developer surface of Meta Business, not a standalone entity; public-traded, not acquired, not PE, not bootstrap, not open-source; SOC 2 / ISO 27001 / GDPR / CCPA on Business side.
    Status Active, versioned quarterly, v21.0 live 2026, no sunset
    Category ai-productivity-data
    Pipeline Stage none

    Title

    Field Value
    Product Facebook Ads API → Meta Marketing API
    Descriptive Title Meta Marketing API — Programmatic Ads Control Plane for FB/IG/Messenger/Audience Network/Threads: Campaign/AdSet/Ad CRUD + Insights (async breakdowns) + Custom/Lookalike Audiences + Catalogs + Conversions API (server-side) + Business Use Case rate limits (Dev 60pts/Std 9000pts/Full 15K+pts) + Official MCP Server beta​ (mcp.facebook.com/ads, 29 tools, Claude/ChatGPT/Cursor, agent-created ads default PAUSED) + REST/Graph OAuth; Free to call, you pay ad spend + engineering, no per-request fee (2007-origin FB Ads, renamed Marketing API ~2018, META NASDAQ)
    One-line Positioning Developer registers Meta app → requests ads_management / ads_read / business_management permissions → passes App Review (Limited/Full Access tiers, May 2026 renamed Standard→Limited, Advanced→Full, 500-call/15-day threshold for Full) → calls Graph-Marketing endpoints to create campaigns, pull /insights with breakdowns, sync Custom Audiences from CRM, fire Conversions API events → webhooks/async jobs handle large pulls → MCP server (beta) lets Claude draft a campaign object but human must unpause; cost = ad spend + your infra, Meta charges $0/call.

    Features

    Field Value
    Campaign Mgmt /act_{id}/campaigns /adsets /ads CRUD, Objective types (Awareness/Traffic/Sales/Leads), Advantage+ campaigns (multi-adset, 50 ads/set, Sales/Leads/App), budget optimization (CBO/ABO), bid strategies, A/B tests, dynamic creative
    Insights / Reporting /act_{id}/insights sync + async jobs, breakdowns (age/gender/placement/device/time_series/product_id/action_target_id), attribution windows (1d/7d click, 1d/7d engage-through post Feb 2025 overhaul), unique vs non-unique metrics separated, 13-month reach cutoff on old breakdowns (async bypass 10 req/day/account)
    Audiences Custom Audiences (CRM/file/website pixel/engagement), Lookalike Audiences, Saved Audiences, Audience Sync to partners; CAPI (Conversions API) server-side events, One-Click CAPI beta Apr 2026
    Creatives / Catalogs /adcreatives (image/video/carousel/CTA), Asset Feeds, Branded Content, /catalogs for Dynamic Ads, Product Sets, Batch catalog ops
    Cross-surface FB + IG + Messenger + Audience Network + Threads feed (global Jan 2026) + WhatsApp Status Ads (Updates tab) placements; Unified Meta account model
    AI / Agent Surface Official MCP server beta Apr 2026​ at https://mcp.facebook.com/ads — 29 tools across reporting/campaign/catalog/signal-diagnostics, OAuth 2.1 DCR, Claude Desktop/ChatGPT/Codex/Cursor; companion CLI (Python) for Claude Code; agent-created campaigns default PAUSED, human activation required; no credit meter
    API Style REST/Graph, cursor pagination, field selection, batch requests, async insights jobs, webhooks (lead-ads, ad-account changes), OAuth 2.0 (user/app/system-user tokens)
    Rate Limit Model Business Use Case (BUC) points: read=1pt, write=3pts; Dev tier max 60pts/300s decay, Limited(Std) 9000pts, Full(Adv) 15K+pts; Insights hourly formula 190K + 400*active_ads (Full) vs 600 + 400*active_ads (Dev); mutation 100 QPS/app/account realtime; app-level error 4/17, account-level 613/80000

    Pricing

    Field Value
    API Call Fee $0​ — Meta does not bill per request, per endpoint, or per token; no usage meter, no credit pack
    Ad Spend You pay the auction for impressions/clicks/conversions as normal (same as Ads Manager UI); API is just a control plane
    Access Tiers Development (default, sandbox-ish, 60pts) → Limited Access (ex-Standard, post App Review) → Full Access (ex-Advanced, Business Verification + 500 successful calls/15d + <15% error rate) ; tier gates throughput not price
    Hidden Costs Engineering (OAuth/refresh/version-migration ~quarterly), warehouse storage for insights backfills, CAPI compute ($20-200/mo serverless typical), App Review time, MCP client build if agent-facing
    WhatsApp Exception WhatsApp Business Cloud API is not​ Marketing API — per-24h-conversation billing (market-dependent, ~0.10 DE per marketing template), out of scope for FB Ads API card
    Type free-to-call-not-free-to-scale; starting_paid=$0 API / ad spend variable; MCP beta free while in beta
    Note Feb 2025 attribution change (link-click-only CTR, 5s video threshold, engage-through 1d) silently restates historical numbers over 3-7d window — pipeline must re-backfill

    Reviews

    Field Value
    G2 No G2 profile for “Facebook Ads API” as a dev tool​ — developers review “Meta Ads Manager” (UI) at 4.0-4.2/5 (~600) and “Meta Marketing API” appears only inside “AdAgility/AdTech platforms” comparisons; print no-rated-b2b-profile-api-surface (same rule as FFmpeg/Bannerbear/MonkeyLearn-standalone: it’s a platform primitive, not a bought SaaS)
    Capterra None​ — Capterra lists Ads Manager adjacently at 4.0/5 ~200 but not the API; auxiliary near-zero
    Trustpilot Meta/Instagram/Facebook brand page 2.0-2.6/5​ (barbell: account-ban rage, ad-rejection rage, billing disputes) — excluded from any B2B avg​ (aligns Smartlead/Slack/Supabase/Framer/Qualtrics/Feedly pattern); not an API-review signal
    Developer Sentiment (StackOverflow/Reddit/HN aggregate) Mixed: praise ubiquity (3.2B reach, only way to do FB/IG programmatically), curse quarterly version churn + nested actions JSON flattening + BUC throttling opaque + App Review latency (2-6 wks) + attribution restatement breaks dashboards
    Editorial Adamigo/Blotato/AgentsAPIs 2026 confirm “free to call, throttle-not-price, MCP beta Apr 2026”
    Praise Only programmatic path to FB/IG/Threads/WhatsApp-Status inventory, Insights async handles huge pulls, Custom Audience + CAPI closure for measurement, MCP beta lets agents draft (with pause-guard), versioning predictable at 2-yr clock
    Gripes Quarterly breaking changes, actions array pivot pain, BUC quota opaque until throttled (error 80004), App Review blocks prod for weeks, Dev tier unusable for real accounts, attribution window rewrites yesterday’s numbers, no per-call pricing means finance can’t forecast API line (only eng time)

    Review Sources Breakdown

    Field Value
    G2.com no-rated-b2b-profile-api-surface — API primitive not bought SaaS, legacy 4.0-4.2 is Ads Manager UI not API
    Capterra none for API, Ads Manager 4.0/5 ~200 aux near-zero
    Trustpilot Meta brand 2.0-2.6/5 barbell — excluded, not API signal
    StackOverflow/Reddit/HN directional dev sentiment only, not star
    Editorial (Adamigo/Blotato/AgentsAPIs) 2026 confirm free-call + MCP beta
    Conclusion​ Prints “API primitive → no G2/Capterra/TP star, dev-sentiment directional only” — diverges from active-SaaS split-source rule (like FFmpeg/MonkeyLearn-standalone but reason = platform-primitive not sunset)

    Access

    Field Value
    Auth OAuth 2.0 (user token / app token / system-user token via Business SDK), permission scopes ads_management ads_read business_management pages_read_engagement, App Review for Limited/Full
    Endpoints Graph-Marketing: `graph.facebook.com/v21.0/act_{ad_account_id}/{campaigns
    MCP Official beta Apr 2026​ https://mcp.facebook.com/ads — OAuth 2.1 DCR, 29 tools (reporting/campaign/catalog/signal), Claude/ChatGPT/Cursor/Codex; agent writes default PAUSED; requires Meta app with ads_management + Full Access recommended; joins Rezi/Miro/XMind/Supabase/Framer/GitHub/Webflow/Netlify/Cloudflare/Smartlead/Lokalise/Klaviyo/Feedly-CTI mcp-full cluster, but note agent-pause-guard modifier
    Webhooks Lead Ads webhook, Ad Account Activity webhook, Subscription API; CAPI server-side events
    Integrations (via third-party built on API) Klaviyo, Customer.io, Shopify, GA4, BigQuery (manual), Fivetran/Airbyte connectors, AdAgility/AdRoll/DSPs; API itself integrates with nothing — everything integrates with it
    Self-host N/A (Meta cloud only, no on-prem, no private API)

    Best For

    Field Value
    Audience 1 Agencies managing 10-500 client ad accounts needing one pipeline instead of Ads Manager tab-spam
    Audience 2 In-house growth/analytics teams piping Insights → BigQuery/Snowflake/dbt (flatten actions array once, reuse)
    Audience 3 Ad-tech SaaS / DSPs / reporting tools (Klaviyo/Customer.io tier) whose product “integrates with Meta Ads”
    Audience 4 Agentic marketing engineers prototyping Claude+CAMPAIGN-MCP drafts (with human unpause gate)
    Audience 5 CAPI/server-side measurement teams replacing pixel-only attribution post-iOS14.5

    Not For

    Field Value
    Exclude 1 Solo advertisers running 1-2 accounts — Ads Manager UI is faster, API onboarding (App Review 2-6 wks) is overhead
    Exclude 2 Buyers expecting a per-seat SaaS price — it’s $0/call + ad spend + eng cost, confuses finance used to SaaS line-items
    Exclude 3 Teams refusing quarterly version migration (v21→v22 cadence, 2-yr deprecation, breaking changes)
    Exclude 4 Agent builders assuming MCP can auto-launch ads — pause-guard means human-in-loop mandatory
    Exclude 5 Anyone wanting stable historical attribution — Feb 2025 model + 3-7d restatement rewrites last week’s numbers

    Competitors

    Field Value
    Google Ads API Mature GAQL query model, micros-cost conversion, native BigQuery transfer, no MCP (2026), per-call free same model
    TikTok Ads API Versioned REST, bulk/batch, no MCP GA, weaker attribution depth, dev-first
    LinkedIn Ads API Hardest access (manual review weeks), inverted naming (Campaign=AdGroup), no MCP, B2B-only
    Amazon Advertising API Retail-media, async reporting, no MCP, catalog-shaped
    Microsoft Advertising API Bulk ops, GAQL-less, no MCP, search-only
    Unified Ads APIs (Zernio/Ayrshare/Metricool) Built on top of Meta+Google+TikTok, charge $6-750/mo, not competitors but wrappers; Metricool ships its own MCP

     

Do Not Sell or Share My Personal Information Cookie Settings