Every answer,written down.
How to plug your ad accounts in, when your numbers update, and how to pull them back out. Short enough to read while your first sync runs.
Three steps, one worked example, and a map of the rest of the site.
Three steps, start to finish
You do the first one. We do the other two.
Step 1
Connect an ad account
Sign in, pick a platform, and approve access. We ask to read your results, never to change your ads.
Connecting happens in the app with the platform's own sign-in. LinkedIn and X are waiting on ads API approval.
Step 2
We fetch your history
The first sync pulls your last 90 days. After that, a top-up runs every night on its own.
GET /public/v1/sourcesStep 3
Read your numbers
Open the dashboard, or pull the same numbers over the API. Every platform lands in one list.
GET /public/v1/metrics/summaryA worked example
Pull three weeks of numbers
One request returns spend and results for every connected platform, grouped however you ask.
curl https://api.overads.io/public/v1/metrics/daily \
-H "Authorization: Bearer sk_live_..." \
-G -d "from=2026-05-01" -d "to=2026-05-21" \
-d "accountId=act_123" -d "limit=31"Everything lives under api.overads.io/public/v1 and authenticates with a key from Settings, then API keys. Summary and daily are the two metric shapes; sources and ad-accounts list what a key can see.
The parts people look up
How deep each platform goes, how the pings work, where the keys live, and where the rest of the site answers the next question.
Connectors
How deep each platform goes
Meta and Google bring the whole story: campaigns, ad sets, and ads. Snapchat reports spend totals only. LinkedIn and X are waiting on ads API approval, and the app says so wherever a number is missing.
Alerts
We ping you when things happen
overads sends the alert to where you already talk: Slack, email, Discord, Teams, Telegram, or WhatsApp. Pick per event in Settings.
Every toggle lives in Settings, per event and per channel, and off is off.
API keys
One key, one workspace
Make a key in Settings, keep it secret, and revoke it any time. A key only ever sees its own workspace. Keys come with the Growth and Scale plans.
Reference
The rest of the site, in one map
Four pages answer most questions before you ever need to write in.
