---
title: "Meta Ad Library connection guide"
slug: "meta-ad-library-connection-guide"
description: "Connect your Facebook Ads data to Supermetrics with the right permissions. Follow our guide for seamless integration and reporting across platforms."
tags: ["Paid media"]
updated: 2026-10-28T13:21:18Z
published: 2026-10-28T13:21:18Z
canonical: "docs.supermetrics.com/meta-ad-library-connection-guide"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Ad Library connection guide

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](https://hub.supermetrics.com/token-management). On the Hub, you can also [share an authentication link](https://docs.supermetrics.com/v1/docs/how-to-connect-to-data-sources-from-supermetrics-hub#share-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](/docs/meta-ad-library-connection-guide#connection-instructions).

## 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](http://facebook.com/ID). 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.

> [!NOTE]
> 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](http://facebook.com/ID) 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.

1. Select the **Meta Ad Library data** source [on the Supermetrics Hub](https://hub.supermetrics.com/token-management) or in the data destination.
2. If prompted, choose to make this connection [shared or private](/v1/docs/about-shared-and-private-connections).
3. Click **Start**.
4. Either log in with a new Facebook account, or click **Continue as** to go ahead with the account you’re already logged in to.
5. Review the requested `ads_read` permission, and click **Continue**.
6. Click **Got it**.
7. 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](https://docs.supermetrics.com/docs/how-to-connect-to-data-sources-from-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](/v1/docs/how-to-connect-supermetrics-to-ai-tools)
  - Supermetrics Studio: [How to create dashboards in Supermetrics Studio](/v1/docs/how-to-create-dashboards-in-supermetrics-studio)
- **Spreadsheet and data visualization tools:**
  - Google Sheets: [How to connect to a Supermetrics data source in Google Sheets](https://docs.supermetrics.com/docs/how-to-connect-to-a-supermetrics-data-source-in-google-sheets)
  - Data Studio: [How to connect data sources to Data Studio](/v1/docs/how-to-connect-data-sources-to-data-studio)
  - Excel: [How to connect data sources to Excel with Supermetrics](https://docs.supermetrics.com/docs/how-to-connect-data-sources-to-excel-with-supermetrics)
  - Power BI: [How to create your first Supermetrics query for Power BI](https://docs.supermetrics.com/docs/how-to-create-your-first-supermetrics-query-for-power-bi)
- **Data warehouses and cloud storage:**
  - The Supermetrics API: [How to use the Query Manager](https://docs.supermetrics.com/docs/how-to-use-the-query-manager)
  - Data warehouse and cloud storage (Hub): [How to create a transfer](https://docs.supermetrics.com/docs/how-to-create-a-transfer)
  - BigQuery (marketplace): [How to create a BigQuery (marketplace) transfer](https://docs.supermetrics.com/v1/docs/how-to-create-a-bigquery-marketplace-transfer)

## More resources

- [How to reauthenticate a data source connection](/v1/docs/how-to-reauthenticate-a-data-source-connection)
- [How to manage data source connections on the Supermetrics Hub](https://docs.supermetrics.com/docs/how-to-manage-data-source-connections-on-supermetrics-hub)