{ "openapi": "3.0.1", "info": { "title": "Meta Content / Social-Listening Intel - Facebook + Instagram", "description": "Public-post social listening across Facebook + Instagram: search by keyword/hashtag/page; capture post text, engagement, and timestamps; get topic volume, sentiment, themes, and share-of-voice. The commercial alternative to Meta Content Library (academic-only). For brands, PR, and agencies.", "version": "0.1", "x-build-id": "jxZK34QVLBqbzKweV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seibs.co~meta-content-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seibs.co-meta-content-intel", "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/seibs.co~meta-content-intel/runs": { "post": { "operationId": "runs-sync-seibs.co-meta-content-intel", "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/seibs.co~meta-content-intel/run-sync": { "post": { "operationId": "run-sync-seibs.co-meta-content-intel", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "keyword_listening", "page_posts", "hashtag_intel" ], "type": "string", "description": "keyword_listening = search public posts by keyword/topic across platforms, then aggregate (volume, sentiment, top posts/pages, share-of-voice). page_posts = pull recent public posts for given Facebook Pages / public Instagram profiles. hashtag_intel = public hashtag feeds + topic intel.", "default": "keyword_listening" }, "keywords": { "title": "Keywords / topics (keyword_listening mode)", "maxItems": 25, "type": "array", "description": "Topics/terms to listen for, e.g. ['climate change', 'your brand']. Used in keyword_listening mode. Note: Facebook and Instagram have no logged-out keyword post-search, so a keyword is matched against its hashtag feed. Hard cap of 25.", "default": [], "items": { "type": "string" } }, "pages": { "title": "Pages / profiles (page_posts mode)", "maxItems": 50, "type": "array", "description": "Facebook Page names/slugs or public Instagram handles to pull recent public posts for, e.g. ['natgeo', 'nike', 'patagonia']. Used in page_posts mode. Hard cap of 50.", "default": [], "items": { "type": "string" } }, "hashtags": { "title": "Hashtags (hashtag_intel mode)", "maxItems": 25, "type": "array", "description": "Hashtags (without the #) to pull public feeds for, e.g. ['sustainability', 'running']. Used in hashtag_intel mode. Hard cap of 25.", "default": [], "items": { "type": "string" } }, "platforms": { "title": "Platforms", "maxItems": 2, "uniqueItems": true, "type": "array", "description": "Which Meta surfaces to listen to: facebook (public Pages + hashtags), instagram (public profiles + hashtags). Aliases like 'fb', 'ig', 'meta' are accepted. Leave empty for both. Pass ['all'] for both.", "items": { "type": "string", "enum": [ "facebook", "instagram" ] }, "default": [ "facebook", "instagram" ] }, "all_platforms": { "title": "Query all platforms", "type": "boolean", "description": "Shortcut to query Facebook + Instagram (overrides the platforms list).", "default": false }, "country": { "title": "Country / region", "type": "string", "description": "Two-letter region code used as a soft locale hint where the surface honors it (e.g. US, GB, DE). Default US.", "default": "US" }, "include_listening_analysis": { "title": "Listening analysis (sentiment + theme tagging)", "type": "boolean", "description": "Tag each post's sentiment (positive / negative / neutral, lexicon-based), theme (praise / complaint / question / recommendation / news / promotion), hashtags, and emoji/word count. Adds a listening_analysis PPE charge per tagged post. This is the social-listening corpus signal.", "default": true }, "include_topic_rollup": { "title": "Topic rollups + share-of-voice", "type": "boolean", "description": "Build per-topic aggregations: post volume over time, sentiment split, top posts, top pages, top hashtags, plus the cross-topic share-of-voice table. Adds a topic_rollup PPE charge per topic. Defaults on for keyword_listening and hashtag_intel.", "default": true }, "pii_minimization": { "title": "PII minimization (redact personal individuals)", "type": "boolean", "description": "When on (default), posts authored by an apparent personal individual (not a Page / business / verified account) have the author name dropped and the handle replaced with a stable opaque token, and the author id is stripped. Pages/business/verified accounts are retained. Keeps the dataset about public discourse on a topic, not a profile of private individuals. Turn off only with a lawful basis.", "default": true }, "max_results_per_platform": { "title": "Max posts per platform per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on posts returned per platform per keyword/page/hashtag. Default 30.", "default": 30 }, "monitor_webhook_url": { "title": "Monitor webhook URL (Slack / email, optional)", "type": "string", "description": "When this actor runs under an Apify Schedule (monitor mode), post the change digest (new posts, volume/sentiment shift) to this Slack-compatible webhook URL.", "default": "" }, "use_apify_proxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Route requests through Apify Proxy. DATACENTER handles the first (httpx) pass; a RESIDENTIAL tier is provisioned for the anti-bot escalation legs (Meta's public surfaces usually need residential to clear logged-out).", "default": true }, "use_browser_fallback": { "title": "Anti-bot escalation (curl_cffi + browser)", "type": "boolean", "description": "When a surface serves an anti-bot / login wall (Facebook and Instagram heavily gate logged-out automated clients), automatically escalate: switch to the RESIDENTIAL proxy and retry with curl_cffi Chrome TLS impersonation, then a stealth browser that replays the page's own JSON XHR. Turn off to use plain httpx only (Meta then returns documented platform_pending notes).", "default": true }, "browser_cdp_url": { "title": "Warm browser CDP endpoint (for login-walled surfaces)", "type": "string", "description": "Optional. CDP/WebSocket endpoint of an already-running, anti-detect (UC-mode / real Chrome) browser. When set, the browser tier connects to it (inheriting its session + fingerprint) so it clears Meta's edge more reliably. Without it a stealth headless Chromium is launched (works on the apify/actor-python-playwright image; weaker against managed challenges). Can also be set as the BROWSER_CDP_URL env var.", "default": "" }, "apify_proxy_groups": { "title": "Proxy groups (optional override)", "type": "array", "description": "Override the auto-selected proxy group. Leave empty to let the actor pick DATACENTER for the first pass and RESIDENTIAL for escalation.", "default": [], "items": { "type": "string" } }, "concurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Parallel surface fetches. Meta's surfaces are rate-sensitive; default 4.", "default": 4 } } }, "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 } } } } } } } } } }