# Dollar Hunter - Bluesky Posts & Profiles Scraper (`chuckling_yarn/dollar-hunter-bluesky-scraper`) Actor Search and extract posts, profiles, and engagement data from Bluesky social network using the public AT Protocol API. No API key or login required. - **URL**: https://apify.com/chuckling\_yarn/dollar-hunter-bluesky-scraper.md - **Developed by:** [Jonatan J. Martinez Collymoore](https://apify.com/chuckling_yarn) (community) - **Categories:** Social media, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.00005 / actor start 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 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/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 ## ๐Ÿฆ‹ Dollar Hunter - Bluesky Posts & Profiles Scraper Search and extract posts, profiles, and engagement data from [Bluesky](https://bsky.app) social network using the public AT Protocol API. **No API key, no login, no browser required.** ### โœจ Features - ๐Ÿ” **Search Posts** โ€” Find posts by keyword with automatic pagination (up to 100 results) - ๐Ÿ“ฐ **Author Feed** โ€” Get the latest posts from any Bluesky user by handle or DID - ๐Ÿ‘ค **Profile Info** โ€” Detailed profile data: followers, follows, posts, verification status - ๐Ÿ“Š **Engagement Metrics** โ€” Likes, reposts, replies, and quote counts per post - ๐Ÿ”„ **Auto-retry** โ€” Built-in retry with exponential backoff for transient failures - ๐ŸŒ **No auth needed** โ€” Uses Bluesky's open AT Protocol, no API key required ### ๐Ÿ“ฅ Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | select | `search` | `search` (keyword), `author_feed` (user's posts), `profile` (user info) | | `query` | string | `Bluesky` | Keyword for search, or Bluesky handle/DID for feed/profile | | `maxResults` | int | `25` | Max items to return (1โ€“100) | | `sort` | select | `latest` | `latest` or `top` (search mode only) | ### ๐Ÿ“ค Output #### Search / Author Feed Mode | Field | Type | Description | |-------|------|-------------| | `text` | string | Post content (up to 2000 chars) | | `author` | string | Bluesky handle (e.g. `bsky.app`) | | `authorDisplayName` | string | Display name | | `likes` | int | Like count | | `reposts` | int | Repost count | | `replies` | int | Reply count | | `url` | string | Direct link to the post | | `createdAt` | string | ISO timestamp | | `langs` | array | Language tags | | `hasEmbed` | bool | Contains embedded content | | `isRepost` | bool | Is a repost | #### Profile Mode | Field | Type | Description | |-------|------|-------------| | `handle` | string | Bluesky handle | | `displayName` | string | Profile display name | | `description` | string | Bio (up to 500 chars) | | `followersCount` | int | Total followers | | `followsCount` | int | Total following | | `postsCount` | int | Total posts | | `verificationStatus` | string | Verification status | | `avatar` | string | Avatar image URL | ### ๐ŸŽฏ Use Cases - ๐Ÿค– **AI Training Data** โ€” Curate Bluesky posts for fine-tuning or RAG datasets - ๐Ÿ“ˆ **Social Listening** โ€” Track keywords, trends, and brand mentions in real-time - ๐Ÿ” **Lead Generation** โ€” Find influencers and active users by topic - ๐Ÿ“Š **Market Research** โ€” Monitor conversations around products and industries - ๐Ÿ•ต๏ธ **Competitive Intel** โ€” Track competitor announcements and community reactions - ๐Ÿ“ฐ **Content Curation** โ€” Discover trending content for newsletters or roundups ### ๐Ÿ“‹ Example ```json { "mode": "search", "query": "artificial intelligence", "maxResults": 10, "sort": "top" } ```` Returns top 10 Bluesky posts matching "artificial intelligence", sorted by engagement. ### โ“ FAQ **Q: Do I need a Bluesky account?**\ No. The AT Protocol API is fully public for read operations. **Q: Are there rate limits?**\ Bluesky's public API has undocumented rate limits. The actor handles 429 responses with automatic retry. **Q: Can I search in a specific language?**\ Search results include a `langs` field. Use specific query terms to narrow by language. **Q: What's a DID?**\ A Decentralized Identifier (e.g. `did:plc:...`). You can use it instead of a handle for the `author_feed` and `profile` modes. ### ๐Ÿท๏ธ Categories `Social Media` ยท `Developer Tools` ยท `Data Extraction` ### ๐Ÿ’ฐ Pricing Pay per event โ€” **$0.003 per 25 posts**. Only pay for successful runs. # Actor input Schema ## `mode` (type: `string`): What to scrape from Bluesky ## `query` (type: `string`): For 'search': keyword to find posts. For 'author\_feed' or 'profile': Bluesky handle (e.g. 'bsky.app') or DID ## `maxResults` (type: `integer`): Maximum number of posts/profiles to return (1-100) ## `sort` (type: `string`): How to sort search results (only applies to 'search' mode) ## Actor input object example ```json { "mode": "search", "query": "artificial intelligence", "maxResults": 25, "sort": "latest" } ``` # 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 = { "query": "artificial intelligence" }; // Run the Actor and wait for it to finish const run = await client.actor("chuckling_yarn/dollar-hunter-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 = { "query": "artificial intelligence" } # Run the Actor and wait for it to finish run = client.actor("chuckling_yarn/dollar-hunter-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 '{ "query": "artificial intelligence" }' | apify call chuckling_yarn/dollar-hunter-bluesky-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=chuckling_yarn/dollar-hunter-bluesky-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Dollar Hunter - Bluesky Posts & Profiles Scraper", "description": "Search and extract posts, profiles, and engagement data from Bluesky social network using the public AT Protocol API. No API key or login required.", "version": "1.0", "x-build-id": "YbkHbHuvAhg49EzrP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chuckling_yarn~dollar-hunter-bluesky-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chuckling_yarn-dollar-hunter-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/chuckling_yarn~dollar-hunter-bluesky-scraper/runs": { "post": { "operationId": "runs-sync-chuckling_yarn-dollar-hunter-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/chuckling_yarn~dollar-hunter-bluesky-scraper/run-sync": { "post": { "operationId": "run-sync-chuckling_yarn-dollar-hunter-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": { "mode": { "title": "Search Mode", "enum": [ "search", "author_feed", "profile" ], "type": "string", "description": "What to scrape from Bluesky", "default": "search" }, "query": { "title": "Search Query or Handle", "type": "string", "description": "For 'search': keyword to find posts. For 'author_feed' or 'profile': Bluesky handle (e.g. 'bsky.app') or DID", "default": "artificial intelligence" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of posts/profiles to return (1-100)", "default": 25 }, "sort": { "title": "Sort Order", "enum": [ "latest", "top" ], "type": "string", "description": "How to sort search results (only applies to 'search' mode)", "default": "latest" } } }, "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 } } } } } } } } } } ```