{ "openapi": "3.0.1", "info": { "title": "Bluesky Scraper - Posts, Profiles, Threads, Followers", "description": "Scrape Bluesky (bsky.app) without login: keyword post search (latest/top, date, language, author, hashtag, domain filters), author feeds with engagement counts and media, profiles, full reply threads, followers, follows and people search. Pure HTTP via the public AT Protocol API.", "version": "1.0", "x-build-id": "NgjmiJo0bbBsEdddk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thirdwatch~bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thirdwatch-bluesky-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/thirdwatch~bluesky-scraper/runs": { "post": { "operationId": "runs-sync-thirdwatch-bluesky-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/thirdwatch~bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-thirdwatch-bluesky-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": [ "auto", "searchPosts", "authorFeed", "profile", "thread", "followers", "follows", "searchActors" ], "type": "string", "description": "What to scrape. 'auto' picks the mode from the inputs you filled in: post URLs -> thread, handles -> authorFeed, keywords -> searchPosts (needs identifier + appPassword). Set it explicitly to use handles for profile / followers / follows, or keywords for searchActors (people search, no login).", "default": "auto" }, "queries": { "title": "Search keywords", "maxItems": 200, "type": "array", "description": "Keywords or phrases for post search (mode searchPosts) or people search (mode searchActors). NOTE: Bluesky disabled post search for logged-out clients, so searchPosts needs your own 'identifier' + 'appPassword' below; searchActors stays public. Inline operators work: \"from:handle\", \"mentions:handle\", \"lang:en\", \"since:2026-01-01\", \"#hashtag\", \"domain:example.com\".", "items": { "type": "string", "minLength": 1, "maxLength": 300 } }, "handles": { "title": "Handles, DIDs or profile URLs", "maxItems": 500, "type": "array", "description": "Bluesky accounts for authorFeed / profile / followers / follows modes. Accepts a handle (bsky.app, jay.bsky.team), a DID (did:plc:...), an @handle, or a profile URL (https://bsky.app/profile/bsky.app).", "items": { "type": "string", "minLength": 1, "maxLength": 300 } }, "postUrls": { "title": "Post URLs or at:// URIs", "maxItems": 500, "type": "array", "description": "Posts whose reply threads you want. Accepts https://bsky.app/profile/{handle}/post/{id} URLs or at://did:plc:.../app.bsky.feed.post/... URIs. Also accepted here: profile, followers, follows, hashtag and search URLs from bsky.app - each is routed to the matching mode.", "items": { "type": "string", "minLength": 1, "maxLength": 500 } }, "maxItems": { "title": "Max items per query / handle / post", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit of records collected for each keyword, handle or post URL. Profile mode always returns one record per handle.", "default": 100 }, "sort": { "title": "Post search sort", "enum": [ "latest", "top" ], "type": "string", "description": "searchPosts only. 'latest' = newest first (chronological). 'top' = ranked by engagement.", "default": "latest" }, "since": { "title": "Posted after (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$", "maxLength": 40, "type": "string", "description": "searchPosts only. Only posts created on/after this date. YYYY-MM-DD or full ISO 8601 (2026-01-15T00:00:00Z)." }, "until": { "title": "Posted before (date)", "pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$", "maxLength": 40, "type": "string", "description": "searchPosts only. Only posts created before this date. YYYY-MM-DD or full ISO 8601." }, "language": { "title": "Language", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$", "maxLength": 20, "type": "string", "description": "searchPosts only. BCP-47 language code such as en, es, pt, ja, de. Leave empty for all languages." }, "author": { "title": "Only posts from author", "maxLength": 300, "type": "string", "description": "searchPosts only. Restrict results to one account (handle or DID). Use \"me\" is not supported - this actor is unauthenticated." }, "mentions": { "title": "Only posts mentioning", "maxLength": 300, "type": "string", "description": "searchPosts only. Restrict results to posts that mention this account (handle or DID)." }, "hashtag": { "title": "Hashtag", "maxLength": 100, "type": "string", "description": "searchPosts only. Restrict results to posts carrying this hashtag (with or without #)." }, "domain": { "title": "Linked domain", "maxLength": 253, "type": "string", "description": "searchPosts only. Restrict results to posts linking to this domain, e.g. github.com." }, "identifier": { "title": "Bluesky identifier (for searchPosts only)", "maxLength": 300, "type": "string", "description": "Your Bluesky handle or email. Only needed for searchPosts: Bluesky blocks post search for logged-out clients. All other modes run without login. Use an app password, never your main password." }, "appPassword": { "title": "Bluesky app password (for searchPosts only)", "type": "string", "description": "An app password created at bsky.app -> Settings -> Privacy and security -> App passwords. Stored encrypted by Apify, used only to open a session for searchPosts." }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "authorFeed only. Include the account's replies to other people. Default off = original posts (and reposts) only.", "default": false }, "includeReposts": { "title": "Include reposts", "type": "boolean", "description": "authorFeed only. Include posts the account reposted (marked is_repost = true with reposted_by). Default on.", "default": true }, "threadDepth": { "title": "Thread depth", "minimum": 1, "maximum": 100, "type": "integer", "description": "thread only. How many reply levels below the post to collect (1 = direct replies only).", "default": 6 }, "minLikes": { "title": "Min likes", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop posts/replies with fewer likes than this (applied locally after fetching).", "default": 0 }, "minReposts": { "title": "Min reposts", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop posts/replies with fewer reposts than this (applied locally).", "default": 0 }, "minReplies": { "title": "Min replies", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop posts/replies with fewer replies than this (applied locally).", "default": 0 } } }, "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 } } } } } } } } } }