Pricing

from $0.75 / 1,000 record scrapeds

Facebook Ad Library Scraper - Meta Ads Intelligence

Scrape the Facebook & Instagram Ad Library for any advertiser or keyword. Creatives, spend, dates, reach. Pay only for ads delivered, never over your cap.

Pricing

from $0.75 / 1,000 record scrapeds

Rating

0.0

(0)

Developer

Pascoal Dias

Actor stats

Bookmarked

Total users

Monthly active users

7 days ago

Last modified

Categories

Marketing

Social media

E-commerce

You can access the Facebook Ad Library Scraper - Meta Ads Intelligence programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "cHw4zfKPf3OWZdRSk"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/top_mythos~ad-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-top_mythos-ad-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/top_mythos~ad-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-top_mythos-ad-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/top_mythos~ad-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-top_mythos-ad-library-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "platforms"
        ],
        "properties": {
          "platforms": {
            "title": "Ad libraries to search",
            "type": "array",
            "description": "Which ad libraries to query. Currently Meta (Facebook and Instagram). Google Ads and TikTok support is coming soon.",
            "items": {
              "type": "string",
              "enum": [
                "meta"
              ],
              "enumTitles": [
                "Meta (Facebook / Instagram)"
              ]
            },
            "default": [
              "meta"
            ]
          },
          "searchMode": {
            "title": "Search mode",
            "enum": [
              "keyword",
              "advertiser",
              "domain",
              "advertiserId"
            ],
            "type": "string",
            "description": "How to find ads. 'keyword' searches ad text (Meta and TikTok only, Google has no free-text search). 'advertiser' searches by brand/page name. 'domain' finds a brand by website (best for Google). 'advertiserId' uses exact platform IDs or profile URLs.",
            "default": "advertiser"
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords, advertiser names, or brands to search for. One run can cover several.",
            "items": {
              "type": "string"
            }
          },
          "advertiserIdsOrUrls": {
            "title": "Advertiser IDs or profile URLs",
            "type": "array",
            "description": "Precise page IDs, advertiser IDs (e.g. Google AR... ids), or ad-library profile URLs, used when searchMode is 'advertiserId'.",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "title": "Advertiser domains",
            "type": "array",
            "description": "Website domains to resolve to advertisers (e.g. nike.com). Best for Google, which is advertiser/domain-centric.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "ISO-3166 alpha-2 country codes to search within, also used to geo-target the proxy. TikTok and EU-commercial coverage require EEA/UK codes.",
            "default": [
              "US"
            ],
            "items": {
              "type": "string"
            }
          },
          "adStatus": {
            "title": "Ad status",
            "enum": [
              "active",
              "inactive",
              "all"
            ],
            "type": "string",
            "description": "Return active ads, inactive/stopped ads, or all.",
            "default": "all"
          },
          "adCategory": {
            "title": "Ad category",
            "enum": [
              "all",
              "commercial",
              "political"
            ],
            "type": "string",
            "description": "'political' unlocks spend and impression ranges where the platform publishes them (varies by region and law). 'commercial' restricts to commercial ads.",
            "default": "all"
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Only ads first shown on or after this date (YYYY-MM-DD). Leave empty for no lower bound."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Only ads first shown on or before this date (YYYY-MM-DD). Leave empty for no upper bound."
          },
          "mediaTypes": {
            "title": "Media types",
            "type": "array",
            "description": "Restrict to certain creative formats.",
            "items": {
              "type": "string",
              "enum": [
                "image",
                "video",
                "carousel",
                "text"
              ],
              "enumTitles": [
                "Image",
                "Video",
                "Carousel",
                "Text"
              ]
            },
            "default": [
              "image",
              "video",
              "carousel",
              "text"
            ]
          },
          "maxResultsPerPlatform": {
            "title": "Max results per platform",
            "minimum": 1,
            "maximum": 500000,
            "type": "integer",
            "description": "Hard cap on ads returned per platform. This limit is strictly enforced, the run will never exceed it or charge you beyond it.",
            "default": 1000
          },
          "downloadMedia": {
            "title": "Download creatives to storage",
            "type": "boolean",
            "description": "Host each ad's image/video/carousel as a downloadable file in the run's key-value store, instead of only expiring URLs. Billed as a separate media-download event.",
            "default": false
          },
          "includeTransparency": {
            "title": "Include transparency data",
            "type": "boolean",
            "description": "Pull EU/DSA reach and targeting, and political spend/impression ranges, where the platform exposes them. Billed as a separate enrichment event only when extra requests are made.",
            "default": true
          },
          "monitoringEnabled": {
            "title": "Monitoring mode (only new ads)",
            "type": "boolean",
            "description": "Return only ads not seen in previous runs of this monitoring set. Ideal for scheduled competitor tracking.",
            "default": false
          },
          "monitoringStateStore": {
            "title": "Monitoring state store name",
            "type": "string",
            "description": "Named key-value store that persists seen ad IDs across scheduled runs. Reuse the same name to keep a continuous watch.",
            "default": "ads-intel-seen"
          },
          "estimateOnly": {
            "title": "Cost preview only (no paid scrape)",
            "type": "boolean",
            "description": "Return an estimated ad count and price for these inputs without running a paid scrape. Use this to preview cost before committing.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Ad libraries block datacenter IPs. Residential proxies, geo-matched to your countries, are strongly recommended.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Facebook Ad Library Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Facebook Ad Library Scraper - Meta Ads Intelligence from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Facebook Ad Library Scraper - Meta Ads Intelligence API in Python

Facebook Ad Library Scraper - Meta Ads Intelligence API in JavaScript

Facebook Ad Library Scraper - Meta Ads Intelligence API through CLI

Facebook Ad Library Scraper - Meta Ads Intelligence API

Meta Ads Library Scraper - Facebook & Instagram Ads API

groupoject/meta-ads-library-monitor

Monitor Meta Ad Library ads by keyword or Facebook page ID. Export ad copy, pages, platforms, dates, countries, spend/reach fields when available, and creative links.

Group Oject

Facebook Ad Library Scraper Monitoring Mode Meta Instagram Ads

scrapesage/facebook-ad-library-scraper

Scrape Facebook, Instagram & Meta ads from the public Meta Ad Library by keyword, Facebook Page, or URL. Get ad copy, creatives, videos, CTA, links, dates & advertiser data — 50+ fields per ad, no login. Monitoring mode returns only NEW ads since your last run. Export JSON, CSV or Excel.

Scrape Sage

Meta/Facebook Ads Library Scraper

alwaysprimedev/facebook-ads-library-scraper

Scrape ads, creatives, advertisers, and landing pages from the Facebook (Meta) Ad Library by keyword or advertiser — fast, structured JSON.

Always Prime

Facebook Ads Library Scraper

scrapapi/facebook-ads-library-scraper

📊 Facebook Ads Library Scraper pulls public ad data—creatives, copy, advertiser, dates, regions, and spend/impressions (when available) from Meta’s Ad Library. 🚀 Perfect for competitor research, ad tracking & compliance. Export CSV/JSON, schedule runs, and automate.

ScrapAPI

Facebook Ads Library Scraper API

api_creators/facebook-ads-library-scraper-api

$1 per 1000 ads! Scrape Facebook Ad Library: Extract ad data, copy & creatives from FB & Instagram. Powerful Facebook Ads Scraper for competitor research & ad intelligence. Search by keyword or Page ID. Export JSON, CSV, or Excel. Fast, reliable, and cheap Facebook Ad Library API.

API Creators

154

5.0

Facebook Ads Library Scraper

simpleapi/facebook-ads-library-scraper

Facebook Ads Library Scraper extracts ads from the Facebook Ads Library, capturing ad creatives, texts, impressions, spend ranges, regions, advertiser info, start/end dates, and transparency data. Ideal for competitor research, ad monitoring, political ad tracking, and automated marketing insights.

SimpleAPI

Facebook & Meta Ads Library Scraper — Ad Intelligence Tool

aiscraperdev/facebook-meta-ads-library-scraper

Scrape Facebook & Instagram ads by keyword, brand, or country. Extract ad copy, creatives, CTA, video URLs & advertiser data. No login required.

Randeep Dhillon

5.0

Facebook Ads Library Scraper — Meta Ads + Instagram Data

sourabhbgp/facebook-ads-scraper

Scrape Facebook Ads Library (Meta Ad Library) with 57 fields per ad — no login needed. Get ad copy, images, videos, CTAs, run dates, Instagram followers, page verification, AI-content flag, EU transparency. Search by keyword, advertiser, or paste any Ad Library URL.

Sourabh Kumar

123

Facebook Ad Library Scraper - Competitor Ads & Creatives

fascinating_lentil/facebook-ad-library-scraper

Scrape ads from the public Facebook Ad Library. Extract ad creatives, text, headlines, spend ranges, impressions, targeting info, and more.

Md Jakaria Mirza

Meta (Facebook) Ad Library Scraper - Efficient & Fast

automly/facebook-ad-library-scraper

Scrape the Meta Ad Library for Facebook and Instagram ads. Extract ad copy, images, videos, spend, impressions, and advertiser transparency data. No account or API key required.