# Microsoft Advertising API vs X Ads API

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

Microsoft Advertising API scores 60.3 (C) on agent readiness against X Ads API's 57.3 (C), and leads in 5 of 7 scored categories. X Ads API leads on reliability. Both do ad reporting.

- Microsoft Advertising API: grade C, 60.3/100, rank #522 of 950. Markdown https://www.anchorterminal.com/tools/microsoft-advertising-api.md · JSON https://www.anchorterminal.com/api/v1/tools/microsoft-advertising-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

### Microsoft Advertising API (C)

Good for: Agents that manage or report on Microsoft Advertising accounts, including Google Ads imports.

Ahead on:
- Schema & documentation, 79 against 64
- Security & auth, 60 against 48
- Payments & pricing, 30 against 20

Watch for: Call-rate limits carry no numbers. The docs describe a 60-second sliding window, and call the Bulk and Reporting limits internal and subject to change

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

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 | Microsoft Advertising API | X Ads API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 60 | 75 | X Ads API +15 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 79 | 64 | Microsoft Advertising API +15 |
| Agent ergonomics | 13% (16.2 this run) | 63 | 62 | Microsoft Advertising API +1 |
| Security & auth | 14% (17.5 this run) | 60 | 48 | Microsoft Advertising API +12 |
| Payments & pricing | 10% (12.5 this run) | 30 | 20 | Microsoft Advertising API +10 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 61 | 63 | X Ads API +2 |
| Transparency & trust | 7% (8.8 this run) | 64 | 62 | Microsoft Advertising API +2 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **60.3 · C** | **57.3 · C** | |

## Facts side by side

| Fact | Microsoft Advertising API | X Ads API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Microsoft | X Corp. |
| Hosted endpoint | `https://campaign.api.bingads.microsoft.com/CampaignManagement/v13` | `https://ads-api.x.com/mcp` |
| Transports | HTTP | HTTP |
| Auth | OAuth | OAuth |
| Pricing | Free | Free |
| x402 | no | no |
| Licence | Proprietary service. The .NET, Java, Python and PHP SDKs are MIT | Proprietary service under the X Developer Agreement and its incorporated Developer Policy |
| Tools exposed | 7 | none |
| Read-only variant documented | yes | yes |
| llms.txt | no | yes |
| Last release | 2026-09-29 | 2026-09-17 |
| Terms last updated | couldn't be read | 2026-04-27 |
| Privacy policy last updated | 2026-09-01 | couldn't be read |
| Customer content may train models | yes | not found in the text |
| Terms restrict automated access | couldn't be read | not found in the text |
| Terms restrict benchmarking | couldn't be read | yes |
| Terms or service can change without notice | couldn't be read | not found in the text |
| Arbitration or class-action waiver | couldn't be read | yes |
| Popularity | 128 stars, 19k PyPI/wk | none |

## Verdicts

**Microsoft Advertising API.** Version 13 covers campaigns, budgets, audiences, ads and reports over REST with JSON, with a sandbox that needs no payment method and four official SDKs. Call-rate limits are unpublished, no public OpenAPI file or idempotency key was found, and one OAuth scope covers every operation. The SOAP interface retires on 31 January 2027.

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

### Microsoft Advertising API

1. Build and test against the sandbox hosts (`*.api.sandbox.bingads.microsoft.com`) with developer token BBD37VB98. Sandbox and production credentials are separate
2. Send `Authorization: Bearer <token>`, `DeveloperToken`, `CustomerId` and `CustomerAccountId` on REST calls. Use the account ID, never the eight-character account number
3. Create campaigns with `Status` set to `Paused`, then read them back before activating. No validate-only mode was found
4. On error 117 (CallRateExceeded) wait 60 seconds. On Bulk error 4204 wait up to 15 minutes
5. Read `PartialErrors` on every add, update and delete. A call can succeed for some items and fail for others

### 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, Microsoft Advertising API or X Ads API?

Microsoft Advertising API scores 60.3 (C) on agent readiness against X Ads API's 57.3 (C), and leads in 5 of 7 scored categories. X Ads API leads on reliability.

### Do Microsoft Advertising API and X Ads API need an API key?

Both use an OAuth sign-in.

### Can an agent call Microsoft Advertising API and X Ads API without installing anything?

Yes. Microsoft Advertising API has a hosted endpoint at https://campaign.api.bingads.microsoft.com/CampaignManagement/v13 and X Ads API at https://ads-api.x.com/mcp.


## For agents

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

## Other comparisons with Microsoft Advertising API or X Ads API

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