v1.0.0 - Initial Release

Amazon Ads API Python SDK v1.0.0

First Release

100% API Coverage - 682 endpoints verified against 59 official OpenAPI specifications

Core Features

• 4-Tier API Governance - L1 Gold/L2 Silver/L3 Bronze/L4 Red classification
• 88 SDK Modules - Covers SP/SB/SD/DSP/AMC/Stream and more
• OpenAPI Verified - L1 APIs 100% validated against official specs
• Async Support - Built on httpx with HTTP/2 support
• Auto Authentication - OAuth2 token auto-refresh
• Auto Retry - Built-in exponential backoff retry mechanism
• Rate Limiting - Automatic rate limit handling
• Type Safety - Complete type hints throughout
• Comprehensive Tests - 73 tests (62 unit + 6 integration + 5 e2e)

Installation

\\�ash
pip install amazon-ads-api
\\

Quick Start

\\python
from amazon_ads_api import AmazonAdsClient

client = AmazonAdsClient(
client_id='your-client-id',
client_secret='your-client-secret',
refresh_token='your-refresh-token',
profile_id='your-profile-id'
)

Get campaigns

campaigns = await client.sp.campaigns.list_campaigns()
\\

Documentation

• README
• API Tier Guide
• Migration Guide
• Contributing Guide

Links

• PyPI: https://pypi.org/project/amazon-ads-api/
• GitHub: https://github.com/vanling1111/amazon-ads-api-python-sdk

What's Included

L1 Core APIs (OpenAPI Verified)

• Sponsored Products (SP)
• Sponsored Brands (SB)
• Sponsored Display (SD)
• Amazon DSP
• Profiles & Portfolios
• And more...

L2 Reference APIs

• Amazon Marketing Cloud (AMC)
• Amazon Marketing Stream
• Retail Ad Service
• Attribution API

L3 Service APIs

• Reporting v3
• Insights
• Recommendations
• Media Planning

L4 Experimental APIs

• Sponsored TV
• Ad Library
• Localization
• Moderation