This guide contains all permissions and requirements for connecting your Meta Ad Library data to Supermetrics.
You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.
After you connect to the data source on the Hub, you can use the data source connection in all available destinations.
Required permissions
Meta Ad Library is a public ad transparency database, so you don’t need any ad account, Business Manager, or Page permissions to use it. However, Meta requires every user to complete a one-time identity verification before the Ad Library API will return data.
Before connecting, your Facebook account needs:
A personal Facebook account (business accounts can’t be used to call the Ad Library API).
A completed identity verification at Facebook identity confirmation. You’ll need to upload a government-issued ID (passport, national ID, or driver’s license), confirm your country of residence, and complete SMS verification.
Complete identity verification before connecting
Approval typically takes 1–3 business days, occasionally longer. Until Meta approves your verification, the connection will authorize successfully, but every query will return an “Identity verification required” error. If you see this error after connecting, visit Facebook identity confirmation to check your status.
Connection instructions
When connecting to Meta Ad Library, you need to log in to Facebook and authorize the ads_read permission when prompted.
Select the Meta Ad Library data source on the Supermetrics Hub or in the data destination.
If prompted, choose to make this connection shared or private.
Click Start.
Either log in with a new Facebook account, or click Continue as to go ahead with the account you’re already logged in to.
Review the requested
ads_readpermission, and click Continue.Click Got it.
In your data destination, build your report by choosing a country, ad category, ad status, and search keyword.
See detailed instructions on how to connect to a data source from the Supermetrics Hub.
You can also connect to Meta Ad Library from these destinations:
AI tools and dashboards:
AI chats: How to connect Supermetrics to AI tools
Supermetrics Studio: How to create dashboards in Supermetrics Studio
Spreadsheet and data visualization tools:
Data Studio: How to connect data sources to Data Studio
Data warehouses and cloud storage:
The Supermetrics API: How to use the Query Manager
Data warehouse and cloud storage (Hub): How to create a transfer
BigQuery (marketplace): How to create a BigQuery (marketplace) transfer