{ "openapi": "3.0.1", "info": { "title": "Facebook Content Search Extractor", "description": "Search Facebook by keyword and extract public videos, reels, posts, pages, groups, people and events. Get views, reactions by type, comments, shares, publisher, followers, hashtags and links as clean JSON. Bulk keywords, live results, no account or cookies needed.", "version": "1.0", "x-build-id": "Hsb3IxoJneG2yuWYN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawl_craft~facebook-content-search-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawl_craft-facebook-content-search-extractor", "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/crawl_craft~facebook-content-search-extractor/runs": { "post": { "operationId": "runs-sync-crawl_craft-facebook-content-search-extractor", "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/crawl_craft~facebook-content-search-extractor/run-sync": { "post": { "operationId": "run-sync-crawl_craft-facebook-content-search-extractor", "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": [ "urls" ], "properties": { "urls": { "title": "🔍 Keywords or search links", "type": "array", "description": "One keyword or Facebook search link per line, e.g. coffee shop or https://www.facebook.com/search/videos/?q=coffee. Bulk input is supported; add as many as you need. A link that names a section (videos, pages, groups, people, events, posts) uses that section for that line.", "items": { "type": "string" } }, "searchType": { "title": "🎞️ Content type", "enum": [ "posts", "pages", "groups", "people", "events", "videos" ], "type": "string", "description": "What to look for. Videos include reels and come with the most data (views, reactions, comments, shares). The other types return public posts, pages, groups, people or events.", "default": "posts" }, "location": { "title": "📍 Place", "type": "string", "description": "Optional place name added to every search, e.g. Dhaka. Leave empty to search everywhere." }, "maxItems": { "title": "📊 Maximum results", "minimum": 0, "type": "integer", "description": "Total number of results to collect across all keywords. Use 0 for as many as are available.", "default": 10 }, "sort": { "title": "🕒 Sort order", "enum": [ "relevance", "recent" ], "type": "string", "description": "Relevance keeps the order of the search. Recent favours newer content and lists the newest first within each batch.", "default": "relevance" }, "dateFrom": { "title": "📅 From date", "type": "string", "description": "Only keep results published on or after this date (UTC). Pick a calendar date, or switch to relative and enter a period such as 7 days, 2 weeks or 3 months back from today. Applies to posts and videos. Leave empty for no start date." }, "dateTo": { "title": "⏰ To date", "type": "string", "description": "Only keep results published on or before this date (UTC). Pick a calendar date, or switch to relative and enter a period such as 1 week back from today. Leave empty for no end date." }, "excludeTerms": { "title": "🚫 Excluded words", "type": "array", "description": "Drop results that mention any of these words, e.g. giveaway or sale. Leave empty to keep everything.", "items": { "type": "string" } }, "includeDetails": { "title": "🔬 Add page details", "type": "boolean", "description": "Open each result's public page to add followers, likes, views, reactions, category and phone where available. Slower, but richer for pages, groups, people and events.", "default": false }, "proxyConfiguration": { "title": "🛰 Proxy", "type": "object", "description": "Choose how the Actor connects. The default works for most runs.", "default": { "useApifyProxy": 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 } } } } } } } } } }