Marketing Mix Modeling API
The Marketing Mix Modeling (MMM) API is a read-only, asynchronous reporting API for any org Snap has enabled for MMM API access. It's built primarily for MMM measurement vendors, giving them a standardized, automated feed of Snap campaign performance data, replacing fragmented workarounds like Ads Manager CSV exports, shared user tokens, or managed offline extracts.
The MMM API reads from the same pipeline that powers Ads Manager. Numbers reconcile with what advertisers see in the UI.
Who it's for
The MMM API is for any org Snap has enabled for MMM API access, most commonly MMM measurement vendors who need Snap delivery and spend data to feed into a marketing mix model. It is not for:
- Creating or managing campaigns, ad squads, or ads
- General performance reporting: use the Ads API's Measurement endpoints instead
- Any workflow that requires write access to an advertiser's account
How it differs from the Ads API
| Ads API | MMM API | |
|---|---|---|
| Access | Broad campaign management + reporting | Read-only reporting, one data feed |
| Credentials | User-level OAuth tied to campaign work | Org-level OAuth, no campaign scope needed |
| Output | Many endpoints, real-time queries | One async report request → CSV/JSON download |
| Audience | Advertisers, agencies, tool builders | Any org enabled for MMM API access (typically MMM measurement vendors) |
Access model
Getting data out of the MMM API requires three things to all be true at once:
- Your org is enabled for MMM API access. Snap allowlists the calling org through your Snap point of contact. This is independent of any specific ad account.
- The advertiser has shared the ad account with your org at the View access tier.
- Your org admin has assigned the Data Analyst/
reportsrole to the user making API calls.
If any one of these is missing, the API returns an error rather than partial data. See Troubleshooting for the exact status codes.
Next steps
| If you want to... | Start here |
|---|---|
| Set up your org and get access to an advertiser's account | Onboarding |
| Request and download a report | Request and download reports |
| See the exact columns returned in a report | Report schema |
| Diagnose an error response | Troubleshooting |