Pricing

from $2.50 / 1,000 results

Meta (Facebook & Instagram) Ad Library Scraper

Scrape any advertiser's Facebook & Instagram ads from Meta's Ad Library: creatives, copy, CTA, run dates. $3.50 per 1,000 ads — no Meta API approval needed.

Pricing

from $2.50 / 1,000 results

Rating

0.0

(0)

Developer

Jaybird Technologies

Actor stats

Bookmarked

Total users

Monthly active users

11 days ago

Last modified

Categories

Social media

Lead generation

Marketing

You can access the Meta (Facebook & Instagram) Ad Library Scraper 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.5",
    "x-build-id": "3qdhfAmVDDmMVTjZf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/jaybird~meta-ad-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-jaybird-meta-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/jaybird~meta-ad-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-jaybird-meta-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/jaybird~meta-ad-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-jaybird-meta-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": [
          "search_mode"
        ],
        "properties": {
          "search_mode": {
            "title": "Search mode",
            "enum": [
              "page_id",
              "page_url",
              "keyword",
              "batch"
            ],
            "type": "string",
            "description": "How to look up ads. page_id and page_url target a specific advertiser; keyword and batch use Meta's keyword search. If the mode's matching field is left empty but exactly one other lookup field is filled in, the mode is auto-corrected to match (with a warning in the run summary).",
            "default": "keyword"
          },
          "page_id": {
            "title": "Facebook Page ID (numeric)",
            "type": "string",
            "description": "Used by search_mode = page_id. Numeric ID, e.g. 142023025844028. For a single keyword use 'Keyword / business name'; for a page link use 'Facebook Page URL'. If this is the only lookup field filled in, the mode is auto-corrected to page_id."
          },
          "page_url": {
            "title": "Facebook Page URL",
            "type": "string",
            "description": "Used by search_mode = page_url. e.g. https://www.facebook.com/PetsOnBroadway. For a numeric ID use 'Facebook Page ID' instead. If this is the only lookup field filled in, the mode is auto-corrected to page_url."
          },
          "query": {
            "title": "Keyword / business name",
            "type": "string",
            "description": "Used by search_mode = keyword. Free-text search across all advertisers. For multiple keywords use 'Batch queries' instead. If this is the only lookup field filled in, the mode is auto-corrected to keyword."
          },
          "queries": {
            "title": "Batch queries",
            "type": "array",
            "description": "Used by search_mode = batch. One keyword per line. Each query produces its own search results; overlapping queries are NOT deduplicated within a run. For a single keyword use 'Keyword / business name' instead. If this is the only lookup field filled in, the mode is auto-corrected to batch.",
            "items": {
              "type": "string"
            }
          },
          "region": {
            "title": "Region (ISO 3166-1 alpha-2)",
            "type": "string",
            "description": "Country to filter Meta's Ad Library results to. Defaults to US.",
            "default": "US"
          },
          "active_only": {
            "title": "Active ads only",
            "type": "boolean",
            "description": "When true, returns only currently-active ads. When false, includes inactive (stopped) ads.",
            "default": true
          },
          "media_type": {
            "title": "Media type filter",
            "enum": [
              "all",
              "image",
              "video"
            ],
            "type": "string",
            "description": "Filter to image-only or video-only creatives, or include all.",
            "default": "all"
          },
          "match_type": {
            "title": "Keyword match type",
            "enum": [
              "broad",
              "exact"
            ],
            "type": "string",
            "description": "How Meta should match the keyword/business name. 'broad' (default) matches ads containing all the words in any order (Meta's search_type=keyword_unordered). 'exact' matches ads containing the exact phrase (Meta's search_type=keyword_exact_phrase). Ignored when search_mode = page_id.",
            "default": "broad"
          },
          "max_ads_per_advertiser": {
            "title": "Max ads per advertiser",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Hard cap on ads returned for each query. With pagination off, first SSR page (~30 ads) only.",
            "default": 30
          },
          "follow_pagination": {
            "title": "Follow pagination cursors",
            "type": "boolean",
            "description": "When false, returns only the first SSR page (~30 ads). When true, walks end_cursor up to max_ads_per_advertiser.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Meta Ad Library Scraper – Active Ads + Dates 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 Meta (Facebook & Instagram) Ad Library Scraper 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:

Meta (Facebook & Instagram) Ad Library Scraper API in Python

Meta (Facebook & Instagram) Ad Library Scraper API in JavaScript

Meta (Facebook & Instagram) Ad Library Scraper API through CLI

Meta (Facebook & Instagram) Ad Library Scraper API

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

Facebook & Meta Ad Library Scraper - Competitor Ads & Creatives

jy-labs/meta-ad-library-multi-search-scraper

Scrape Facebook and Instagram ads from Meta Ad Library. Run up to 5 keywords, target exact advertiser Page IDs, and export ad creatives, copy, CTA links, media URLs, start dates, and platform data.

Juyeop Park

179

5.0

Meta Ad Library Scraper - Facebook & Instagram Ads

santhej/meta-ads-library-scraper

Scrape the Meta (Facebook & Instagram) Ad Library by keyword or advertiser. Get ad creatives, copy, CTA, run dates, days-running (winning-ad signal), platforms and landing links. No login.

Santhej Kallada

5.0

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

META Ads Library Scraper

leadsbrary/meta-ads-library-scraper

Scrape the Meta (Facebook & Instagram) Ads Library. Paste any Ad Library search URL or Facebook page URL. Get ad text, CTA, publisher platforms, language signals, dates and full advertiser page data. No login required.

Alexandre Manguis

865

2.9

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

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.

Automly

359

3.3

Meta Ad Library Ads Scraper

adside/meta-ad-library-ads-scraper

Scrape active Meta Ad Library ads by Facebook page ID. Get ad creatives, copy, media, CTAs, landing URLs, dates & platforms for competitor research.

Adside

Meta Ad Library Scraper Pro

webdatalabs/meta-ad-library-scraper

Extract competitor ads from Meta's Ad Library (Facebook, Instagram, Messenger, Audience Network). Get ad copy, creatives, targeting data, sentiment analysis, and track changes over time.