Pricing

Pay per usage

Facebook Ads Library Scraper: Ad Reach By Region & Age

Extract ad data with the Facebook Ads Library Scraper. Retrieve active and inactive ads, creatives, targeting info, impressions, and engagement metrics. Perfect for competitor analysis, market research, and ad strategy insights. Fast, reliable, and scalable for bulk ad data extraction.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Scrapier

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Categories

Social media

Automation

Lead generation

You can access the Facebook Ads Library Scraper: Ad Reach By Region & Age 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": "OoemdiBzLQFb96Kc7"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapier~facebook-ads-library-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~facebook-ads-library-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapier-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/scrapier~facebook-ads-library-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapier-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": {
          "adPageUrls": {
            "title": "🎯 Advertiser pages / Ad Library URLs",
            "type": "array",
            "description": "📋 One entry per line — a Facebook Page URL or an Ad Library query link. You may also pass objects with a `url` field (plus optional `label`, `limit`, or `period` per source).",
            "items": {
              "type": "string"
            }
          },
          "maxAds": {
            "title": "📦 Ads to profile (sample size)",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "📈 Maximum number of ads to profile for reach & audience **across all advertisers** in this run. ⏱️ Smaller = quick reach snapshot; 📚 larger = deeper audience coverage. Example: 25.",
            "default": 10
          },
          "reachSummaryOnly": {
            "title": "🧾 Advertiser reach rollup only",
            "type": "boolean",
            "description": "📉 Skip per-ad detail and emit **one rollup row per advertiser** with just the total ad count — a fast way to size an advertiser before a full audience pull. Default is off (one row per ad).",
            "default": false
          },
          "deepTransparencyLookup": {
            "title": "🔬 Deep per-ad transparency lookup",
            "type": "boolean",
            "description": "🔍 Runs the extra per-ad Ad Library transparency request that carries EU reach, age/country/gender demographics and funder/spend data (⏳ slower, far richer rows). Turn off only for a bare listing pass. Default is on.",
            "default": true
          },
          "includeAdvertiserProfile": {
            "title": "🏢 Attach advertiser page profile",
            "type": "boolean",
            "description": "📄 For **Facebook Page** advertisers, attach the public page title/description snippet so you can see who is behind the reach. Default is off.",
            "default": false
          },
          "includeAudience": {
            "title": "👥 Include EU reach & audience breakdown",
            "type": "boolean",
            "description": "📈 When on, each row adds `euTotalReach`, `ageGenderCountryBreakdown` (per‑country × age × gender reach) and `targeting` (ages/gender/locations reached). Requires the per‑ad detail lookup (enabled automatically). Default is on.",
            "default": true
          },
          "includeAudienceAnalytics": {
            "title": "📈 Include audience analytics (derived)",
            "type": "boolean",
            "description": "🧮 When on, each row adds an `audienceAnalytics` object computed purely from the live EU reach data: `reachTier` (bucketed reach), `topCountry`, `countryCount`, `genderSkew` (male/female share + skew), `dominantAgeRange` and `ageSkew`. 100% coverage on EU‑served ads — real math on real reach numbers, never fabricated. Default is on.",
            "default": true
          },
          "politicalOnly": {
            "title": "⚖️ Political & issue ads only",
            "type": "boolean",
            "description": "🏛️ Keep only ads that carry political/issue transparency (funder/payer, beneficiary, spend or impressions ranges, or AAA eligibility). Example: turn on to export just the funded political ads from a broad Ad Library query. Default is off (all ads).",
            "default": false
          },
          "targetCountry": {
            "title": "🌍 Reach country focus",
            "enum": [
              "ALL",
              "AR",
              "AU",
              "AT",
              "BD",
              "BE",
              "BR",
              "CA",
              "CL",
              "CN",
              "CO",
              "CR",
              "CZ",
              "DK",
              "EC",
              "EG",
              "FI",
              "FR",
              "DE",
              "GR",
              "GT",
              "HK",
              "HU",
              "IN",
              "ID",
              "IE",
              "IL",
              "IT",
              "JP",
              "KE",
              "MY",
              "MX",
              "NL",
              "NZ",
              "NG",
              "NO",
              "PK",
              "PA",
              "PE",
              "PH",
              "PL",
              "PT",
              "PR",
              "RO",
              "RU",
              "SA",
              "SG",
              "ZA",
              "KR",
              "ES",
              "SE",
              "CH",
              "TW",
              "TH",
              "TR",
              "AE",
              "GB",
              "US",
              "UY",
              "VE",
              "VN",
              "UA"
            ],
            "type": "string",
            "description": "📍 Country used to pull reach for **Facebook Page** advertisers. Ad Library query links usually already carry their own country.",
            "default": "ALL"
          },
          "dateRange": {
            "title": "🗓️ Reach delivery window",
            "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
            "type": "string",
            "description": "⏳ Optional delivery window for Page advertisers when the source URL does not set one. **Leave empty** to follow the Ad Library default. Pick a calendar date or a relative span (e.g. 30 days) — passed through as provided.",
            "default": ""
          },
          "adStatus": {
            "title": "🚦 Ad delivery status",
            "enum": [
              "all",
              "active",
              "inactive"
            ],
            "type": "string",
            "description": "🎛️ Which ads to profile for **Page** advertisers (or when your Ad Library link leaves it unspecified): still-running, stopped, or both.",
            "default": "all"
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy (optional)",
            "type": "object",
            "description": "🏠 Leave off for a standard run. If you enable Apify Proxy here, **only residential** proxy traffic is used for the whole run. Requires proxy access on your Apify plan."
          }
        }
      },
      "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: Ad Reach By Region & Age 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: Ad Reach By Region & Age 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: Ad Reach By Region & Age API in Python

