{ "openapi": "3.0.1", "info": { "title": "Facebook Page Running Ads, Category, Likes [NO LOGIN] ✅", "description": "Check whether a Facebook page is running ads right now, then pull its category, likes, followers, rating, website, address and opening hours. One row per page. Optional photos, reels and events. Public pages only, no login and no cookies.", "version": "0.0", "x-build-id": "ZuXyzDQpCcpFeotlV" }, "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 (minimum 1)", "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. Minimum 1 URL. Each must be on facebook.com; anything else is rejected before any request is made.", "items": { "type": "string" } }, "getBusinessHours": { "title": "Include business hours", "type": "boolean", "description": "Include the weekly opening hours for each page (Monday through Sunday).", "default": true }, "cacheMaxAge": { "title": "Use cached results up to (1d to 30d)", "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. Leave as Always fetch live if you need real-time data such as current ad status. Allowed values: 1d, 3d, 7d, 14d, 30d, or empty for live data. 30d is the longest the source offers.", "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.", "default": false }, "maxEvents": { "title": "Max events per page (0 = all, no upper limit)", "minimum": 0, "type": "integer", "description": "Only used when Include events is on. Minimum 0, no upper limit; 0 returns every event the page lists. The source returns about 3 events per request.", "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, no upper limit)", "minimum": 0, "type": "integer", "description": "Only used when Include photos is on. Minimum 0, no upper limit; 0 returns every photo the page has. The source returns about 24 photos per request.", "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, no upper limit)", "minimum": 0, "type": "integer", "description": "Only used when Include reels is on. Minimum 0, no upper limit; 0 returns every reel the page has. The source returns 10 reels per request.", "default": 0 }, "enrichPosts": { "title": "Enrich reels (one extra request per item)", "type": "boolean", "description": "Fetch full detail for each reel: share count, accurate view count, and optionally comments and a video transcript. This makes one additional upstream request per item, on top of the row itself.", "default": false }, "maxEnrichedItems": { "title": "Max items to enrich (0 = all, no upper limit)", "minimum": 0, "type": "integer", "description": "Only used when Enrich reels is on. Caps how many reels per page get the extra request. Items past the cap are still returned, just unenriched. Minimum 0, no upper limit; 0 enriches every reel.", "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 } } } } } } } } } }