First 200 users get the Growth plan for $19/mo.

Claim

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.

Quick start

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.

Pick a platform
MetaGoogleSnapchat
Access we ask forRead only

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.

First sync90 days
Nightly top-up02:00 UTC
Everything lands inmetrics_daily
GET /public/v1/sources

Step 3

Read your numbers

Open the dashboard, or pull the same numbers over the API. Every platform lands in one list.

Yesterday · all platforms
Meta$1,240Full detail
Google$980Full detail
Snapchat$310Spend only
GET /public/v1/metrics/summary

A worked example

Pull three weeks of numbers

One request returns spend and results for every connected platform, grouped however you ask.

GET /public/v1/metrics/dailycURL
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 details

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.

Meta · Campaigns, ad sets, adsFull detail
Google · Campaigns, ad sets, adsFull detail
Snapchat · Daily spend totalsSpend only
LinkedIn · Waiting on ads API approvalSpend only
X · Waiting on ads API approvalSpend only

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.

SlackSync finished, brief ready, connection expiring
EmailThe same alerts, one message each
Telegram + WhatsAppFor the phone-first among us

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.

sk_live_…4f2aThis workspace only
Reads, never writes
Revoke in one click
Stuck on a connection or a webhook? Write to us. The docs are short on purpose; the inbox is where the long answers live.