Meta Ads Library Scraper — Facebook & Instagram Ads

What is Meta Ads Library Scraper — Facebook & Instagram Ads?

Scrape ads from Meta Ad Library across Facebook and Instagram. Keyword search or page URLs, hard resultsLimit, honest onlyTotal mode, drop-in fields for apify/facebook-ads-scraper.

Documentation

What Meta Ads Library Scraper — Facebook & Instagram Ads returns

Field	What it is	Example
pageName	Page name	Nike
adArchiveId	Ad archive ID	1234567890123456
isActive	Active	true

How do I scrape ads from Meta Ad Library across Facebook and Instagram?

1. Click Try for free.
2. Fill Ad Library or Facebook Page URL, Count only (no ad rows) and Active status (if not in URL).
3. Set Max ads per URL.
4. Click Start.
5. Open the dataset and download it, or send it on with one of the integrations below.

A search can match more than one row. The run keeps the first matches, up to Max ads per URL.

Saved runs on the Tasks tab:

• Count total Facebook ads without downloading creatives
• Scrape Facebook Ads in Australia | Ad Library
• Scrape Facebook Ads in Austria | Ad Library
• Scrape Facebook Ads in Belgium | Ad Library
• Scrape Facebook Ads in Brazil | Ad Library
• Scrape Facebook Ads in Canada | Ad Library
• Scrape Facebook Ads in Egypt | Ad Library
• Scrape Facebook Ads in France | Ad Library

Input

The Input tab lists every field. The sample input is:

{
    "startUrls": [
        {
            "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike"
        }
    ],
    "resultsLimit": 5,
    "onlyTotal": false,
    "activeStatus": "",
    "sorting": "",
    "isDetailsPerAd": false,
    "includeAboutPage": false,
    "enrichWithEcommerceData": false
}

Output

One row looks like this. scrapedAt, when present, is the time that run finished.

{
  "adArchiveId": "1234567890123456",
  "pageName": "Nike",
  "pageId": "15087023444",
  "isActive": true,
  "publisherPlatform": [
    "FACEBOOK",
    "INSTAGRAM"
  ],
  "startDate": 1735689600,
  "snapshot": {
    "body": "Just Do It.",
    "title": "New collection",
    "linkUrl": "https://www.nike.com/",
    "ctaText": "Shop Now",
    "images": [
      "https://..."
    ],
    "videos": []
  },
  "sourceUrl": "https://www.facebook.com/ads/library/?...&q=nike",
  "scrapedAt": "2026-08-28T11:00:00+00:00"
}

How much does Meta Ads Library Scraper — Facebook & Instagram Ads cost?

You pay for each row saved. Platform usage is included. Current rates are on the Pricing tab.

How pay-per-event billing works: Actors in Store.

Related Actors

Actor	When to use it
Instagram Profile Scraper	You need public profile metadata for brands running the ads
Instagram Comments Scraper	You pair paid creatives with organic post comment research
Apify Facebook Ads Scraper	You need the official Store leader with full EU reach enrichment

Integrations

Excel

1. Click Try for free, run this Actor, and wait until the run finishes.
2. Open that run and go to its dataset.
3. Choose Export, then Excel.

To download the newest successful run later without opening the dataset:

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once.
4. Paste this into a browser. Replace TASK_ID and YOUR_TOKEN.

https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=xlsx&clean=true&status=SUCCEEDED&token=YOUR_TOKEN

Anyone with that URL can read the rows. Treat the token like a password.

Dataset export formats: Dataset items.

Google Sheets

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once so there is a successful dataset.
4. In a Google Sheet, click cell A1 and paste this formula. Replace TASK_ID and YOUR_TOKEN.

=IMPORTDATA("https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=csv&clean=true&status=SUCCEEDED&token=YOUR_TOKEN")

5. Wait until the columns fill. Sheets refreshes IMPORTDATA on its own. Use Data → Data connectors → Refresh when you want it now.

