{ "openapi": "3.0.1", "info": { "title": "📘 Facebook Pages Scraper - Details, Ratings & Ad Status", "description": "Scrape Facebook pages for website, address, business hours, ratings, follower counts and whether the page is running ads right now. Bulk export. No login.", "version": "0.0", "x-build-id": "6zBoql4YGgNBLFvZH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~fb-pages/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-fb-pages", "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/unseenuser~fb-pages/runs": { "post": { "operationId": "runs-sync-unseenuser-fb-pages", "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/unseenuser~fb-pages/run-sync": { "post": { "operationId": "run-sync-unseenuser-fb-pages", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Facebook page URLs", "minItems": 1, "uniqueItems": true, "type": "array", "description": "One or more public Facebook page URLs, one per line. Use the full page URL, for example https://www.facebook.com/mantraindianfolsom. Click Bulk edit to paste a large list at once.", "items": { "type": "string" } }, "getBusinessHours": { "title": "Include business hours", "type": "boolean", "description": "Include the weekly opening hours for each page (Monday through Sunday). No extra cost.", "default": true }, "cacheMaxAge": { "title": "Use cached results up to", "enum": [ "", "1d", "3d", "7d", "14d", "30d" ], "type": "string", "description": "Reuse a recent cached result for page details instead of scraping fresh. A cache hit is faster and the row is marked with cached: true and cached_at. Leave as Always fetch live if you need real-time data such as current ad status.", "default": "" }, "includeGatedProfile": { "title": "Include gated and age-restricted pages", "type": "boolean", "description": "When a page is age-restricted or private, still return the limited public fields Facebook exposes (id, name, category, likeCount, profile picture, links) instead of an empty result. Has no effect on normal public pages.", "default": false }, "includeEvents": { "title": "Include events", "type": "boolean", "description": "Also return the page's public events. Each event is emitted as its own row in the dataset and is billed as one result.", "default": false }, "maxEvents": { "title": "Max events per page (0 = all)", "minimum": 0, "type": "integer", "description": "Only used when Include events is on. Events paginate about 3 per upstream call, so a page with many events costs several calls.", "default": 0 }, "includePhotos": { "title": "Include photos", "type": "boolean", "description": "Also return the page's photos with Facebook's native captions (alt-text).", "default": false }, "maxPhotos": { "title": "Max photos per page (0 = all)", "minimum": 0, "type": "integer", "description": "Only used when Include photos is on. At 0 there is no cap and you accept the full bill for however many photos the page has. Photos arrive about 24 per upstream call, so a cap below 24 still costs one full call - but you are billed per row, so it still costs you less than a higher cap.", "default": 0 }, "includeReels": { "title": "Include reels", "type": "boolean", "description": "Also return the page's recent reels.", "default": false }, "maxReels": { "title": "Max reels per page (0 = all)", "minimum": 0, "type": "integer", "description": "Only used when Include reels is on. At 0 there is no cap and you accept the full bill for however many reels the page has. Reels arrive about 10 per upstream call, so a cap below 10 still costs one full call - but you are billed per row, so it still costs you less than a higher cap.", "default": 0 }, "enrichPosts": { "title": "Enrich reels (extra cost per item)", "type": "boolean", "description": "Fetch full detail for each reel: share count, accurate view count, and optionally comments and a video transcript. This costs ONE extra upstream call per item on top of the row itself, so it is the most expensive option here. Use Max items to enrich to bound it.", "default": false }, "maxEnrichedItems": { "title": "Max items to enrich (0 = all)", "minimum": 0, "type": "integer", "description": "Only used when Enrich reels is on. Caps how many reels per page get the extra call. Items past the cap are still returned, just unenriched. 0 means enrich every reel, which is the most expensive setting in this Actor.", "default": 10 }, "getComments": { "title": "Include comments on enriched items", "type": "boolean", "description": "Only used when Enrich reels is on. Returns the comment thread for each enriched reel.", "default": false }, "getTranscript": { "title": "Include video transcript on enriched items", "type": "boolean", "description": "Only used when Enrich reels is on. Returns a text transcript of each enriched reel's video.", "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 }, "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 } } } } } } } } } }