{ "openapi": "3.0.1", "info": { "title": "Bluesky Brand Monitor — New Mentions, Keyword & Account Alerts", "description": "Monitor Bluesky for NEW brand mentions, keywords and account posts. Outputs only what's new since the last run, keeps state between runs, and can alert your webhook (Slack, Discord, Zapier, n8n). Run it on a schedule for 24/7 social listening.", "version": "0.1", "x-build-id": "VYEpWfNaYVgH2J9mn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/prometheusagency~bluesky-brand-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-prometheusagency-bluesky-brand-monitor", "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/prometheusagency~bluesky-brand-monitor/runs": { "post": { "operationId": "runs-sync-prometheusagency-bluesky-brand-monitor", "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/prometheusagency~bluesky-brand-monitor/run-sync": { "post": { "operationId": "run-sync-prometheusagency-bluesky-brand-monitor", "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": { "keywords": { "title": "Brand keywords to monitor", "type": "array", "description": "Brand names, product names or phrases. Requires a free Bluesky app password (fields below). Leave empty to monitor accounts only.", "items": { "type": "string" } }, "accounts": { "title": "Accounts to monitor", "type": "array", "description": "Bluesky handles whose new posts you want to track (competitors, influencers, your own). Works WITHOUT any login.", "items": { "type": "string" } }, "maxPostsPerSource": { "title": "Max posts checked per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent posts to check per keyword/account each run. Only NEW ones are output.", "default": 100 }, "language": { "title": "Language filter (keywords)", "type": "string", "description": "Two-letter language code for keyword search, e.g. en, es." }, "blueskyIdentifier": { "title": "Bluesky handle (only for keywords)", "type": "string", "description": "Your Bluesky handle, e.g. yourname.bsky.social. Only needed when monitoring keywords." }, "blueskyAppPassword": { "title": "Bluesky app password (only for keywords)", "type": "string", "description": "App password from bsky.app → Settings → Privacy and Security → App Passwords. NEVER your real password." }, "webhookUrl": { "title": "Alert webhook URL (optional)", "type": "string", "description": "If set, a JSON summary of new mentions is POSTed here (works with Slack, Discord, Zapier, Make, n8n)." }, "firstRunBaselineOnly": { "title": "First run = baseline only (no output)", "type": "boolean", "description": "If enabled, the first run just records the current state and outputs nothing; alerts start from the second run. Recommended for scheduled monitoring.", "default": false }, "requestDelayMs": { "title": "Delay between API calls (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between API requests.", "default": 200 } } }, "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 } } } } } } } } } }