Anyone with that URL can read the rows. Treat the token like a password.

API, Python, and Node

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. Send this request. Replace YOUR_TOKEN.

curl -X POST "https://api.apify.com/v2/acts/bakos_bence~meta-ads-library/runs?token=YOUR_TOKEN&waitForFinish=120" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike"}],"resultsLimit":5,"onlyTotal":false,"activeStatus":"","sorting":"","isDetailsPerAd":false,"includeAboutPage":false,"enrichWithEcommerceData":false}'

3. From the response, copy defaultDatasetId.
4. Fetch the rows:

https://api.apify.com/v2/datasets/DATASET_ID/items?format=json&clean=true&token=YOUR_TOKEN

The API tab on this page has the same call in JavaScript, Python, and the CLI. Client docs: JavaScript, Python, Run an Actor.

Zapier

1. In Apify Console, open Settings → API & Integrations and copy an API token. You will only need it if the connection asks for a token. The usual path is the access prompt below.
2. In Zapier, create a Zap. For the action, search Apify and choose Run Actor.
3. Connect your Apify account and choose Allow Access.
4. Select Meta Ads Library Scraper — Facebook & Instagram Ads.
5. Paste this input:

{
    "startUrls": [
        {
            "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike"
        }
    ],
    "resultsLimit": 5,
    "onlyTotal": false,
    "activeStatus": "",
    "sorting": "",
    "isDetailsPerAd": false,
    "includeAboutPage": false,
    "enrichWithEcommerceData": false
}

6. Use a synchronous run only when the run will finish within 30 seconds. Otherwise leave it asynchronous, then add Fetch dataset items, or start the Zap with the Finished Actor run trigger.
7. Test the step. Add the next action, such as Google Sheets, Slack, or email. Publish the Zap.

Triggers and the other actions: Zapier integration.

Make

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. In a Make scenario, add a module and search Apify.
3. Create the connection with OAuth, or paste the API token.
4. Choose Run an Actor. Select Meta Ads Library Scraper — Facebook & Instagram Ads. Set Run synchronously to Yes.
5. Paste this input:

{
    "startUrls": [
        {
            "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike"
        }
    ],
    "resultsLimit": 5,
    "onlyTotal": false,
    "activeStatus": "",
    "sorting": "",
    "isDetailsPerAd": false,
    "includeAboutPage": false,
    "enrichWithEcommerceData": false
}

6. Add Get Dataset Items. Set the dataset ID to the default dataset ID from the Run an Actor module.
7. Add the module that should receive the rows, such as Google Sheets Bulk add rows, and map the fields.

If the run can take longer than your Make plan lets a synchronous module wait, start with Watch Actor Runs instead, then add Get Dataset Items. Details: Make integration.

n8n

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On n8n Cloud, open the nodes panel, search Apify, and install the node. On a self-hosted n8n, go to Settings → Community Nodes → Install and enter @apify/n8n-nodes-apify.
3. Create a credential. Search Apify API, paste the token, and save. On n8n Cloud you can use Apify OAuth2 instead.
4. Add an Apify node. Choose Run Actor. Pick Meta Ads Library Scraper — Facebook & Instagram Ads. Turn on Wait for finish.
5. Set the input to:

{
    "startUrls": [
        {
            "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike"
        }
    ],
    "resultsLimit": 5,
    "onlyTotal": false,
    "activeStatus": "",
    "sorting": "",
    "isDetailsPerAd": false,
    "includeAboutPage": false,
    "enrichWithEcommerceData": false
}

6. Add another Apify node, Get Dataset Items. Set the dataset ID to the defaultDatasetId from the Run Actor node.
7. Add the next node, such as Google Sheets, and map the fields.

Full setup, triggers, and the AI-tool node: n8n integration.

Power BI

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once.
4. Open Power BI Desktop → Home → Get data → Web.
5. Paste this URL. Replace TASK_ID and YOUR_TOKEN.

