{ "openapi": "3.0.1", "info": { "title": "Facebook Poster", "description": "Automate posting to Facebook Business Pages! Supports text posts, images, and link shares.\n\nFeatures:\n- Text Posts - Simple status updates\n- Image Posts - Photos with captions\n- Link Shares - Share URLs with custom text\n- Page Selection - Choose which page to post to", "version": "1.1", "x-build-id": "T4SOU6beVrx2v40z6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~facebook-poster/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-facebook-poster", "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/alizarin_refrigerator-owner~facebook-poster/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-facebook-poster", "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/alizarin_refrigerator-owner~facebook-poster/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-facebook-poster", "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", "properties": { "email": { "title": "Facebook Email", "type": "string", "description": "Email for Facebook login (not needed if using cookies)" }, "password": { "title": "Facebook Password", "type": "string", "description": "Password for Facebook login (not needed if using cookies)" }, "cookies": { "title": "Browser Cookies", "type": "string", "description": "JSON array of cookies from logged-in browser session. Recommended for 2FA accounts." }, "pageUrl": { "title": "Facebook Page URL", "type": "string", "description": "Full URL of the Facebook page to post to (e.g., https://facebook.com/yourbusiness)" }, "message": { "title": "Post Message", "type": "string", "description": "Text content of the post" }, "imageUrls": { "title": "Image URLs", "type": "array", "description": "URLs of images to attach to the post", "items": { "type": "string" } }, "linkUrl": { "title": "Link URL", "type": "string", "description": "URL to share in the post" }, "timeout": { "title": "Timeout (seconds)", "minimum": 30, "maximum": 300, "type": "integer", "description": "Maximum time to wait for operations", "default": 120 }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run in demo mode without real credentials. Returns mock success response for testing.", "default": true }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to receive a POST request when the actor run finishes. Useful for integrations with Zapier, Make, n8n, or custom automation workflows." }, "indexNowKey": { "title": "IndexNow API Key", "type": "string", "description": "Optional IndexNow API key for instant search engine indexing of posted content. Get your key at https://www.bing.com/indexnow" }, "utmTracking": { "title": "UTM Tracking", "type": "object", "description": "Enable UTM tracking parameters on link URLs for analytics. Default: { enabled: true } - will auto-add utm_source=facebook, utm_medium=social, utm_campaign=facebook_post_YYYYMMDD", "default": { "enabled": true } }, "cookieStorageKey": { "title": "Cookie Manager Storage Key", "type": "string", "description": "Key in the KV store to load cookies from (created by Cookie Manager actor). If provided and no manual cookies are set, cookies will be loaded automatically from the KV store." }, "cookieKvStoreName": { "title": "Cookie KV Store Name", "type": "string", "description": "Name of the Apify Key-Value store holding cookie sessions. Default: 'cookie-sessions'", "default": "cookie-sessions" } } }, "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 } } } } } } } } } }