# Apple Ads Platform API vs X Ads API

> X Ads scores 57.3 (C) to Apple Ads Platform's 53.8 (D) for ad reporting. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/apple-ads-vs-x-ads
- Markdown: https://www.anchorterminal.com/compare/apple-ads-vs-x-ads.md (~2,350 tokens)
- Slim: https://www.anchorterminal.com/compare/apple-ads-vs-x-ads.min.md (~680 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/apple-ads-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

X Ads API scores 57.3 (C) on agent readiness against Apple Ads Platform API's 53.8 (D), and leads in 2 of 7 scored categories. Apple Ads Platform API leads on schema & documentation, agent ergonomics and security & auth. Both do ad reporting.

- Apple Ads Platform API: grade D, 53.8/100, rank #699 of 950. Markdown https://www.anchorterminal.com/tools/apple-ads.md · JSON https://www.anchorterminal.com/api/v1/tools/apple-ads.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

### Apple Ads Platform API (D)

Good for: An agent that manages or reports on App Store search campaigns, or Apple Maps campaigns, for an advertiser whose administrator can grant an API role.

Ahead on:
- Schema & documentation, 69 against 64
- Agent ergonomics, 69 against 62
- Security & auth, 68 against 48

Watch for: The Platform API was first released in August 2026 and its changelog has one entry. The Campaign Management API 5 it replaces is sunset on 26 January 2027

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

Ahead on:
- Reliability, 75 against 35
- Maintenance & community, 63 against 48

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 | Apple Ads Platform API | X Ads API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 35 | 75 | X Ads API +40 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 69 | 64 | Apple Ads Platform API +5 |
| Agent ergonomics | 13% (16.2 this run) | 69 | 62 | Apple Ads Platform API +7 |
| Security & auth | 14% (17.5 this run) | 68 | 48 | Apple Ads Platform API +20 |
| Payments & pricing | 10% (12.5 this run) | 20 | 20 | even |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 48 | 63 | X Ads API +15 |
| Transparency & trust | 7% (8.8 this run) | 66 | 62 | Apple Ads Platform API +4 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **53.8 · D** | **57.3 · C** | |

## Facts side by side

| Fact | Apple Ads Platform API | X Ads API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Apple | X Corp. |
| Hosted endpoint | `https://api.ads.apple.com/v1` | `https://ads-api.x.com/mcp` |
| Transports | HTTP | HTTP |
| Auth | OAuth | OAuth |
| Pricing | Free | Free |
| x402 | no | no |
| Licence | Proprietary service under the Apple Advertising Services Terms of Service. The client libraries are MIT | Proprietary service under the X Developer Agreement and its incorporated Developer Policy |
| Read-only variant documented | no | yes |
| llms.txt | no | yes |
| Last release | 2026-08-14 | 2026-09-17 |
| Terms last updated | no date given | 2026-04-27 |
| Privacy policy last updated | couldn't be read | couldn't be read |
| Customer content may train models | yes | 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 |

## Verdicts

**Apple Ads Platform API.** Every response carries `RateLimit-*` headers and a 429 carries `Retry-After`, Apple maintains MIT client libraries in four languages, and read-only API roles exist. The API was first released in August 2026. No status page, SLA, published OpenAPI file, idempotency key or test account was found, and a person must create the credentials in the Apple Ads interface.

**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

### Apple Ads Platform API

1. Send `Authorization: Bearer {access_token}` and `X-AP-Context: adAccountId={adAccountId}` on every ad account call. Get the account id from `GET /v1/acls`
2. Request a new access token every 3,600 seconds from `https://appleid.apple.com/auth/oauth2/token` with scope `searchadsorg`. The signed client secret lasts at most 180 days
3. Read `RateLimit-Remaining` on each response. On a 429 wait the `Retry-After` seconds, then double the wait up to 16 seconds
4. List and filter with POST to a `/query` endpoint, not GET with query parameters. Deleted entities return only when a filter asks for them
5. On PUT send only the fields to change, and send the complete desired array for any array field. Create campaigns with `"status": "PAUSED"` before review

### 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, Apple Ads Platform API or X Ads API?

X Ads API scores 57.3 (C) on agent readiness against Apple Ads Platform API's 53.8 (D), and leads in 2 of 7 scored categories. Apple Ads Platform API leads on schema & documentation, agent ergonomics and security & auth.

### Do Apple Ads Platform API and X Ads API need an API key?

Both use an OAuth sign-in.

### Can an agent call Apple Ads Platform API and X Ads API without installing anything?

Yes. Apple Ads Platform API has a hosted endpoint at https://api.ads.apple.com/v1 and X Ads API at https://ads-api.x.com/mcp.


## For agents

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

## Other comparisons with Apple Ads Platform API or X Ads API

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