# Facebook Page Transparency Scraper (`maximedupre/facebook-page-transparency-scraper`) Actor Export public Facebook Page/Profile transparency and Meta Ad Library creatives by brand or Page ID, with optional unified audits. No Facebook login is required. - **URL**: https://apify.com/maximedupre/facebook-page-transparency-scraper.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** Social media, Marketing, Business - **Stats:** 4 total users, 3 monthly users, 78.9% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.80 / 1,000 transparency profiles This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🔎 Audit Facebook Page transparency and public ads Built for brand researchers, agencies, journalists, and compliance teams, this Actor turns known public Facebook Pages or Profiles and public Meta Ad Library searches into structured transparency profiles and ad creatives. Review ownership, creation and name history, management countries, contacts, advertising status, creative copy, media, and source links without manually checking each Page. - **[Facebook Page Transparency Scraper](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-page-transparency-scraper)** — export public transparency profiles for known Pages and Profiles. - **[Facebook Page Ownership Audit](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-page-ownership-audit)** — review source-exposed responsible-owner details and advertising status. - **[Facebook Page Name History](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-page-name-history)** — export previous Page names and available change dates. - **[Facebook Page Management Countries](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-page-management-countries)** — compare where source-reported Page managers are located. - **[Meta Ad Library Scraper](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/meta-ad-library-scraper)** — collect public creatives for a brand in a selected country. - **[Facebook Ads by Page ID](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-ads-by-page-id)** — retrieve public creatives for one numeric Page ID. - **[Meta Ad Creative Export](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/meta-ad-creative-export)** — send ad copy, media, status, advertiser data, and source links downstream. - **[Facebook Page Ad Audit](https://apify.com/maximedupre/facebook-page-transparency-scraper/examples/facebook-page-ad-audit)** — combine a known target's transparency context with its available creatives. #### 📦 What data can you get? Transparency profile rows use `rowType: "transparencyProfile"` and can include: - Canonical `id`, `name`, `username`, `url`, `entityType`, verification, and categories. - `transparencyAvailable`, `creationDate`, `nameHistory`, `managementCountries`, responsible `owner`, and `adStatus`. - Public `contacts`, address, `business` details, delegate Page, operating hours, and `audience` context. Ad rows use `rowType: "adCreative"` and can include: - Creative `id`, active status, start and end dates, country, platforms, format, and `adLibraryUrl`. - Advertiser identity, Page ID, categories, and verification. - Body, headline, description, caption, destination URL, display URL, and call to action in `copy`. - Public image or video URLs, paid-for-by disclaimer, and source-exposed spend or impression ranges. - Joined `pageTransparency` context when you run a unified audit. Missing values are omitted rather than inferred. `transparencyAvailable: false` means the entity resolved but Facebook did not expose transparency details; unresolved or inaccessible targets do not produce placeholder rows. #### 🚀 How to run the Actor 1. Open the Actor in Apify Console. 2. Choose one **Target**. 3. Enter the matching Page/Profile targets, brand search, or Page ID. 4. For ad targets, choose a country, ad status, and maximum number of ads. 5. Start the run, then open the default dataset to inspect or export the rows. You can also run it through the Apify API or schedule repeat audits. #### ⚙️ Input Choose one of four `target` values: - `pageTransparency` — accepts `targets`: usernames, supported Facebook URLs, or numeric Page IDs. - `adsByBrand` — accepts one `brandQuery`. - `adsByPageId` — accepts one numeric `pageId`. - `unifiedAudit` — accepts known `auditTargets` and joins available transparency context to their creatives. For ad and unified targets, `country` is a two-letter uppercase country code, `adStatus` is `active` or `all`, and `maxAds` ranges from 1 to 10,000. Options belonging to inactive targets are ignored, and duplicate known targets are resolved once. Example — active US ads for a known Page: ```json { "target": "adsByPageId", "pageId": "20531316728", "country": "US", "adStatus": "active", "maxAds": 100 } ```` #### 📤 Output Each successful dataset row is either a transparency profile or an ad creative, identified by `rowType`. Here is a shortened transparency row using only public output fields: ```json { "rowType": "transparencyProfile", "id": "20531316728", "name": "Facebook", "username": "facebook", "url": "https://www.facebook.com/facebook", "entityType": "page", "verified": true, "transparencyAvailable": true, "creationDate": "2007-08-25" } ``` Results are available from the default dataset in Apify Console and through dataset API endpoints. Export them as JSON, CSV, or Excel for analysis. #### 💳 Pricing This Actor uses pay-per-event pricing. You are charged for each successfully returned public transparency profile and for each successfully returned Ad Library creative. Unavailable, unresolved, duplicate, and otherwise unsuccessful outcomes are not charged as successful outputs. Check the Pricing tab for current event prices before starting a run. #### 🔌 Integrations Use Apify schedules for recurring checks, webhooks to react when runs finish, and the Apify API to start runs or retrieve dataset rows. Dataset exports can feed spreadsheets, databases, dashboards, and your existing automation tools. https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 #### ❓ FAQ ##### Why did a resolved Page have `transparencyAvailable: false`? Facebook resolved the Page or Profile but did not expose transparency details for it at collection time. This is different from an unresolved, inaccessible, private, restricted, removed, or login-only target, which does not produce an invented row. ##### Should I search ads by brand or Page ID? Use a brand search when you want source matches for a name. Use a numeric Page ID when you already know the advertiser Page and want to avoid name ambiguity. Each run supports one ad search configuration. ##### What is the difference between active and all ads? `active` requests creatives currently active in the selected country. `all` requests all creatives Meta makes available for that search and country, including inactive ones. ##### Does `maxAds` apply to every Page in a unified audit? No. It is the maximum number of Ad Library creatives across the run, not a separate allowance for every target. ##### Are ownership, spend, and impression values always available? No. Facebook and Meta expose different fields by Page, ad, country, and time. The Actor returns source-exposed values and omits unavailable ones instead of estimating them. ##### Do I need Facebook credentials or a Meta API key? No. The Actor accesses public data and does not require your Facebook login, cookies, or Meta API key. It cannot access private, restricted, removed, or login-only content. ##### Does this Actor collect posts, comments, reviews, or events? No. It is limited to public Page/Profile context and public Facebook and Instagram Ad Library surfaces. ### 📝 Changelog - 0.1: Initial release. ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~facebook-page-transparency-scraper/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Related Actors - [Facebook User Posts Scraper](https://apify.com/maximedupre/facebook-user-posts-scraper) — export public Page and Profile timeline posts with text, media, timestamps, and engagement. - [Facebook Reviews Scraper](https://apify.com/maximedupre/facebook-reviews-scraper) — collect public Page recommendations, reviewer details, comments, replies, and media. - [Facebook Page Video Downloader](https://apify.com/maximedupre/facebook-page-video-downloader) — export video metadata and playable URLs from known public Pages. - [Facebook Media Downloader](https://apify.com/maximedupre/facebook-media-downloader) — resolve known public Facebook video and reel URLs into direct media links. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `target` (type: `string`): Choose the public Facebook or Meta Ad Library result family to collect. Options in inactive Target sections are ignored. ## `targets` (type: `array`): Facebook Page or public Profile usernames, supported URLs, or numeric Page IDs. Mix formats in one run; duplicate targets are resolved once. Used only for the Page & Profile transparency Target. ## `brandQuery` (type: `string`): Brand name to search in the public Meta Ad Library. Enter one search per run. Used only for the Ads by brand Target. ## `pageId` (type: `string`): Numeric Facebook Page ID whose public Meta Ad Library creatives should be returned. Used only for the Ads by Page ID Target. ## `auditTargets` (type: `array`): Known Facebook Page or public Profile usernames, supported URLs, or numeric Page IDs. Each resolved target is combined with its available Ad Library creatives; duplicates are resolved once. Used only for the Unified known-target audit Target. ## `country` (type: `string`): Two-letter uppercase country code used by Meta Ad Library, such as US, GB, or DE. Applies to Ads and Unified audit Targets; ignored for Page & Profile transparency. ## `adStatus` (type: `string`): Return only currently active ads or all available ads in the selected country. Applies to Ads and Unified audit Targets. ## `maxAds` (type: `integer`): Maximum number of Ad Library creatives to return across the run. Applies to Ads and Unified audit Targets. ## Actor input object example ```json { "target": "pageTransparency", "targets": [ "facebook", "https://www.facebook.com/meta", "20531316728" ], "brandQuery": "Meta", "pageId": "20531316728", "auditTargets": [ "facebook", "20531316728" ], "country": "US", "adStatus": "active", "maxAds": 100 } ``` # Actor output Schema ## `results` (type: `string`): Open the default dataset overview of successful transparency profiles and ad creatives. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "target": "pageTransparency", "targets": [ "facebook" ] }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/facebook-page-transparency-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "target": "pageTransparency", "targets": ["facebook"], } # Run the Actor and wait for it to finish run = client.actor("maximedupre/facebook-page-transparency-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "target": "pageTransparency", "targets": [ "facebook" ] }' | apify call maximedupre/facebook-page-transparency-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/facebook-page-transparency-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Page Transparency Scraper", "description": "Export public Facebook Page/Profile transparency and Meta Ad Library creatives by brand or Page ID, with optional unified audits. No Facebook login is required.", "version": "0.1", "x-build-id": "2vUDC2ECEYQBPa0zg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~facebook-page-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-facebook-page-transparency-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/maximedupre~facebook-page-transparency-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-facebook-page-transparency-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/maximedupre~facebook-page-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-facebook-page-transparency-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": [ "target" ], "properties": { "target": { "title": "Target", "enum": [ "pageTransparency", "adsByBrand", "adsByPageId", "unifiedAudit" ], "type": "string", "description": "Choose the public Facebook or Meta Ad Library result family to collect. Options in inactive Target sections are ignored.", "default": "pageTransparency" }, "targets": { "title": "Facebook Pages or Profiles", "minItems": 1, "type": "array", "description": "Facebook Page or public Profile usernames, supported URLs, or numeric Page IDs. Mix formats in one run; duplicate targets are resolved once. Used only for the Page & Profile transparency Target.", "items": { "type": "string", "minLength": 1 }, "default": [ "facebook" ] }, "brandQuery": { "title": "Brand search", "minLength": 1, "type": "string", "description": "Brand name to search in the public Meta Ad Library. Enter one search per run. Used only for the Ads by brand Target." }, "pageId": { "title": "Facebook Page ID", "pattern": "^[0-9]+$", "minLength": 1, "type": "string", "description": "Numeric Facebook Page ID whose public Meta Ad Library creatives should be returned. Used only for the Ads by Page ID Target." }, "auditTargets": { "title": "Facebook Pages or Profiles", "minItems": 1, "type": "array", "description": "Known Facebook Page or public Profile usernames, supported URLs, or numeric Page IDs. Each resolved target is combined with its available Ad Library creatives; duplicates are resolved once. Used only for the Unified known-target audit Target.", "items": { "type": "string", "minLength": 1 } }, "country": { "title": "Ad country", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Two-letter uppercase country code used by Meta Ad Library, such as US, GB, or DE. Applies to Ads and Unified audit Targets; ignored for Page & Profile transparency.", "default": "US" }, "adStatus": { "title": "Ad status", "enum": [ "active", "all" ], "type": "string", "description": "Return only currently active ads or all available ads in the selected country. Applies to Ads and Unified audit Targets.", "default": "active" }, "maxAds": { "title": "Maximum ads", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of Ad Library creatives to return across the run. Applies to Ads and Unified audit Targets.", "default": 100 } } }, "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 } } } } } } } } } } ```