# BlueSky Profile Data Extractor (`sandaliaapps/bluesky-profile-data-extractor`) Actor Bluesky profile Data Extractor extracts user details including handle, bio, avatar, verification, followers, and activity metrics in structured JSON format. - **URL**: https://apify.com/sandaliaapps/bluesky-profile-data-extractor.md - **Developed by:** [Sandalia Apps](https://apify.com/sandaliaapps) (community) - **Categories:** Lead generation, Social media, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.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 Profile Data Extractor A powerful Bluesky profile scraper and data extractor for the Apify platform. This actor extracts structured public profile data from Bluesky, including user identity details, social metrics, verification status, and metadata powered by the AT Protocol ecosystem. --- ### 🔍 Overview The **BlueSky Profile Data Extractor** is designed for developers, analysts, and marketers who need reliable access to Bluesky public profile data. It converts raw profile data into clean, structured JSON for analytics, enrichment, and automation workflows. Perfect for: * Social media analytics * Influencer discovery * Brand monitoring * AT Protocol / Bluesky ecosystem research * Data pipelines and CRM enrichment --- ### 🚀 Key Features * Extracts full Bluesky user profile data from handle * Supports AT Protocol identifiers (did:plc) * Collects profile metadata (display name, avatar, banner) * Retrieves social metrics (followers, follows, posts count) * Detects verification status and trusted issuer data * Structured JSON output for easy integration * Fast, scalable, and automation-ready on Apify --- ### 📥 Input Format Provide one or multiple Bluesky handles or DIDs: ```json { "handles": [ "rust-lang.org" ] } ```` *** ### 📤 Output Example ```json { "did": "did:plc:wicua5idywllkobpfm64byvm", "handle": "rust-lang.org", "displayName": "Rust Language", "avatar": "https://cdn.bsky.app/img/avatar/plain/...", "banner": "https://cdn.bsky.app/img/banner/plain/...", "description": "A programming language empowering everyone to build reliable and efficient software.", "createdAt": "2023-06-28T20:17:39.829Z", "indexedAt": "2026-02-09T16:26:06.144Z", "followersCount": 9974, "followsCount": 0, "postsCount": 26, "verification": { "verifiedStatus": "valid" }, "associated": { "lists": 0, "feedgens": 0, "starterPacks": 0, "labeler": false }, "labels": [] } ``` *** ### 📊 Data Fields Extracted - did – Decentralized Identifier (AT Protocol) - handle – Bluesky username - displayName – Profile display name - description – Bio / profile description - avatar – Profile image URL - banner – Profile header image - followersCount – Number of followers - followsCount – Number of accounts followed - postsCount – Total posts count - verification – Verification status and issuer info - associated – Lists, feed generators, starter packs, labeler info - createdAt – Account creation date - indexedAt – Last indexed timestamp - labels – Moderation or system labels *** ### 🧠 Use Cases - Bluesky influencer tracking and discovery - Social graph and audience analysis - AT Protocol ecosystem research - Marketing intelligence and brand monitoring - CRM and lead enrichment systems - Academic and data science research *** ### ⚙️ Why Use This Actor? Unlike basic scrapers, this tool is optimized for: - Bluesky profile scraping at scale - Clean structured JSON output - AT Protocol compatibility - Reliable extraction of metadata fields - Integration with Apify workflows and APIs *** ### 🧩 Output Format All results are returned in JSON format, ready for: - APIs - Databases - Spreadsheets - Data pipelines - AI / ML pipelines *** ### 🛡️ Notes - Only publicly available Bluesky data is collected - No authentication required - Designed for ethical and compliant data usage *** ### 🔗 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.| *** ### 👨‍💻 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 profile data ## `maxItems` (type: `integer`): Limits the maximum number of results ## `proxySettings` (type: `object`): Select proxies to be used by scraper. ## Actor input object example ```json { "profileHandles": [ "rust-lang.org" ], "maxItems": 10, "proxySettings": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `profiles` (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-profile-data-extractor").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-profile-data-extractor").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-profile-data-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sandaliaapps/bluesky-profile-data-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BlueSky Profile Data Extractor", "description": "Bluesky profile Data Extractor extracts user details including handle, bio, avatar, verification, followers, and activity metrics in structured JSON format.", "version": "0.5", "x-build-id": "qOzZVtVEEsnKLzfBO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandaliaapps~bluesky-profile-data-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandaliaapps-bluesky-profile-data-extractor", "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-profile-data-extractor/runs": { "post": { "operationId": "runs-sync-sandaliaapps-bluesky-profile-data-extractor", "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-profile-data-extractor/run-sync": { "post": { "operationId": "run-sync-sandaliaapps-bluesky-profile-data-extractor", "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 profile data", "items": { "type": "string" } }, "maxItems": { "title": "Limit number of results", "type": "integer", "description": "Limits the maximum number of results", "default": 10 }, "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 } } } } } } } } } } ```