Pricing

from $11.00 / 1,000 actionable ad changes

Try for free

Go to Apify Store

Facebook Ads Library Scraper

Try for free

Pulls live and ended ads from the Facebook Ads Library for any advertiser: creative text, format, run dates, platforms, landing pages. Diff pulls to see what changed.

Pricing

from $11.00 / 1,000 actionable ad changes

Rating

0.0

(0)

Developer

omar khandji

Actor stats

Bookmarked

Total users

Monthly active users

15 hours ago

Last modified

Categories

Social media

Lead generation

MCP servers

You can access the Facebook Ads 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 API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "nrSkl16xsBnaGvkXS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/om_kh~facebook-ads-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-om_kh-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/om_kh~facebook-ads-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-om_kh-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/om_kh~facebook-ads-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-om_kh-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",
        "required": [
          "maxTotalChargeUsd"
        ],
        "properties": {
          "pageNames": {
            "title": "Facebook/Instagram Page names to track",
            "type": "array",
            "description": "Meta Page names (or Page URLs) whose public Ad Library entries you want monitored.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "currentAds": {
            "title": "Bring your own ads (optional)",
            "type": "array",
            "description": "Skip the chained Meta Ad Library fetch and pass ad data directly.",
            "default": []
          },
          "previousAds": {
            "title": "Previous ads (non-monitor mode)",
            "type": "array",
            "description": "Ads from the prior run; used to identify changes when not using persistent monitor mode.",
            "default": []
          },
          "maxTotalChargeUsd": {
            "title": "Maximum Vigia charge (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Hard maximum amount that this run may charge.",
            "default": 1
          },
          "sources": {
            "title": "Declared upstream sources and estimated costs",
            "type": "array",
            "description": "Declare every upstream source before this run. Each item needs name, authorization, and estimated_cost_usd.",
            "default": [
              {
                "name": "Chained Meta Ad Library actor",
                "authorization": "public_structured_data",
                "estimated_cost_usd": 0
              }
            ]
          },
          "monitorEnabled": {
            "title": "Monitor only changes",
            "type": "boolean",
            "description": "The first monitored run stores a free baseline. Later runs deliver and charge only real changes.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID (optional)",
            "type": "string",
            "description": "Pins the persistent baseline to a name of your choice, so separate targets never share state. Leave empty to derive it automatically.",
            "default": ""
          }
        }
      },
      "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 Ads Library Scraper - Competitor Ad Data 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 Ads 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:

Facebook Ads Library Scraper API in Python

Facebook Ads Library Scraper API in JavaScript

Facebook Ads Library Scraper API through CLI

Facebook Ads Library Scraper API

Google Ads Transparency Scraper - $0.10 + $0.02

om_kh/google-ads-transparency-scraper

Extract advertiser data from Google's Ads Transparency Center: ad creatives, formats, regions and run dates for any brand. Clean structured rows, deduplicated. Optionally diff against your previous pull to catch newly. Pricing: $0.10 per subject checked + $0.02 per result. First 10 results free.

omar khandji

Facebook Ad Library Scraper

curious_coder/facebook-ads-library-scraper

Scrape ads from facebook ads library search results and facebook pages. Cost: $0.75 per 1K ads

Curious Coder

40K

4.8

Amazon Reviews Scraper - $0.45 + $0.02

om_kh/amazon-reviews-scraper

Bulk-download Amazon product reviews: star rating, title, body, author, verified-purchase flag and date. Clean deduplicated rows. Includes a review-velocity signal that flags unusual spikes, useful for spotting review. Pricing: $0.45 per subject checked + $0.02 per result. First 10 results free.

omar khandji

LinkedIn Company Scraper - $0.10 + $0.02

om_kh/linkedin-company-scraper

Scrape LinkedIn company data: name, industry, headquarters, website, employee count, follower count and description. Clean rows for firmographic enrichment and competitive benchmarking. Pricing: $0.10 per subject checked + $0.02 per result. First 10 results free.

omar khandji

Facebook Ads Library Scraper

scraptivo/facebook-ads-scraper

Collects public ads from Facebook Ads Library by URL, keyword, or advertiser page ID. Returns ad copy, platforms, dates, and optional advertiser details.

Scraptivo

Facebook Ad Library Scraper

jobscrawler/facebook-ad-library-scraper

Scrape ads from Facebook Ads Library search results and Facebook pages with zero null values and comprehensive data enrichment. Cost: $0.75 per 1K ads.

Jobs Scraper

Facebook Ads Library Scraper

devcake/facebook-ads-library-scraper

Facebook Ads Library scraper for competitor research. Find active Meta ads by keyword or Page, export ad text, images, videos, and landing pages.

devcake

Google Maps Reviews Scraper - $0.05 + $0.02

om_kh/google-maps-reviews-scraper

Bulk-download Google Maps reviews for any business or place: star rating, review text, reviewer, owner response and date. Clean deduplicated rows for reputation analysis and local-market research. Pricing: $0.05 per subject checked + $0.02 per result. First 10 results free.

omar khandji

Facebook Ads Library Scraper

chenglianglin/fb-ad-library-actor

Scrape ads from Meta's public Facebook Ads Library by keyword or Page ID.

Chengliang Lin

Yelp Reviews Scraper - Ratings, Text - $0.15 + $0.02

om_kh/yelp-reviews-scraper

Bulk-download Yelp reviews for any business: star rating, text, reviewer name, reviewer review count and date. Clean deduplicated rows for local reputation analysis and competitive benchmarking. Pricing: $0.15 per subject checked + $0.02 per result. First 10 results free.

omar khandji