Facebook Ads Library Scraper: Ad Reach By Region & Age API in JavaScript

Facebook Ads Library Scraper: Ad Reach By Region & Age API through CLI

Facebook Ads Library Scraper: Ad Reach By Region & Age API

Facebook Ad Library Scraper

agenscrape/facebook-ad-library-scraper

Extract ads from Facebook Ad Library instantly. Get complete ad details, images, videos, page info, impressions, and targeting data. Just paste the Ad Library URL and run. Fast, reliable extraction for competitor research and market analysis.

Agenscrape

279

📢 Facebook Ads Library Scraper Plus

scraper-engine/facebook-ads-library-scraper

The Facebook Ads Library Scraper extracts ad data from Facebook’s Ad Library, including advertiser details, ad text, impressions, and targeting info. Ideal for ad research, marketing insights, and competitor analysis, it delivers clean, structured data for analysis or integration via API.

Scraper Engine

404

2.8

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

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

157

5.0

Facebook Ads Library Scraper: Creative & Ad Text Details

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 Ad Library Scraper

scraper-engine/facebook-ad-library-scraper

Facebook Ad Library Scraper extracts ads from the Facebook Ad Library. It collects ad text, advertiser names, ad creatives, start dates, platforms, and engagement details. Ideal for competitor analysis, ad research, marketing insights, and tracking advertising trends.

Scraper Engine

📢 Facebook Ads Scraper — Competitor Ad Tracker

nexgendata/facebook-ads-library-scraper

Scrape Meta's Ad Library for active Facebook and Instagram ads. Track competitor ad creatives, spend estimates, targeting, and campaign duration. Essential for ad intelligence and competitive research.

NexGenData

Facebook Ads Library Scraper - Low-cost💲🔥🎯📈

delectable_incubator/facebook-ads-library-scraper-low-cost

Scrape Facebook (Meta) Ads data 🚀📊 from one or multiple pages with a powerful ad intelligence scraper. Extract ad IDs, page details, impressions, reach estimates, creatives, and campaign insights. Export data in JSON, CSV, or Excel for marketing analysis, competitor research and ad monitoring 📈💻

Prime Scrape

Facebook Ad Library Scraper

apipi/facebook-ad-library-scraper

Ultra-fast Facebook Ads Library scraper with advanced filtering. Extract ads from Meta Ads Library in seconds! Perfect for competitor analysis, market research, and ad intelligence.

ApiPi

244

5.0

Facebook Ad Library Scraper

corner_cutter/facebook-ad-library-scraper

Comprehensive Meta ad library tool that fetches all ads for a given Facebook Ad Library URL or page URL. Extract ad creatives, copy, targeting info, and more.