Getting started
Create your AdCrunch account, connect your first ad platform, and read your first insight.
AdCrunch is a unified layer on top of your ad platforms. You connect Meta, TikTok, X, or Snapchat once, and AdCrunch keeps your campaigns, ad groups, ads, and insights synced into one place — queryable from the console, from a REST API, or from an AI agent over MCP.
This page walks you through the first ten minutes: account, advertiser, insight.
Before you start
You need:
- An ad account on at least one supported provider (Meta, TikTok, X, Snapchat).
- Permission on that account to grant a third-party app read access. If you’re not the owner, ask whoever is.
Single sign-on
We support Google and email login. Use the same identity that owns access to your ad platforms — it makes the OAuth handshake one click instead of three.
Walkthrough
-
Create your AdCrunch organization
Sign up at adcrunch.dev and create an organization. Organizations are how billing, advertisers, and team members are scoped.
-
Connect your first advertiser
From the console, go to Advertisers → Connect and pick a provider. You’ll be redirected to the provider for OAuth consent, then back to AdCrunch with your ad accounts listed. Select the ones you want to sync.
-
Wait for the initial sync
AdCrunch backfills the last 90 days of campaigns, ad groups, ads, and insights. For most accounts this takes 1–5 minutes. You can watch progress on the advertiser detail page.
-
Read your first insight
Open the Insights view, pick an advertiser, and you’ll see daily spend, impressions, clicks, and conversions broken down by campaign. From here you can save a view, or jump to the MCP setup to start asking questions in plain language.
What’s next
- Connect a Meta advertiser — the deepest provider integration.
- Connect to AI agents — wire Claude or Cursor to query AdCrunch.
- Insight API reference — direct REST integration.