# Google Ads API vs X Ads API

> Google Ads scores 76.4 (BB) 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/google-ads-api-vs-x-ads
- Markdown: https://www.anchorterminal.com/compare/google-ads-api-vs-x-ads.md (~2,300 tokens)
- Slim: https://www.anchorterminal.com/compare/google-ads-api-vs-x-ads.min.md (~680 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/google-ads-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

Google Ads API scores 76.4 (BB) on agent readiness against X Ads API's 57.3 (C), and leads in every scored category. Both do ad reporting.

- Google Ads API: grade BB, 76.4/100, rank #33 of 950. Markdown https://www.anchorterminal.com/tools/google-ads-api.md · JSON https://www.anchorterminal.com/api/v1/tools/google-ads-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

### Google Ads API (BB)

Good for: It suits an agent that reports on or manages Google Ads accounts for an advertiser or agency that can get a Cloud project approved.

Ahead on:
- Reliability, 82 against 75
- Schema & documentation, 84 against 64
- Agent ergonomics, 87 against 62
- Security & auth, 71 against 48
- Payments & pricing, 40 against 20
- Maintenance & community, 87 against 63
- Transparency & trust, 82 against 62

Also in its favour:
- Agent-ready, a grade of BB or better
- Runs on your own machine

Watch for: One OAuth scope, `adwords`, covers reading, editing, creating and deleting. Read-only access depends on the Google Ads user role

### 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 | Google Ads API | X Ads API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 82 | 75 | Google Ads API +7 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 84 | 64 | Google Ads API +20 |
| Agent ergonomics | 13% (16.2 this run) | 87 | 62 | Google Ads API +25 |
| Security & auth | 14% (17.5 this run) | 71 | 48 | Google Ads API +23 |
| Payments & pricing | 10% (12.5 this run) | 40 | 20 | Google Ads API +20 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 87 | 63 | Google Ads API +24 |
| Transparency & trust | 7% (8.8 this run) | 82 | 62 | Google Ads API +20 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **76.4 · BB** | **57.3 · C** | |

## Facts side by side

| Fact | Google Ads API | X Ads API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Google | X Corp. |
| Hosted endpoint | `https://googleads.googleapis.com` | `https://ads-api.x.com/mcp` |
| Transports | HTTP, stdio, Streamable HTTP | HTTP |
| Auth | OAuth | OAuth |
| Pricing | Free | Free |
| x402 | no | no |
| Licence | Proprietary service under the Google Ads API terms. The client libraries and the google-ads-mcp server are Apache-2.0 | Proprietary service under the X Developer Agreement and its incorporated Developer Policy |
| Tools exposed | 3 | none |
| Read-only variant documented | no | yes |
| llms.txt | no | yes |
| Last release | 2026-09-23 | 2026-09-17 |
| Terms last updated | 2019-02-21 | 2026-04-27 |
| Privacy policy last updated | 2026-10-01 | 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 | yes | yes |
| Popularity | 753 stars, 3.1M PyPI/wk | none |

## Verdicts

**Google Ads API.** Test accounts are free and need no approval, and `validate_only` checks a change without running it. Production access needs a Google Cloud project approved at Explorer level or above and a person to set up OAuth. One OAuth scope covers both reads and writes. The official MCP server is read-only, self-hosted and at version 0.0.4.

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

### Google Ads API

1. Send `validateOnly: true` on a mutate first. It returns errors without making the change. Batch jobs don't support it
2. Create campaigns with status PAUSED and enable them in a separate step, since an enabled campaign with a budget can spend
3. Send `login-customer-id` (digits only, no hyphens) when you reach a client account through a manager account
4. A failed request still counts against the daily operation quota. Paging with a valid `next_page_token` doesn't
5. Wait at least 12 hours between account budget changes on one account, and use the Data Manager API for new Customer Match or offline conversion work

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

Google Ads API scores 76.4 (BB) on agent readiness against X Ads API's 57.3 (C), and leads in every scored category.

### Do Google Ads API and X Ads API need an API key?

Both use an OAuth sign-in.

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

Yes. Google Ads API has a hosted endpoint at https://googleads.googleapis.com and X Ads API at https://ads-api.x.com/mcp.


## For agents

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

## Other comparisons with Google Ads API or X Ads API

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