https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=csv&clean=true&status=SUCCEEDED&token=YOUR_TOKEN

6. When asked how to sign in, choose Anonymous → Connect.
7. Check that the preview is a table, then Load.
8. After you publish, schedule refresh against that same URL.

A 401 means the token is missing or you did not choose Anonymous. Anyone with the URL can read the rows.

Looker Studio

Looker Studio does not open a private CSV URL on its own. Put the rows in a Google Sheet first.

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once.
4. In a Google Sheet, click cell A1 and paste this formula. Replace TASK_ID and YOUR_TOKEN.

=IMPORTDATA("https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=csv&clean=true&status=SUCCEEDED&token=YOUR_TOKEN")

5. Wait until the columns fill.
6. In Looker Studio, choose Create → Report → Google Sheets and pick that spreadsheet.
7. After the next run, refresh the Sheet, then refresh the Looker data source.

For a single snapshot, open the finished run, export CSV from the dataset, and use File upload in Looker Studio.

Tableau

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once.
4. In Tableau Desktop 2023.3+, install the REST API connector from Tableau Exchange.
5. Choose Connect → To a Server → REST API.
6. Paste this URL. Replace TASK_ID and YOUR_TOKEN. Set the response format to CSV.

https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=csv&clean=true&status=SUCCEEDED&token=YOUR_TOKEN

7. Leave credentials empty. The token is already in the URL.
8. Create an extract. Refresh it after the next run.

For a single snapshot, open the finished run, export CSV from the dataset, and connect Tableau to that file.

Qlik

1. In Apify Console, open Settings → API & Integrations and copy an API token.
2. On this Actor, open the Tasks tab, open the task you want, and copy the task ID from the URL.
3. Run that task once.
4. In Qlik Cloud or Qlik Sense, choose Add data → REST.
5. Set the method to GET and paste this URL. Replace TASK_ID and YOUR_TOKEN.

https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=csv&clean=true&status=SUCCEEDED&token=YOUR_TOKEN

6. Set the response type to CSV.
7. Test the connection, pick the table, and load.
8. Reload the app after the next run.

For a single snapshot, open the finished run, export CSV from the dataset, and add that file in Qlik.

Webhooks

1. In Apify Console, open this Actor and go to Integrations.
2. Add a webhook for Actor run succeeded.
3. Set the URL of the service that should receive the run.
4. When a run finishes, the payload includes defaultDatasetId. Read the rows with this URL. Replace DATASET_ID and YOUR_TOKEN. The token is under Settings → API & Integrations.

https://api.apify.com/v2/datasets/DATASET_ID/items?format=json&clean=true&token=YOUR_TOKEN

Event types and the payload: Webhooks.

AI tools

1. Open the API tab on this Actor.
2. Copy the MCP config shown there.
3. Paste it into the MCP client (Claude, Cursor, or another client that accepts that config).
4. Sign in when the client asks. It can then run this Actor.

Setup for each client: Apify MCP server.

Airtable, Google Drive, Slack, and Snowflake are listed in Integrations.

FAQ

Limitations (v0.1)

• isDetailsPerAd and includeAboutPage: schema accepted; enrichment is stubbed (see README).
• onlyAdsNewerThan / onlyAdsOlderThan / enrichWithEcommerceData: accepted for clone compatibility; set filters in the Ad Library URL instead.
• GraphQL doc_id rotates — if extraction returns zero rows across retries, rebuild may be needed.

Can I schedule this?

Yes. Save a Task from the input you want, then add a schedule in Console. After each successful run, this URL returns that task’s newest dataset. Replace TASK_ID and YOUR_TOKEN (the token is under Settings → API & Integrations).

https://api.apify.com/v2/actor-tasks/TASK_ID/runs/last/dataset/items?format=json&clean=true&status=SUCCEEDED&token=YOUR_TOKEN

This Actor is not affiliated with Meta.