# Amazon Ads API (slim)

> Amazon's REST API for its advertising products, covering campaigns, budgets, targets, audiences, creative assets and performance reports for sponsored ads and Amazon DSP. An Amazon Ads MCP Server in open beta exposes the same operations as tools.

- Full: https://www.anchorterminal.com/tools/amazon-ads-api.md (~6,500 tokens) · this version ~1,780 tokens · JSON https://www.anchorterminal.com/tools/amazon-ads-api.json · canonical https://www.anchorterminal.com/tools/amazon-ads-api
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**C · 59/100 · rank #388 of 629 · #5 in Advertising & campaign operations · not agent-ready · confidence medium**


Assessment: Public OpenAPI specifications, test accounts that serve no ads and a six-month shutoff notice policy support agent use. Access needs an approved application and an advertiser's OAuth consent, rate limits are dynamic with no published numbers, and the status feed shows three reporting disruptions since July 2026. The MCP server is in open beta.

## Facts

- Kind: HTTP API · vendor: Amazon · category: Advertising & campaign operations · legal entity: Amazon.com Services LLC · provenance 94/100
- Endpoint: `https://advertising-api.amazon.com` (HTTP)
- Auth: OAuth · pricing: Free · x402: no · licence: Proprietary service under the Amazon Advertising API Licence Agreement. The Postman collections and samples in amzn/ads-advanced-tools-docs are MIT-0
- Probe metrics: not measured yet (probes haven't run)
- Surface graded: The public REST API, which is generally available. The Amazon Ads MCP Server is in open beta and is noted where it differs
- Access: LwA application, then an application for API access as a direct advertiser or through the Amazon Ads Partner Network. Review may take up to one business day
- Hosts: advertising-api.amazon.com (North America), advertising-api-eu.amazon.com (Europe, India, Middle East, South Africa), advertising-api-fe.amazon.com (Japan, Australia, Singapore)
- Credentials: OAuth 2.0 authorisation code grant through Login with Amazon. Access tokens 60 minutes. Refresh tokens issued from 30 July 2026 last 365 days from consent
- Scopes: advertising::campaign_management (most requests), advertising::audiences (data provider APIs), advertising::test:create_account
- OpenAPI: OpenAPI 3.0.1 JSON per product. The merged Ads API v1 file has 104 operations and 1,729 schemas. The reference lists 132 specification files
- Rate limits: Dynamic, based on system load, no published numbers. 429 with Retry-After. Extended list calls weigh five times a standard call
- Pagination: Ads API v1 query operations take maxResults (1 to 1,000) and nextToken, with typed filters
- Errors: Ads API v1 returns a code from a documented ErrorCode enum and a message. Batch writes return 207 with success, partial success and error lists
- Sandbox: Test accounts created through the API. Ads are not served, billing is inactive and performance data is not available
- MCP server: Open beta since 18 February 2026. https://advertising-ai.amazon.com/mcp, with -eu and -fe hosts. 110 documented tools, or three through /mcp/lite. OAuth 2.1 or LwA tokens in headers
- SDKs: None official. The docs describe generating a client with OpenAPI Generator. Postman collections on GitHub
- Status: status.ads.amazon.com with JSON feeds for current status and history, by region and category
- Deprecations: At least six months' notice before a shutoff. Legacy account management endpoints return Warning 299 headers from July 2026 and 404 from July 2027
- Prices: API access free per call

- Scores: Reliability 45, Performance pending, Schema & documentation 76, Agent ergonomics 62, Security & auth 60, Payments & pricing 40, Task success pending, Maintenance & community 65, Transparency & trust 73 · total over the 7 assessed categories
- Why: Reliability, Graded on the REST API with the hosted checklist. · Schema & documentation, OpenAPI 3.0.1 files download without a login. · Agent ergonomics, Query operations take maxResults and nextToken, and reports are requested with chosen columns. · Security & auth, OAuth 2.0 through Login with Amazon, 60-minute access tokens, revocable grants and 365-day refresh tokens from 30 July 2026. The MCP server… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, Latest dated release note 5 October 2026 (30). · Transparency & trust, Closed service with a published licence agreement, last updated 1 June 2024, and MIT-0 samples (15).
- Sources: 17, open questions: 7, both in the full twin
- Capabilities: ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives
- JSON: https://www.anchorterminal.com/api/v1/tools/amazon-ads-api.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/amazon-ads-api.svg` or a link to https://www.anchorterminal.com/tools/amazon-ads-api from a page on amazon.com or one of its subdomains, or the README of github.com/amzn/ads-advanced-tools-docs, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send Amazon-Advertising-API-ClientId and a Bearer access token on every call, and Amazon-Advertising-API-Scope with a profile ID from GET /v2/profiles on most
2. Call the host for the advertiser's region. advertising-api.amazon.com is North America, advertising-api-eu Europe and advertising-api-fe Far East
3. Refresh the access token every 60 minutes. Refresh tokens issued from 30 July 2026 expire 365 days after consent
4. On 429, wait the Retry-After seconds and back off exponentially. Request an export instead of listing every entity
5. Rehearse writes in a test account, or create campaigns in the PAUSED state, before anything can spend
6. For MCP, prefer https://advertising-ai.amazon.com/mcp/lite and disable delete tools in the client configuration

## Connect

```bash
curl https://advertising-api.amazon.com/v2/profiles -H "Amazon-Advertising-API-ClientId: $CLIENT_ID" -H "Authorization: Bearer $ACCESS_TOKEN"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/amazon-ads-api

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Google Ads API | BB | 76.4 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/google-ads-api.min.md |
| Meta Marketing API | B | 67.7 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/meta-marketing-api.min.md |
| LinkedIn Marketing APIs | B | 62.4 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/linkedin-marketing-api.min.md |
| Microsoft Advertising API | C | 60.3 | ads.reporting, ads.campaigns, ads.budgets, ads.audiences, ads.creatives | https://www.anchorterminal.com/tools/microsoft-advertising-api.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)