# BlueSky Author Feed Scraper (`sandaliaapps/bluesky-author-feed-scraper`) Actor Extract posts, engagement metrics, author details, embeds, and metadata from Bluesky author feeds in structured JSON format. - **URL**: https://apify.com/sandaliaapps/bluesky-author-feed-scraper.md - **Developed by:** [Sandalia Apps](https://apify.com/sandaliaapps) (community) - **Categories:** Lead generation, Social media, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $6.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. 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 Author Feed Scraper A powerful and scalable **Apify Actor** to extract structured posts and engagement analytics from **Bluesky (AT Protocol) author feeds**. Perfect for **social media analytics, decentralized web research, AI dataset creation, and content intelligence pipelines**. --- ### ๐Ÿ”ฅ Why This Actor? Bluesky is one of the fastest-growing decentralized social networks โ€” but its data is hard to access at scale. This Actor solves that by giving you: - โšก Clean structured JSON output - ๐Ÿ“Š Full engagement metrics (likes, reposts, replies, quotes) - ๐Ÿ‘ค Rich author profile extraction - ๐Ÿ”— Embedded content parsing (YouTube, links, media) - ๐Ÿง  AI-ready dataset formatting - ๐Ÿš€ Fully automated Apify cloud execution --- ### โœจ Key Features - ๐Ÿ“ก Scrape Bluesky author feeds by handle - ๐Ÿ‘ค Extract full author metadata (DID, handle, avatar, verification) - ๐Ÿ“ Collect post content + timestamps + language detection - ๐Ÿ“ˆ Engagement analytics (likes, reposts, replies, bookmarks, quotes) - ๐Ÿ”— Extract external embeds (YouTube, websites, thumbnails) - ๐Ÿงพ Structured JSON output ready for pipelines - โš™๏ธ Configurable limits for scalable crawling --- ### โš™๏ธ Input Parameters ```json { "profileHandles": ["rust-lang.org"], "maxItems": 10, "maxResults": 30 } ```` *** ### ๐Ÿ“ค Output Example Each item represents a single Bluesky post with full metadata: ```json { "uri": "at://did:plc:.../app.bsky.feed.post/3mjp6oez5ic22", "cid": "bafyreib6c...", "author": { "did": "did:plc:wicua5idywllkobpfm64byvm", "handle": "rust-lang.org", "displayName": "Rust Language", "avatar": "https://cdn.bsky.app/img/avatar/plain/...", "associated": { "activitySubscription": { "allowSubscriptions": "followers" } }, "labels": [], "createdAt": "2023-06-28T20:17:39.829Z", "verification": { "verifications": [ { "issuer": "did:plc:z72i7hd...", "isValid": true, "createdAt": "2026-03-12T21:37:09.563Z" } ], "verifiedStatus": "valid" } }, "record": { "$type": "app.bsky.feed.post", "createdAt": "2026-04-17T14:56:50.924Z", "text": "Curious what's new in Rust 1.95.0?", "langs": ["en"], "embed": { "external": { "uri": "https://www.youtube.com/watch?v=NZlmaIgkUQ8", "title": "Rust Release Changelog - 1.95.0", "description": "YouTube video by Rust Programming Language", "thumb": { "mimeType": "image/jpeg", "size": 325287 } } } }, "embed": { "external": { "uri": "https://www.youtube.com/watch?v=NZlmaIgkUQ8", "title": "Rust Release Changelog - 1.95.0", "description": "YouTube video by Rust Programming Language", "thumb": "https://cdn.bsky.app/img/feed_thumbnail/..." } }, "bookmarkCount": 4, "replyCount": 0, "repostCount": 5, "likeCount": 43, "quoteCount": 1, "indexedAt": "2026-04-17T14:56:53.849Z", "labels": [] } ``` *** ### ๐Ÿ“Š Data Fields Extracted - uri - cid - author.did - author.handle - author.displayName - author.avatar - author.associated - author.labels - author.createdAt - author.verification - record.$type - record.createdAt - record.text - record.langs - record.embed - embed.external.uri - embed.external.title - embed.external.description - embed.external.thumb - bookmarkCount - replyCount - repostCount - likeCount - quoteCount - indexedAt - labels *** ### ๐Ÿง  Use Cases - ๐Ÿ“Š Social Media Intelligence - Track engagement trends across Bluesky accounts in real time. - ๐Ÿงช AI & LLM Training Data - Generate structured datasets for training or fine-tuning models. - ๐Ÿ”Ž Research & Analytics - Study decentralized social behavior and content virality. - ๐Ÿ“ฃ Brand Monitoring - Monitor mentions, posts, and engagement of specific communities. - ๐Ÿค– Automation Pipelines - Feed structured Bluesky data into dashboards, APIs, or ETL systems. *** ### โšก Performance & Architecture - Async crawling for high efficiency - Optimized for Apify cloud scaling - Configurable limits for cost control - Lightweight and production-ready *** ### ๐Ÿ“Œ Output Highlights - ๐Ÿงพ Full post text extraction - ๐Ÿ“ˆ Engagement metrics tracking - ๐Ÿ‘ค Verified author metadata support - ๐Ÿ”— External content embedding (YouTube, links) - โšก Real-time structured dataset output *** ### ๐Ÿง‘โ€๐Ÿ’ป Built For - Data engineers - AI developers - Growth hackers - Social media analysts - Researchers *** ### ๐Ÿ”— More Actors by Sandalia Apps Take your automation to the next level with our other tools: | Actor Name | Description | |------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------| | [**TikTok User Data Extractor**](https://apify.com/sandaliaapps/TikTok-User-Data-Extractor) | โšก๏ธ Extract thousands of TikTok profiles in minutes! | | [**Onlyfan Profile Scraper**](https://apify.com/sandaliaapps/onlyfan-profile-scraper) | Scrapes profile data in bulk with details like name, bio, last online, engagement insights, social links | | [**Fansly Profile Scraper**](https://apify.com/sandaliaapps/fansly-profile-scraper) | Scrapes Fansly profiles in bulk with all available details | | [**YouTube Video Data Extractor**](https://apify.com/sandaliaapps/youtube-video-data-extractor) | Extract detailed and structured data from YouTube videos, channels, and playlists โ€” no API key required. | | [**TruthSocial Profile Data Extractor**](https://apify.com/sandaliaapps/truthsocial-profile-data-extractor) |The Truthsocial Profile Data Extractor is designed to be user-friendly and highly efficient, making it an ideal solution for businesses, researchers, and individuals looking to automate data collection.| | [**Truth Social Post Extractor**](https://apify.com/sandaliaapps/truthsocial-post-extractor) |Easily extract and collect data from Truth Social posts using the Truth Social Posts Extractor Apify Actor.| | [**Mastodon Profile Scraper**](https://apify.com/sandaliaapps/mastodon-profile-scraper) |Mastodon Profile Scraper lets you extract rich profile data from any public Mastodon account.| | [**Tiktok Post Data Extractor**](https://apify.com/sandaliaapps/tiktok-post-data-extractor) |TikTok Post Data Extractor lets you scrape detailed information from TikTok posts, including captions, hashtags, video URLs, likes, views, comments, and more โ€” perfect for analytics, research, and trend monitoring.| | [**Passes Profile Scraper**](https://apify.com/sandaliaapps/passes-profile-scraper) |Scrape public Passes creator profiles including bio, stats, links, and profile details. Fast, reliable, and scalable Passes profile data extraction actor.| | [**Google Maps Data Extractor**](https://apify.com/sandaliaapps/google-maps-data-extractor) |Google Maps Data Extractor is a powerful scraper and extractor that collects business listings from Google Maps, including names, ratings, reviews, addresses, phones, and more. Perfect for lead generation, market research, business intelligence, and local SEO.| | [**BlueSky Profile Data Extractor**](https://apify.com/sandaliaapps/bluesky-profile-data-extractor) |Bluesky profile Data Extractor extracts user details including handle, bio, avatar, verification, followers, and activity metrics in structured JSON format.| *** ### ๐Ÿ‘จโ€๐Ÿ’ป Developed by Sandalia Apps We're a team of automation engineers passionate about building smart, scalable scrapers for content platforms.\ ๐Ÿ’ผ For custom solutions or support, feel free to [contact us](https://sandalia.com.bd/apps). # Actor input Schema ## `profileHandles` (type: `array`): BlueSky Profile handles to extract Author Feed ## `maxItems` (type: `integer`): Limits the maximum number of handles ## `maxResults` (type: `integer`): Limits the maximum number of handles ## `proxySettings` (type: `object`): Select proxies to be used by scraper. ## Actor input object example ```json { "profileHandles": [ "rust-lang.org" ], "maxItems": 10, "maxResults": 30, "proxySettings": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `posts` (type: `string`): No description ## `authors` (type: `string`): No description ## `rawDataset` (type: `string`): No description ## `storage` (type: `string`): No description # 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 = { "profileHandles": [ "rust-lang.org" ], "proxySettings": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("sandaliaapps/bluesky-author-feed-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 = { "profileHandles": ["rust-lang.org"], "proxySettings": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("sandaliaapps/bluesky-author-feed-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 '{ "profileHandles": [ "rust-lang.org" ], "proxySettings": { "useApifyProxy": false } }' | apify call sandaliaapps/bluesky-author-feed-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sandaliaapps/bluesky-author-feed-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BlueSky Author Feed Scraper", "description": "Extract posts, engagement metrics, author details, embeds, and metadata from Bluesky author feeds in structured JSON format.", "version": "0.5", "x-build-id": "aaExjDsjpkiqB7DI1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandaliaapps~bluesky-author-feed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandaliaapps-bluesky-author-feed-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/sandaliaapps~bluesky-author-feed-scraper/runs": { "post": { "operationId": "runs-sync-sandaliaapps-bluesky-author-feed-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/sandaliaapps~bluesky-author-feed-scraper/run-sync": { "post": { "operationId": "run-sync-sandaliaapps-bluesky-author-feed-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": [ "profileHandles" ], "properties": { "profileHandles": { "title": "List Handle Names", "type": "array", "description": "BlueSky Profile handles to extract Author Feed", "items": { "type": "string" } }, "maxItems": { "title": "Limit number of handles", "type": "integer", "description": "Limits the maximum number of handles", "default": 10 }, "maxResults": { "title": "Limit number of handles", "type": "integer", "description": "Limits the maximum number of handles", "default": 30 }, "proxySettings": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by scraper." } } }, "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 } } } } } } } } } } ```