# 🦋 Bluesky Scraper (`farsighted_rosemary/bluesky-scraper`) Actor Pull Bluesky profiles, posts, followers, and following lists. No login, no API key, no headless browser. - **URL**: https://apify.com/farsighted\_rosemary/bluesky-scraper.md - **Developed by:** [Matthias Lechner](https://apify.com/farsighted_rosemary) (community) - **Categories:** Social media, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.20 / 1,000 scraped results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🦋 Bluesky Scraper Pull Bluesky profiles, posts, followers, and following lists. No login, no API key, no headless browser. Bluesky has a public REST API. We just call it. ### Why this exists Bluesky is growing fast. 34 million accounts and counting. If you're doing research, tracking accounts, or building a dataset, you could write your own AT Protocol client. Or you could use this and be done in 10 seconds. Unlike browser-based scrapers that break when Bluesky changes their layout, this actor talks directly to Bluesky's own API. It's faster, cheaper, and won't suddenly stop working because someone tweaked a CSS class. ### What you can do | Mode | What it gives you | |---|---| | **Profile** | Handle, display name, bio, avatar, banner, follower count, post count, join date | | **Posts** | Full post text, engagement counts (likes, reposts, replies), timestamps, image/link detection | | **Search** | Find profiles by keyword | | **Followers** | Who follows a given account (paginated) | | **Following** | Who a given account follows (paginated) | ### Quick start 1. Pick a mode from the dropdown 2. Enter a Bluesky handle (like `bsky.app` or `jay.bsky.team`) 3. Set how many results you want 4. Hit run That's it. Data comes back as JSON. Download as CSV, Excel, JSON, or query via the API. ### Input - **What do you want?** Pick from profile, posts, search, followers, or following. - **Bluesky handle** The handle you're curious about. - **Search term** What to search for. Only used in Search mode. - **How many results?** Rough ceiling, 1 to 10,000. ### Output All modes return structured JSON with consistent field names. Profile data includes `handle`, `displayName`, `description`, `followersCount`, `followsCount`, `postsCount`, `avatar`, `banner`, `createdAt`. Posts include `text`, `createdAt`, `likeCount`, `repostCount`, `replyCount`, and flags for embedded images or links. ### Pricing Pay per result. Bluesky's API is free and public, so our costs are near zero. Which means your costs are too. Exact pricing is on the actor page. ### How it works under the hood Bluesky runs on the AT Protocol, which has a public REST API at `public.api.bsky.app`. No authentication needed for public data. This actor is a thin wrapper that: 1. Takes your input 2. Calls the right AT Protocol endpoint 3. Paginates through results 4. Pushes everything into Apify's dataset Zero browser overhead. Zero proxy costs. Just HTTP requests to Bluesky's CDN. ### Limits The AT Protocol rate-limits at roughly 3,000 requests per 5 minutes. For most jobs this is never an issue. If you need millions of profiles, split your run across multiple tasks or lower the pace. # Actor input Schema ## `mode` (type: `string`): Pick a Bluesky handle and choose what to pull from it. ## `handle` (type: `string`): The handle you're curious about. Like 'bsky.app' or 'jay.bsky.team'. ## `searchQuery` (type: `string`): What to search for. Only used in Search mode. ## `maxResults` (type: `integer`): Rough ceiling on results. 1 to 10,000. ## Actor input object example ```json { "mode": "profile", "handle": "bsky.app", "searchQuery": "", "maxResults": 100 } ```` # Actor output Schema ## `dataset` (type: `string`): All scraped Bluesky data as structured JSON. Download as CSV, Excel, JSON, or query via the API. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("farsighted_rosemary/bluesky-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("farsighted_rosemary/bluesky-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call farsighted_rosemary/bluesky-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=farsighted_rosemary/bluesky-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🦋 Bluesky Scraper", "description": "Pull Bluesky profiles, posts, followers, and following lists. No login, no API key, no headless browser.", "version": "1.0", "x-build-id": "IiDMidylfMlD6xaSe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/farsighted_rosemary~bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-farsighted_rosemary-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/farsighted_rosemary~bluesky-scraper/runs": { "post": { "operationId": "runs-sync-farsighted_rosemary-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/farsighted_rosemary~bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-farsighted_rosemary-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": "What do you want?", "enum": [ "profile", "profile_posts", "search_profiles", "followers", "following" ], "type": "string", "description": "Pick a Bluesky handle and choose what to pull from it.", "default": "profile" }, "handle": { "title": "Bluesky handle", "type": "string", "description": "The handle you're curious about. Like 'bsky.app' or 'jay.bsky.team'.", "default": "bsky.app" }, "searchQuery": { "title": "Search term", "type": "string", "description": "What to search for. Only used in Search mode.", "default": "" }, "maxResults": { "title": "How many results?", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Rough ceiling on results. 1 to 10,000.", "default": 100 } } }, "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 } } } } } } } } } } ```