v0.1.0 - Initial Release

ASA API Client v0.1.0

A modern, fully-typed Python client for the Apple Search Ads API with async support and Pydantic models.

Features

• Full Type Safety - Complete type hints with strict mypy compliance
• Async Support - Both sync and async methods in a unified client
• Pydantic Models - Validated request/response models
• Resource-based API - Intuitive client.campaigns.list() pattern
• Automatic Pagination - iter_all() and iter_all_async() helpers
• Reports with Pandas - Optional DataFrame export

Installation

pip install asa-api-client

Or with uv:

uv add asa-api-client

Quick Start

from asa_api_client import AppleSearchAdsClient

client = AppleSearchAdsClient.from_env()

with client:
    campaigns = client.campaigns.list()
    for campaign in campaigns:
        print(f"{campaign.name}: {campaign.status}")

Resources

• Campaigns - List, get, create, update campaigns
• Ad Groups - Manage ad groups within campaigns
• Keywords - Bulk create and manage keywords
• Reports - Generate performance reports with optional DataFrame export

Documentation

Full documentation available at asa-api-client.peth.au

Requirements

• Python 3.13+
• Valid Apple Search Ads API credentials

License

MIT License - Copyright (c) 2025 Peth Pty Ltd