SDK

# Python SDK

`pip install synter` — typed client for 25 catalog tools plus an `execute()` escape hatch for any whitelisted PPC script.

## Install

bash

```
pip install synter
```

## Quickstart

python

```
from synter import Synter

client = Synter(api_key="syn_...")  # or set SYNTER_API_KEY

campaigns = client.campaigns.list(platform="google", status="ENABLED")
perf = client.analytics.get_performance()  # default: google, LAST_7_DAYS
spend = client.analytics.get_daily_spend()  # default: google, last 7 days
```

Optional analytics args

`get_performance` and `get_daily_spend` accept an optional `platform` (default `google`). Empty calls are valid. They dispatch to the platform pull scripts (`pull_google_ads`, `pull_meta_ads`, …), not to `get_account_daily_spend`.

## Async

python

```
import asyncio
from synter import AsyncSynter

async def main():
    async with AsyncSynter(api_key="syn_...") as client:
        print(await client.campaigns.list(platform="google"))

asyncio.run(main())
```

## Any script

Use `execute(script_name, args)` for a whitelisted PPC script. MCP tool names such as `list_campaigns` are not scripts — call the typed method, or `GET /v1/campaigns`, instead.

python

```
client.execute(
    "google_ads_get_campaigns",
    {"status": "ENABLED"},
    platform="google",
)
```

Full hosted MCP tools: [/mcp/tools](https://docs.syntermedia.ai/mcp/tools). Claude Code plugin: [/guides/claude-plugin](https://docs.syntermedia.ai/guides/claude-plugin).

Was this page helpful?

YesNo

[Previous SDKs](https://docs.syntermedia.ai/sdk) [Next MCP overview](https://docs.syntermedia.ai/mcp/overview)

---

Source: https://docs.syntermedia.ai/sdk/python
Full docs as one file: https://docs.syntermedia.ai/llms-full.txt