Get an audit

Head to head · Ad reporting · October 2026 research run

Meta Marketing API vs X Ads API

Meta Marketing API scores 67.7 (B) on agent readiness against X Ads API's 57.3 (C), and leads in every scored category. Both do ad reporting.

Best advertising platform APIs for AI agents · All 28 advertising comparisons

Meta Marketing APIMeta Platforms, Inc. · HTTP API B67.7/100#243 of 950 X Ads APIX Corp. · HTTP API C57.3/100#616 of 950

Which one, for what

Meta Marketing API B

Good for The direct route to Facebook, Instagram, Messenger, WhatsApp and Threads advertising for reporting, campaign and budget changes, audiences and creatives.

Ahead on

  • Reliability, 80 against 75
  • Schema & documentation, 76 against 64
  • Agent ergonomics, 77 against 62
  • Security & auth, 61 against 48
  • Payments & pricing, 30 against 20
  • Maintenance & community, 74 against 63
  • Transparency & trust, 68 against 62

Watch for

Default Limited access allows a score of 60 per ad account (read 1, write 3) and blocks for 300 seconds at the limit

X Ads API C

Good for An agent that manages or reports on X campaigns for an advertiser with an approved developer app, especially through the MCP server, where scopes separate reads from writes and writes start paused.

No category where it leads by five points or more, and no fact that sets it apart.

Watch for

No OpenAPI file covers the Ads API. The published file (version 2.170, 178 paths) describes api.x.com only

Score by category

CategoryWeight this runMeta Marketing APIX Ads APIEdge
Reliability16%208075Meta Marketing API +5
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.27664Meta Marketing API +12
Agent ergonomics13%16.27762Meta Marketing API +15
Security & auth14%17.56148Meta Marketing API +13
Payments & pricing10%12.53020Meta Marketing API +10
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.87463Meta Marketing API +11
Transparency & trust7%8.86862Meta Marketing API +6
Negative events≤1500
Total67.7 · B57.3 · C

Facts side by side

FactMeta Marketing APIX Ads API
KindHTTP APIHTTP API
VendorMeta Platforms, Inc.X Corp.
Hosted endpointhttps://graph.facebook.comhttps://ads-api.x.com/mcp
TransportsHTTPHTTP
AuthOAuthOAuth
PricingFreeFree
x402nono
LicenceProprietary service under the Meta Platform Terms. The Business SDKs and the codegen specs on GitHub carry Meta's own platform licence, which allows use only with Meta's APIsProprietary service under the X Developer Agreement and its incorporated Developer Policy
Read-only variant documentedyesyes
llms.txtyesyes
Last release2026-09-212026-09-17
Terms last updated2026-02-032026-04-27
Privacy policy last updatedcouldn't be readcouldn't be read
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textnot found in the text
Terms restrict benchmarkingnot found in the textyes
Terms or service can change without noticenot found in the textnot found in the text
Arbitration or class-action waivernot found in the textyes
Popularity1.6k stars, 501k npm/wk, 1.1M PyPI/wknone

Verdicts

Meta Marketing API

Reporting, campaign, budget, audience and creative endpoints sit behind ads_read and ads_management scopes, with a validate_only option and sandbox ad accounts for checking a change before it spends. New apps are held to a score of 60 per ad account, with a 300-second block at the limit, and the documented requests pass the access token as a parameter.

X Ads API

Rate limits are published per endpoint type, a sandbox host never serves ads, and the X Ads MCP server has separate read and write scopes and creates campaigns paused. The REST API needs OAuth 1.0a signing and an approved app, no OpenAPI file covers it, and the official Python and Ruby SDKs were last released in May 2022.

Before you call either

Meta Marketing API

  1. Put a version in every path, such as /v26.0/act_<AD_ACCOUNT_ID>/campaigns. Unversioned Marketing API calls fail
  2. Create campaigns, ad sets and ads with status=PAUSED, and send execution_options=["validate_only"] first to test a write without making it
  3. Ask for ads_read alone when the task is reporting. ads_management can change budgets and activate spend
  4. Read X-Business-Use-Case-Usage and X-Ad-Account-Usage after each call and wait for estimated_time_to_regain_access on errors 17, 613 and 80004
  5. Change an ad set budget at most four times an hour and an account spending limit at most ten times a day

X Ads API

  1. Build against https://ads-api-sandbox.x.com/12/ first. Create a test account with POST accounts and a funding instrument there before touching a live account
  2. On HTTP 429 wait until the time in x-rate-limit-reset. On 503 wait for retry-after. The docs say apps that ignore these can be throttled or lose access without notice
  3. Read the account-level limit from x-account-rate-limit-* when present and use x-rate-limit-* only when it is absent
  4. For a read-only MCP session request ads.read offline.access only. Without offline.access the token expires in about two hours with no refresh
  5. Page with count (1 to 1,000, default 200) and cursor until next_cursor is null. Analytics endpoints page by time range instead, and with_total_count cannot be combined with cursor

Questions

Which is better for AI agents, Meta Marketing API or X Ads API?

Meta Marketing API scores 67.7 (B) on agent readiness against X Ads API's 57.3 (C), and leads in every scored category.

Do Meta Marketing API and X Ads API need an API key?

Both use an OAuth sign-in.

Can an agent call Meta Marketing API and X Ads API without installing anything?

Yes. Meta Marketing API has a hosted endpoint at https://graph.facebook.com and X Ads API at https://ads-api.x.com/mcp.

Other comparisons with Meta Marketing API or X Ads API

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.

Get an auditSee a sample report