{ "openapi": "3.0.1", "info": { "title": "Bluesky Scraper", "description": "crapes Bluesky data via the AT Protocol, including author feeds, profiles, posts, threads, followers, following, hashtags, and search results. Supports authenticated search using an app password and outputs structured data with author details, post text, engagement metrics, timestamps, URLs.", "version": "0.0", "x-build-id": "iooXyhEpPcclwzpBW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-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/moving_beacon-owner1~bluesky-scraper/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-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/moving_beacon-owner1~bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-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": { "actors": { "title": "Actors (handles or DIDs)", "type": "array", "description": "Handles like 'bsky.app' — each one's posts (and profile) are scraped.", "items": { "type": "string" } }, "includeProfiles": { "title": "Include profile records", "type": "boolean", "description": "Also push a profile row for each actor.", "default": true }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Full-text post search. Requires identifier + appPassword (searchPosts is auth-gated).", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtag search (with or without #). Requires identifier + appPassword.", "items": { "type": "string" } }, "postUris": { "title": "Post URIs (threads)", "type": "array", "description": "at:// URIs — scrapes each post's thread (root + replies).", "items": { "type": "string" } }, "followersOf": { "title": "Followers of", "type": "array", "description": "Handles whose followers to collect.", "items": { "type": "string" } }, "followsOf": { "title": "Follows of", "type": "array", "description": "Handles whose following list to collect.", "items": { "type": "string" } }, "maxPostsPerActor": { "title": "Max posts per actor/query", "minimum": 1, "type": "integer", "description": "Max posts to pull per actor feed / search query / hashtag.", "default": 50 }, "maxGraphPerActor": { "title": "Max followers/follows per actor", "minimum": 1, "type": "integer", "description": "Max followers or follows to pull per handle.", "default": 100 }, "maxItems": { "title": "Max total records", "minimum": 1, "type": "integer", "description": "Hard cap on total records pushed to the dataset across all modes.", "default": 5000 }, "identifier": { "title": "Bluesky handle (for search auth)", "type": "string", "description": "Your handle, e.g. you.bsky.social. Only needed for searchQueries/hashtags." }, "appPassword": { "title": "Bluesky APP password (for search auth)", "type": "string", "description": "Create at Settings -> App Passwords. NOT your main password. Only needed for search." }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Off by default — Bluesky's API is open and rarely needs a proxy." } } }, "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 } } } } } } } } } }