# Bluesky Scraper — Posts, Profiles, Followers & Threads (`samwise.agency/bluesky-scraper`) Actor Scrape Bluesky profiles, author feeds, follower/following lists, and full reply threads — no login needed. Optional keyword search with your own app password. Clean JSON/CSV via the official AT Protocol API. - **URL**: https://apify.com/samwise.agency/bluesky-scraper.md - **Developed by:** [samwise.agency](https://apify.com/samwise.agency) (community) - **Categories:** Lead generation, Social media, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 — Posts, Profiles, Followers & Threads Scrape **Bluesky** (bsky.app) without login or API keys. This Actor uses the official public AT Protocol API, so it's fast, reliable, and doesn't break when the website changes. **What you can extract:** - 📝 **Author feeds** — all recent posts from any account (no login) - 👤 **Full profiles** — follower/following/post counts, bio, avatar (no login) - 👥 **Follower & following lists** — export audiences as profile rows (no login) - 💬 **Full reply threads** — paste a post URL, get the whole conversation (no login) - 🔍 **Posts by keyword** — brand mentions, topics, hashtags (needs your own free Bluesky app password — Bluesky requires login for search since 2026) ### Quick start 1. Click **Run** — the default input fetches recent posts from the official @bsky.app account 2. Swap in the handles you care about, or add follower exports and threads 3. For keyword search: create an app password at bsky.app → Settings → Privacy and Security → App Passwords, and enter your handle + app password in the input (never your main password; revoke anytime) 4. Download results as JSON, CSV, or Excel from the **Dataset** tab ### Sample output (post) ```json { "type": "post", "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l", "url": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l", "text": "Welcome to Bluesky!", "createdAt": "2026-07-01T12:34:56.000Z", "author": { "did": "did:plc:z72i7hdynmk6r22z27h6tvur", "handle": "bsky.app", "displayName": "Bluesky" }, "replyCount": 421, "repostCount": 1523, "likeCount": 9210, "quoteCount": 87, "images": [], "externalLink": null, "matchedQuery": "bluesky" } ```` ### Sample output (profile / follower row) ```json { "type": "profile", "did": "did:plc:z72i7hdynmk6r22z27h6tvur", "handle": "bsky.app", "url": "https://bsky.app/profile/bsky.app", "displayName": "Bluesky", "description": "official Bluesky account", "followersCount": 34171405, "followsCount": 11, "postsCount": 802, "createdAt": "2023-04-12T04:53:57.057Z" } ``` ### Use cases - **Brand & reputation monitoring** — track mentions as X/Twitter audiences migrate - **Influencer research** — profile stats and audience export for creator campaigns - **Social listening & sentiment** — feed posts into your analysis pipeline or LLM - **Lead generation** — export followers of accounts in your niche - **Academic research** — open-protocol social data at scale ### Input reference | Field | Type | Notes | |---|---|---| | `searchQueries` | array | Keywords/phrases. Supports operators like `from:handle` | | `searchSort` | `latest` | `top` | Sort order for searches | | `profileHandles` | array | Handles or DIDs for full profile details | | `authorFeeds` | array | Handles — returns their recent posts | | `followersOf` / `followsOf` | array | Handles — exports follower/following profiles | | `postUrls` | array | `https://bsky.app/profile//post/` — full thread | | `maxItemsPerInput` | integer | Cost cap per query/handle (default 25) | ### Pricing Pay per result. You only pay for items actually delivered to your dataset — predictable and transparent. ### FAQ **Is this legal?** The Actor reads only public data via Bluesky's official, intentionally open AT Protocol API — the same data anyone can see without an account. **Does it need my Bluesky login?** No. Never share your credentials with any scraper. **Can my AI agent use this?** Yes — this Actor works with the Apify MCP server, so Claude, Cursor, and other agents can call it as a tool. # Actor input Schema ## `searchQueries` (type: `array`): Keywords or phrases to search Bluesky posts for. NOTE: Bluesky requires a login for search — add your handle + app password below. All other modes work without login. ## `blueskyIdentifier` (type: `string`): e.g. yourname.bsky.social — needed only for keyword search. ## `blueskyAppPassword` (type: `string`): Create a dedicated app password at bsky.app → Settings → Privacy and Security → App Passwords. NEVER your main password. You can revoke it anytime. ## `searchSort` (type: `string`): How to sort keyword search results. ## `profileHandles` (type: `array`): Bluesky handles (e.g. bsky.app or user.bsky.social) or DIDs. Returns full profile details: follower counts, bio, post counts. ## `authorFeeds` (type: `array`): Handles whose recent posts you want. Returns up to 'Max items per input' posts per handle, newest first. ## `followersOf` (type: `array`): Handles whose FOLLOWERS you want to export (profile rows). ## `followsOf` (type: `array`): Handles whose FOLLOWING list you want to export (profile rows). ## `postUrls` (type: `array`): Direct links like https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l — returns the post plus its full reply thread. ## `maxItemsPerInput` (type: `integer`): Cap on results per query/handle/URL. Keeps costs predictable — you pay per result. ## `proxyConfiguration` (type: `object`): Bluesky's public API blocks datacenter IPs, so residential proxy is used by default. Change only if you know what you're doing. ## Actor input object example ```json { "searchQueries": [], "searchSort": "latest", "profileHandles": [], "authorFeeds": [ "bsky.app" ], "followersOf": [], "followsOf": [], "postUrls": [], "maxItemsPerInput": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQueries": [], "profileHandles": [], "authorFeeds": [ "bsky.app" ], "followersOf": [], "followsOf": [], "postUrls": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("samwise.agency/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 = { "searchQueries": [], "profileHandles": [], "authorFeeds": ["bsky.app"], "followersOf": [], "followsOf": [], "postUrls": [], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("samwise.agency/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 '{ "searchQueries": [], "profileHandles": [], "authorFeeds": [ "bsky.app" ], "followersOf": [], "followsOf": [], "postUrls": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call samwise.agency/bluesky-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=samwise.agency/bluesky-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bluesky Scraper — Posts, Profiles, Followers & Threads", "description": "Scrape Bluesky profiles, author feeds, follower/following lists, and full reply threads — no login needed. Optional keyword search with your own app password. Clean JSON/CSV via the official AT Protocol API.", "version": "0.1", "x-build-id": "oAmobke4kBB7afNfS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/samwise.agency~bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-samwise.agency-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/samwise.agency~bluesky-scraper/runs": { "post": { "operationId": "runs-sync-samwise.agency-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/samwise.agency~bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-samwise.agency-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": { "searchQueries": { "title": "Search queries (requires Bluesky login below)", "type": "array", "description": "Keywords or phrases to search Bluesky posts for. NOTE: Bluesky requires a login for search — add your handle + app password below. All other modes work without login.", "default": [], "items": { "type": "string" } }, "blueskyIdentifier": { "title": "Your Bluesky handle (only for search)", "type": "string", "description": "e.g. yourname.bsky.social — needed only for keyword search." }, "blueskyAppPassword": { "title": "Bluesky app password (only for search)", "type": "string", "description": "Create a dedicated app password at bsky.app → Settings → Privacy and Security → App Passwords. NEVER your main password. You can revoke it anytime." }, "searchSort": { "title": "Search sort order", "enum": [ "latest", "top" ], "type": "string", "description": "How to sort keyword search results.", "default": "latest" }, "profileHandles": { "title": "Profiles to fetch", "type": "array", "description": "Bluesky handles (e.g. bsky.app or user.bsky.social) or DIDs. Returns full profile details: follower counts, bio, post counts.", "default": [], "items": { "type": "string" } }, "authorFeeds": { "title": "Author feeds (all posts by user)", "type": "array", "description": "Handles whose recent posts you want. Returns up to 'Max items per input' posts per handle, newest first.", "default": [ "bsky.app" ], "items": { "type": "string" } }, "followersOf": { "title": "Followers of", "type": "array", "description": "Handles whose FOLLOWERS you want to export (profile rows).", "default": [], "items": { "type": "string" } }, "followsOf": { "title": "Following list of", "type": "array", "description": "Handles whose FOLLOWING list you want to export (profile rows).", "default": [], "items": { "type": "string" } }, "postUrls": { "title": "Post URLs (full thread)", "type": "array", "description": "Direct links like https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l — returns the post plus its full reply thread.", "default": [], "items": { "type": "string" } }, "maxItemsPerInput": { "title": "Max items per input", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap on results per query/handle/URL. Keeps costs predictable — you pay per result.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Bluesky's public API blocks datacenter IPs, so residential proxy is used by default. Change only if you know what you're doing.", "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 } } } } } } } } } } ```