{ "openapi": "3.0.1", "info": { "title": "Bluesky Social Scraper", "description": "Profiles, posts, followers, follows, user search and full reply threads from Bluesky, via the public AT Protocol AppView API. No login, no API key, cursor pagination followed to the end.", "version": "0.1", "x-build-id": "b5DH0Uv3v4ziQwGL3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~bluesky-social-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-bluesky-social-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/scrapyx~bluesky-social-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-bluesky-social-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/scrapyx~bluesky-social-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-bluesky-social-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": { "mode": { "title": "Mode", "enum": [ "profiles", "authorFeed", "followers", "follows", "searchActors", "thread" ], "type": "string", "description": "Which kind of data to fetch. 'profiles', 'authorFeed', 'followers' and 'follows' read the 'Actors' field; 'searchActors' reads 'Search query'; 'thread' reads 'Post URIs or URLs'. Post search is deliberately not offered: Bluesky's public API refuses it for unauthenticated callers (verified from three continents), so it would fail every time.", "default": "profiles" }, "actors": { "title": "Actors (handles, DIDs or profile URLs)", "type": "array", "description": "Accounts to fetch. Accepts a handle (alice.bsky.social, with or without a leading @), a DID (did:plc:...), or a bsky.app profile URL copied from the browser. Used by the 'profiles', 'authorFeed', 'followers' and 'follows' modes.", "default": [ "bsky.app" ], "items": { "type": "string" } }, "query": { "title": "Search query", "type": "string", "description": "Search terms, used by the 'searchActors' mode. A query with no matches returns an empty result honestly rather than falling back to unfiltered results." }, "postUris": { "title": "Post URIs or URLs", "type": "array", "description": "Used by the 'thread' mode. Accepts an at:// URI (at://did:plc:.../app.bsky.feed.post/) or a bsky.app post URL. When a URL carries a handle rather than a DID, the DID is resolved automatically first.", "default": [], "items": { "type": "string" } }, "pageLimit": { "title": "Rows per request", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many rows to ask for per API call. Upstream's ceiling is 100 (bisected: 101 returns HTTP 400 'integer too big', 0 returns 'integer too small'), so leaving this at 100 makes the fewest requests for the same data.", "default": 100 }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Optional cap on total data rows across the whole run, shared across every actor or query in the input. Leave empty to follow pagination to the end. Note some accounts have millions of followers — a cap is strongly recommended for the 'followers' mode." }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many requests may be in flight at once. Cursor pagination within a single actor is inherently sequential, so this only speeds up runs that list several actors.", "default": 4 }, "minRequestInterval": { "title": "Minimum interval between requests (seconds)", "minimum": 0.05, "maximum": 10, "type": "number", "description": "The honest speed control: the shortest gap between two request starts. The API is public and unauthenticated; this is routine politeness pacing rather than a defensive measure.", "default": 0.25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential with no country pin is the cloud default. No WAF was observed on any method this actor uses (4/4 TLS profiles identical), so the proxy is routine hygiene rather than a bypass.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }