# Meta Marketing API vs X Ads API

> Meta Marketing scores 67.7 (B) to X Ads's 57.3 (C) for ad reporting. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads
- Markdown: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads.md (~2,350 tokens)
- Slim: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads.min.md (~680 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-09

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.

- Meta Marketing API: grade B, 67.7/100, rank #243 of 950. Markdown https://www.anchorterminal.com/tools/meta-marketing-api.md · JSON https://www.anchorterminal.com/api/v1/tools/meta-marketing-api.json
- X Ads API: grade C, 57.3/100, rank #616 of 950. Markdown https://www.anchorterminal.com/tools/x-ads.md · JSON https://www.anchorterminal.com/api/v1/tools/x-ads.json
- Best advertising platform APIs for AI agents: https://www.anchorterminal.com/best/advertising/index.md
- All 28 advertising comparisons: https://www.anchorterminal.com/compare/advertising/index.md

## 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.

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

| Category | Weight | Meta Marketing API | X Ads API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 80 | 75 | Meta Marketing API +5 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 76 | 64 | Meta Marketing API +12 |
| Agent ergonomics | 13% (16.2 this run) | 77 | 62 | Meta Marketing API +15 |
| Security & auth | 14% (17.5 this run) | 61 | 48 | Meta Marketing API +13 |
| Payments & pricing | 10% (12.5 this run) | 30 | 20 | Meta Marketing API +10 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 74 | 63 | Meta Marketing API +11 |
| Transparency & trust | 7% (8.8 this run) | 68 | 62 | Meta Marketing API +6 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **67.7 · B** | **57.3 · C** | |

## Facts side by side

| Fact | Meta Marketing API | X Ads API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Meta Platforms, Inc. | X Corp. |
| Hosted endpoint | `https://graph.facebook.com` | `https://ads-api.x.com/mcp` |
| Transports | HTTP | HTTP |
| Auth | OAuth | OAuth |
| Pricing | Free | Free |
| x402 | no | no |
| Licence | Proprietary 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 APIs | Proprietary service under the X Developer Agreement and its incorporated Developer Policy |
| Read-only variant documented | yes | yes |
| llms.txt | yes | yes |
| Last release | 2026-09-21 | 2026-09-17 |
| Terms last updated | 2026-02-03 | 2026-04-27 |
| Privacy policy last updated | couldn't be read | couldn't be read |
| Customer content may train models | not found in the text | not found in the text |
| Terms restrict automated access | not found in the text | not found in the text |
| Terms restrict benchmarking | not found in the text | yes |
| Terms or service can change without notice | not found in the text | not found in the text |
| Arbitration or class-action waiver | not found in the text | yes |
| Popularity | 1.6k stars, 501k npm/wk, 1.1M PyPI/wk | none |

## 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.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads.json, and with the fewest tokens: https://www.anchorterminal.com/compare/meta-marketing-api-vs-x-ads.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "meta-marketing-api", "b": "x-ads"}`. From a terminal: `anchor compare meta-marketing-api x-ads`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/meta-marketing-api.json and https://www.anchorterminal.com/api/v1/tools/x-ads.json

## Other comparisons with Meta Marketing API or X Ads API

- [Amazon Ads API vs Meta Marketing API](https://www.anchorterminal.com/compare/amazon-ads-api-vs-meta-marketing-api.md)
- [Amazon Ads API vs X Ads API](https://www.anchorterminal.com/compare/amazon-ads-api-vs-x-ads.md)
- [Apple Ads Platform API vs Meta Marketing API](https://www.anchorterminal.com/compare/apple-ads-vs-meta-marketing-api.md)
- [Apple Ads Platform API vs X Ads API](https://www.anchorterminal.com/compare/apple-ads-vs-x-ads.md)
- [Google Ads API vs Meta Marketing API](https://www.anchorterminal.com/compare/google-ads-api-vs-meta-marketing-api.md)
- [Google Ads API vs X Ads API](https://www.anchorterminal.com/compare/google-ads-api-vs-x-ads.md)
- [LinkedIn Marketing APIs vs Meta Marketing API](https://www.anchorterminal.com/compare/linkedin-marketing-api-vs-meta-marketing-api.md)
- [LinkedIn Marketing APIs vs X Ads API](https://www.anchorterminal.com/compare/linkedin-marketing-api-vs-x-ads.md)
- [Meta Marketing API vs Microsoft Advertising API](https://www.anchorterminal.com/compare/meta-marketing-api-vs-microsoft-advertising-api.md)
- [Meta Marketing API vs Snapchat Ads API](https://www.anchorterminal.com/compare/meta-marketing-api-vs-snapchat-ads.md)
- [Microsoft Advertising API vs X Ads API](https://www.anchorterminal.com/compare/microsoft-advertising-api-vs-x-ads.md)
- [Snapchat Ads API vs X Ads API](https://www.anchorterminal.com/compare/snapchat-ads-vs-x-ads.md)