Get started with Synter
Make your first API call in under 5 minutes
Playground
Test API calls interactively with 200 free credits
MCP Server
Connect your AI assistant directly to your ad accounts
Installation
pip install synterQuick start guide
Get your API key
Create a free account and generate your API key from the Developer Portal.
Get API KeySet your environment variable
Store your API key as an environment variable for secure access.
export SYNTER_API_KEY=syn_your_api_key_hereMake your first request
Pull campaign data from your connected ad accounts.
curl -X POST https://api.syntermedia.ai/v1/tools/run \
-H "X-Synter-Key: $SYNTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"script_name": "list_campaigns"
}'Log in with the CLI
Prefer the terminal? The Synter CLI can create and store an API key for you with no copy and paste:
npm install -g synter
synter loginChoose the browser login option. The CLI opens syntermedia.ai/cli/login with a one-time device code in the URL and prints a short confirmation code (like ABCD-EFGH) so you can verify you are on the right page. Sign in in the browser, and the page confirms the login automatically. The CLI is polling in the background: it picks up a freshly created API key and stores it locally, so there is nothing to paste.
Login links expire after 10 minutes
synter login again. Keys created this way appear as "CLI Login" in the Developer Portal, where you can revoke them at any time.Start with 200 Free Credits
Frequently asked questions
get_credit_balance are free.