Pricing

from $0.40 / 1,000 ads

Try for free

Go to Apify Store

Facebook Ad Library Scraper - Competitor Ads by Keyword or Page

Try for free

Find Facebook and Instagram ads by keyword or Facebook Page. Export Library ID, advertiser, start date, platforms, copy, CTA, creative links and landing URL. Failed searches are free.

Pricing

from $0.40 / 1,000 ads

Rating

0.0

(0)

Developer

Yukai Lin

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Categories

Marketing

Social media

Lead generation

You can access the Facebook Ad Library Scraper - Competitor Ads by Keyword or Page 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 API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "dOmLppEU0nQcb0uzM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tidytools~facebook-ads-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tidytools-facebook-ads-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/tidytools~facebook-ads-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tidytools-facebook-ads-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/tidytools~facebook-ads-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tidytools-facebook-ads-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",
        "properties": {
          "searchTerms": {
            "title": "Keywords",
            "type": "array",
            "description": "Search public Ad Library ads by keyword; one phrase per line.",
            "items": {
              "type": "string"
            }
          },
          "pageUrls": {
            "title": "Facebook Page IDs or URLs",
            "type": "array",
            "description": "Numeric Facebook Page IDs or public Facebook Page URLs. Vanity URLs require one extra browser render to resolve their ID. An Ad Library search URL pasted here is treated like an entry in Ad Library URLs.",
            "items": {
              "type": "string"
            }
          },
          "adLibraryUrls": {
            "title": "Ad Library URLs",
            "type": "array",
            "description": "Search URLs copied from facebook.com/ads/library (with q=, view_all_page_id= or id=). Each URL is rendered as-is and keeps its own country, status, ad type and media filters.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code, or ALL for every country.",
            "default": "US"
          },
          "activeStatus": {
            "title": "Ad status",
            "enum": [
              "active",
              "inactive",
              "all"
            ],
            "type": "string",
            "description": "Active ads only, inactive (stopped) ads only, or both.",
            "default": "active"
          },
          "adType": {
            "title": "Ad type",
            "enum": [
              "all",
              "political"
            ],
            "type": "string",
            "description": "All ads or only political and issue ads.",
            "default": "all"
          },
          "mediaType": {
            "title": "Media type",
            "enum": [
              "all",
              "image",
              "video",
              "meme",
              "image_and_meme",
              "none"
            ],
            "type": "string",
            "description": "Ad Library media filter.",
            "default": "all"
          },
          "startDateFrom": {
            "title": "Started on or after",
            "type": "string",
            "description": "Only ads that started running on or after this date (YYYY-MM-DD). Ads outside the range are skipped and not charged."
          },
          "startDateTo": {
            "title": "Started on or before",
            "type": "string",
            "description": "Only ads that started running on or before this date (YYYY-MM-DD)."
          },
          "maxAdsPerQuery": {
            "title": "Maximum ads per query",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop after this many complete ads per keyword, Page or Ad Library URL.",
            "default": 50
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Facebook Ad Library Scraper - Competitor Ads by Keyword 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 - Competitor Ads by Keyword or Page 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 - Competitor Ads by Keyword or Page API in Python

Facebook Ad Library Scraper - Competitor Ads by Keyword or Page API in JavaScript

Facebook Ad Library Scraper - Competitor Ads by Keyword or Page API through CLI

Facebook Ad Library Scraper - Competitor Ads by Keyword or Page API

Facebook Reels Scraper

phone_number_scraper/facebook-reels-scraper

Facebook Reels Scraper extracts public Facebook Reels data from profiles, pages, and direct Reel URLs. Collect views, reactions, comments, shares, creator details, video URLs, thumbnails, audio metadata, and Reel analytics with pagination and date filtering.

Phone Number Scraper

Facebook Ads

shareze001/facebook-ads

You can retrieve ads by keyword or advertiser ID, with the advertiser ID available through `actor: shareze001/facebook-advertisers`. Additionally, you can filter ads based on time range and ad status for more specific results.

shareze

141

Meta Ad Video Analyzer

adintell/meta-ad-video-analyzer

AI-powered deep analysis of Meta (Facebook/Instagram) video ads. Extracts claims, proof elements, hook archetypes, cognitive tensions, and persuasion scores. Generates strategic intelligence reports for media buyers and creative strategists.

Bogdan Radu

Facebook Ads Library Scraper

axery/facebook-ads-scraper

Scrape active ads from Meta Facebook Ad Library: ad creative copy, images, video links, CTA buttons, targeted countries & page advertiser details. Zero login.

Axery

Facebook Ad Library Scraper - Meta Ads Intelligence

top_mythos/ad-library-scraper

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

Pascoal Dias

Cobasi Brasil Scraper API: produtos e preços pet

latinamericadata/cobasi-brasil

Extraia produtos Cobasi Brasil: preços em BRL, rações, marcas, SKU, EAN, vendedores e disponibilidade publicada. Busca paginada do catálogo pet; API, JSON, CSV e Excel.

Latin America Data

Facebook Ad Library Scraper

muhammad_noman_riaz/facebook-ad-library-scraper

Scrape ads from the public Facebook Ad Library by keyword, advertiser page and country: ad text, CTA, landing URL, images, videos, run dates and platforms. No login or cookies. Pay only for ads returned.

Muhammad Noman Riaz

Facebook Reels Scraper: Videos, Views & Audio

deepmine/facebook-reels-scraper

Facebook reels scraper: paste pages or reel links and get every reel with its caption, exact plays, likes, comments, shares, date, MP4 and audio links, captions and transcript, sound and remix info. No login, no cookies, no browser.

DeepMine

LinkedIn Ad Library Scraper

muhammad_noman_riaz/linkedin-ad-library-scraper

Scrape ads from the public LinkedIn Ad Library by advertiser, keyword, country and date: ad text, media, payer, run dates, impressions and targeting. No login or cookies. Pay only for ads returned.

Muhammad Noman Riaz

Snapchat Ads Library Scraper

pulsedata/snapchat-ads-library-scraper

Scrape the Snapchat Ads Gallery: every ad an advertiser runs in the EU and Turkey, with creative, landing page, impressions per country, age targeting and review status.