{ "openapi": "3.0.1", "info": { "title": "Bluesky Scraper", "description": "Scrape Bluesky (AT Protocol) using search posts by keyword or hashtag, fetch user timelines, look up profiles, search for accounts, and pull custom feeds. Pure HTTP, no login required, no proxy needed.", "version": "1.0", "x-build-id": "wfCDbbroHbaeZWf5n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-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/crawlerbros~bluesky-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-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/crawlerbros~bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "profile", "actorSearch", "feed", "postThread", "urlFetch", "getPosts", "follows", "followers", "getLikes", "getActorLikes", "getList", "getStarterPack", "feedGeneratorsDiscovery" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search / actorSearch)", "type": "string", "description": "Keyword, hashtag (with `#`), or full-text query. Bluesky supports its standard search operators: `from:user`, `since:YYYY-MM-DD`, `lang:en`, etc.", "default": "bluesky" }, "searchSort": { "title": "Search sort (mode=search)", "enum": [ "top", "latest" ], "type": "string", "description": "Sort order for `mode=search`. `top` ranks by engagement; `latest` ranks by recency.", "default": "top" }, "actor": { "title": "Handle or DID (mode=profile / follows / followers / getActorLikes)", "type": "string", "description": "Bluesky handle (e.g. `bsky.app`, `jay.bsky.team`) or full DID (`did:plc:...`). Used by profile / follows / followers / actorLikes modes." }, "postUri": { "title": "Post AT URI (mode=postThread / getLikes)", "type": "string", "description": "Full AT URI of the post (`at://did:plc:.../app.bsky.feed.post/`)." }, "postUris": { "title": "Post AT URIs (mode=getPosts)", "type": "array", "description": "Up to 25 AT URIs to batch-hydrate. Each must be `at://did:plc:.../app.bsky.feed.post/`.", "items": { "type": "string" } }, "postUrls": { "title": "Post URLs (mode=urlFetch)", "type": "array", "description": "Public bsky.app post URLs to expand, e.g. `https://bsky.app/profile/bsky.app/post/3kxxxx`.", "items": { "type": "string" } }, "listUri": { "title": "List AT URI (mode=getList)", "type": "string", "description": "AT URI of a Bluesky list (`at://did:plc:.../app.bsky.graph.list/`)." }, "starterPackUri": { "title": "Starter Pack AT URI (mode=getStarterPack)", "type": "string", "description": "AT URI of a Bluesky starter pack (`at://did:plc:.../app.bsky.graph.starterpack/`)." }, "feedPreset": { "title": "Feed preset (mode=feed)", "enum": [ "whats-hot", "discover", "mutuals", "bsky-team", "hot-classic", "popular-with-friends", "for-you", "news", "trending-videos", "quiet-posters" ], "type": "string", "description": "Built-in Bluesky feed preset. Overrides `feedUri` if both are set." }, "feedUri": { "title": "Custom feed AT URI (mode=feed)", "type": "string", "description": "Full AT URI of a feed generator (`at://did:plc:.../app.bsky.feed.generator/`). Use this for community feeds not in the preset list." }, "language": { "title": "Language filter", "enum": [ "", "en", "es", "pt", "ja", "de", "fr", "zh", "ko", "it", "nl", "pl", "ru", "tr", "ar", "hi", "sv", "cs", "fi", "no", "da", "el", "he", "hu", "id", "ro", "sk", "sl", "th", "uk", "vi" ], "type": "string", "description": "ISO 639-1 language code. Drops posts not in this language. Empty = no filter." }, "excludeReplies": { "title": "Exclude replies", "type": "boolean", "description": "Drop posts that are replies to another post.", "default": false }, "excludeReposts": { "title": "Exclude reposts", "type": "boolean", "description": "Drop posts that are reposts of someone else's post.", "default": false }, "mediaOnly": { "title": "Media only", "type": "boolean", "description": "Only emit posts that have at least one image / video / external embed.", "default": false }, "minLikes": { "title": "Min likes", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop posts with fewer than this many likes." }, "minReposts": { "title": "Min reposts", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop posts with fewer than this many reposts." }, "since": { "title": "Since (mode=search)", "type": "string", "description": "Earliest post date as `YYYY-MM-DD`. Bluesky search recency-weights its index; use the explicit `since:` filter for strict date bounds." }, "until": { "title": "Until (mode=search)", "type": "string", "description": "Latest post date as `YYYY-MM-DD`." }, "fromUser": { "title": "From user (mode=search)", "type": "string", "description": "Restrict search to posts authored by this handle (or DID)." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on emitted records.", "default": 40 } } }, "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 } } } } } } } } } }