{ "openapi": "3.0.1", "info": { "title": "Bluesky Posts Scraper & Keyword Monitor - Likes & Reposts", "description": "For brand monitoring, social listening and research: Bluesky posts by keyword with text, author, likes, reposts, replies, links and hashtags, up to 2,000 per query. Monitoring returns only posts not returned before. A refused search is marked as refused, never as empty. No login or API key.", "version": "0.1", "x-build-id": "0flEBlVoTP6FwZ4ck" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~bluesky-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-bluesky-posts-scraper", "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/neverempty~bluesky-posts-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-bluesky-posts-scraper", "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/neverempty~bluesky-posts-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-bluesky-posts-scraper", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search Bluesky posts for, one query per line. Each query is searched separately (newest posts first) and every row says which query found it. Bluesky's own search syntax works: quotes for a phrase, #hashtag, from:handle, mentions:handle, domain:example.com. A query made only of #hashtags or such operators can only be read for its newest 100 posts (Bluesky rejects a time range for it); add a plain word to read further back. Letter case and extra spaces are ignored when two queries are compared, and a repeated query gets a free 'duplicate-query' row. If you leave this field out with monitoring off, the example query \"web scraping\" is searched; with monitoring on it is required. Up to 100 queries per run.", "items": { "type": "string" } }, "maxPostsPerQuery": { "title": "Maximum posts per query", "minimum": 1, "maximum": 2000, "type": "integer", "description": "With monitoring off, the newest posts are read 100 at a time until this many rows have been returned for a query (or Bluesky has no older posts). With monitoring on, it limits only the first run of a query; later runs return every post not returned before, up to 1,000 per query per run.", "default": 100 }, "language": { "title": "Language (optional)", "type": "string", "description": "Sent to Bluesky's search as its language filter, as a code such as en, ja, de or pt-BR; Bluesky decides which posts match. Each row keeps the language tags the post itself carries in langs. Leave empty for all languages." }, "postedAfter": { "title": "Posted on or after (optional)", "type": "string", "description": "Only posts created on or after this date (UTC), for example 2026-09-01 or 2026-09-01T12:00:00Z. Bluesky ignores dates it cannot read, so the Actor checks the value first and rejects it with a free row instead." }, "monitoringMode": { "title": "Monitoring mode: return only posts not returned before", "type": "boolean", "description": "Off = every run returns the newest posts for each query. On = the Actor remembers, per query and language, which posts it has returned and up to which time it has read. The first run returns the newest posts (up to maxPostsPerQuery) as a starting point; later runs return only posts not returned before, up to 1,000 per query per run. **In monitoring mode every query that is searched costs $0.30 per 1,000 checks, with or without new posts** (queries Bluesky refuses are free), plus the row price for each post returned. Example: 20 queries every hour = 14,400 checks a month = $4.32. A query is read only if the run's maximum total charge can pay for a check and one post. Do not put the same query in two schedules that can run at the same time.", "default": false }, "resetMonitoringState": { "title": "Forget what was returned for these queries", "type": "boolean", "description": "Clears what was remembered for the queries (and language) in this input, so the next monitoring run treats them as a first run again. Turn it off again after one run: left on in a schedule, every run starts over and returns the newest posts again.", "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 } } } } } } } } } }