Python SDK

pip install adrelay

poetry add adrelay

from adrelay import AdRelay

client = AdRelay(api_key="your-api-key-here")

# List all campaigns
campaigns = client.campaigns.list()
print(campaigns["unified"])

# List campaigns filtered by platform
google_campaigns = client.campaigns.list(
    platform="google_ads",
    status="ACTIVE",
)

# Create a campaign
campaign = client.campaigns.create(
    name="Summer Sale 2026",
    goal="CONVERSIONS",
    budget_amount=50.00,
    budget_period="DAILY",
    platform="google_ads",
)

# Update a campaign
updated = client.campaigns.update("camp_abc123", status="ACTIVE", budget_amount=75.00)

# Delete a campaign
client.campaigns.delete("camp_abc123")

# List connections
connections = client.connections.list()

# Get billing status
billing = client.billing.status()

client = AdRelay(
    api_key="your-api-key-here",
    base_url="https://api.adrelay.dev/v1",  # default
    timeout=30,  # request timeout in seconds, default 30
)

import os
os.environ["ADRELAY_API_KEY"] = "your-api-key-here"

client = AdRelay()  # Uses ADRELAY_API_KEY from environment

from adrelay import AdRelay, AdRelayError

try:
    campaign = client.campaigns.create(
        name="Test",
        goal="CONVERSIONS",
        budget_amount=50,
        budget_period="DAILY",
        platform="google_ads",
    )
except AdRelayError as e:
    print(f"Error {e.code}: {e.message}")
    print(f"Request ID: {e.request_id}")