# Bluesky Lead Finder (`brilliant_gum/bluesky-lead-finder`) Actor Search Bluesky by keyword and get scored leads with emails, engagement rates, influencer tiers, and website-enriched contact data. Extract bio emails, crawl linked websites for contacts, verify via MX lookup, and score every profile 0-100. No auth required. - **URL**: https://apify.com/brilliant\_gum/bluesky-lead-finder.md - **Developed by:** [Yuliia Kulakova](https://apify.com/brilliant_gum) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $30.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Lead Finder — Emails, Scores & Influencer Intelligence [![Bluesky Lead Finder](https://i.imgur.com/wrR26jF.png)](https://apify.com/brilliant_gum/bluesky-lead-finder) Search Bluesky by keyword, score every profile 0-100, extract emails from bios and websites, verify via MX lookup, and classify influencer tiers — all without authentication. No login, no cookies, no proxy needed. --- ### What you get Every lead comes with 32 fields of enriched data: - **Contact info** — bio email, website email, phone number, LinkedIn, Twitter/X - **Lead score 0-100** — transparent breakdown showing exactly why each profile scored high or low - **Email verification** — free MX record check (valid / invalid / uncertain) - **Website email crawl** — visits the profile's website + /contact page to find emails (3-5x more emails than bio-only) - **Influencer tier** — rising / nano / micro / macro / mega based on follower count - **Niche classification** — 9 categories auto-detected from bio: Tech/Startup, Marketing, Design, Health/Fitness, Finance/Crypto, and more - **Engagement rate** — real engagement calculated from the last 20 posts - **Full profile data** — avatar, banner, bio, DID, follower/following counts, post count, verification status --- ### Quick start Just type a keyword and click Run. ```json { "searchQueries": ["SaaS founder"], "maxResultsPerQuery": 100 } ```` You'll get up to 100 scored leads with emails, websites, and full enrichment. No setup, no API keys, no authentication. *** ### Use cases #### Build a B2B prospect list Find SaaS founders with verified emails and high lead scores. ```json { "searchQueries": ["SaaS founder", "B2B startup CEO"], "maxResultsPerQuery": 500, "crawlWebsites": true, "verifyEmails": true, "minLeadScore": 40, "bioKeywords": ["founder", "CEO", "building"] } ``` #### Find micro-influencers for campaigns Target fitness coaches with 500-50K followers and real engagement. ```json { "searchQueries": ["fitness coach", "personal trainer"], "maxResultsPerQuery": 300, "minFollowers": 500, "maxFollowers": 50000, "calculateEngagement": true, "minEngagementRate": 2, "crawlWebsites": true } ``` #### Enrich a known list of handles Skip the search — go straight to enrichment for handles you already have. ```json { "handles": ["alice.bsky.social", "bob.bsky.social"], "crawlWebsites": true, "verifyEmails": true, "calculateEngagement": true } ``` #### Find crypto/Web3 developers ```json { "searchQueries": ["solidity developer", "web3 engineer"], "maxResultsPerQuery": 200, "crawlWebsites": true, "verifyEmails": true, "minLeadScore": 30, "bioKeywords": ["developer", "engineer", "building"] } ``` *** ### Why Bluesky for lead generation? - **Fully public API** — no login, no cookies, no auth tokens required - **No IP blocking** — the API is open, making scraping cheap and reliable - **No profile-view limits** — unlike LinkedIn's 100-profile/day wall - **Highly engaged community** — tech, startup, crypto, and creator niches are thriving - **Structured data** — bios, websites, follower counts, and DIDs are all exposed via the AT Protocol *** ### Lead score explained Every point is traceable to a specific signal: | Signal | Max Points | Logic | |--------|-----------|-------| | Bio email found | 30 | Email extracted from profile bio | | Website email found | 20 | Email found by crawling the linked website | | Has website | 10 | Profile has a website URL | | Follower count | 15 | Log10 scale, capped at 1M | | Engagement rate | 20 | Real rate capped at 10% for full points | | Bio completeness | 5 | Bio >100 chars = 5pts, >30 chars = 2pts | **Total max = 100.** Weights are fully customizable via the `scoreWeights` input — adjust to match your outreach priorities. *** ### Output example ```json { "did": "did:plc:abc123", "handle": "alice.bsky.social", "displayName": "Alice Chen", "profileUrl": "https://bsky.app/profile/alice.bsky.social", "bio": "SaaS founder. Building @product.", "website": "https://acme.com", "bioEmail": null, "websiteEmail": "contact@acme.com", "primaryEmail": "contact@acme.com", "emailVerification": "valid", "linkedinUrl": "https://linkedin.com/in/alicechen", "followersCount": 12450, "engagementRate": 3.72, "influencerTier": "micro", "niche": "Tech/Startup", "leadScore": 72, "leadScoreBreakdown": { "hasEmail": 0, "hasWebsiteEmail": 20, "hasWebsite": 10, "followersLog": 11, "engagementRate": 7, "bioCompleteness": 5 } } ``` *** ### Influencer tiers | Tier | Follower Range | |------|---------------| | Rising | < 1,000 | | Nano | 1,000 - 9,999 | | Micro | 10,000 - 99,999 | | Macro | 100,000 - 999,999 | | Mega | 1,000,000+ | *** ### Niche categories Automatically classified from bio keywords: Tech/Startup, Marketing, Design/Creative, Health/Fitness, Finance/Crypto, Writing/Media, Engineering, Arts/Entertainment, Academia/Research, General *** ### Filters at a glance | Filter | What it does | |--------|-------------| | `minFollowers` / `maxFollowers` | Target a specific audience size | | `minEngagementRate` | Only keep profiles with real engagement | | `minLeadScore` | Skip low-quality leads before saving | | `bioKeywords` | Only keep profiles whose bio matches your target keywords | | `deduplicateByDid` | Prevent duplicates across overlapping search queries | *** ### Pricing Pay per lead. No monthly fees. No hidden costs. | What you pay for | Price | |---|---| | Lead saved | **$0.03** per lead | | Apify platform usage | [Standard compute costs](https://apify.com/pricing) | 100 leads = $3. 1,000 leads = $30. *** ### FAQ **Do I need a Bluesky account?** No. The API is fully public. No login, no cookies, no tokens. **How does website email crawl work?** The actor visits each profile's linked website homepage and /contact page, extracts emails from the HTML, and picks the best one. This increases email yield 3-5x compared to bio-only extraction. **What does email verification do?** It checks DNS MX records to confirm the email domain can receive mail. Results: `valid` (MX records found), `invalid` (no MX records), `uncertain` (DNS timeout). Free, no external service needed. **Can I customize the lead score?** Yes. Pass a `scoreWeights` JSON object to override any weight. For example, set `{"hasEmail": 50}` to prioritize profiles with emails. **What is a DID?** A Decentralized Identifier — a globally unique, permanent ID in the AT Protocol. Even if a user changes their handle, the DID stays the same. Used for deduplication. **Can I run multiple queries in one run?** Yes. Add multiple strings to `searchQueries`. Each query fetches up to `maxResultsPerQuery` profiles. DID deduplication prevents cross-query duplicates. **How many profiles can I fetch per query?** Up to 5,000 per query. For larger datasets, use multiple queries targeting different keywords. # Actor input Schema ## `searchQueries` (type: `array`): Keywords/niches to search on Bluesky (e.g. 'SaaS founder', 'fitness coach'). One search per item. ## `handles` (type: `array`): Specific Bluesky handles to enrich directly (e.g. 'alice.bsky.social'). Skips the search step. ## `maxResultsPerQuery` (type: `integer`): Maximum number of profiles to fetch for each search query. Max 5000. ## `minFollowers` (type: `integer`): Only include profiles with at least this many followers. 0 = no minimum. ## `maxFollowers` (type: `integer`): Only include profiles with at most this many followers. 0 = no limit. ## `minEngagementRate` (type: `number`): Only include profiles with engagement rate above this threshold. Requires calculateEngagement=true. ## `minLeadScore` (type: `integer`): Only save profiles that score at or above this threshold. 0 = save all. ## `bioKeywords` (type: `array`): Only return profiles whose bio contains at least one of these keywords. ## `crawlWebsites` (type: `boolean`): Visit the profile's website link and extract contact emails. Increases email yield 3-5x. ## `verifyEmails` (type: `boolean`): Check MX DNS records to flag emails as valid/invalid/uncertain. Free, no external service. ## `calculateEngagement` (type: `boolean`): Fetch recent posts to calculate real engagement rate. Uses 1 extra API call per profile. ## `scoreWeights` (type: `object`): Customize lead scoring weights as a JSON object. Example: {"hasEmail":30,"hasWebsite":10,"followersLog":15,"engagementRate":20,"bioCompleteness":5} ## `deduplicateByDid` (type: `boolean`): Skip profiles already seen in this run (matched by Decentralized Identifier). Prevents duplicate leads. ## `proxyConfiguration` (type: `object`): Built-in proxy is included. Override only if you need a specific proxy group. ## Actor input object example ```json { "searchQueries": [ "SaaS founder", "marketing agency", "fitness coach" ], "maxResultsPerQuery": 5, "minFollowers": 0, "maxFollowers": 0, "minEngagementRate": 0, "minLeadScore": 0, "crawlWebsites": true, "verifyEmails": true, "calculateEngagement": false, "deduplicateByDid": true } ``` # Actor output Schema ## `results` (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 = { "searchQueries": [ "SaaS founder" ], "maxResultsPerQuery": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("brilliant_gum/bluesky-lead-finder").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": ["SaaS founder"], "maxResultsPerQuery": 5, } # Run the Actor and wait for it to finish run = client.actor("brilliant_gum/bluesky-lead-finder").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": [ "SaaS founder" ], "maxResultsPerQuery": 5 }' | apify call brilliant_gum/bluesky-lead-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brilliant_gum/bluesky-lead-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bluesky Lead Finder", "description": "Search Bluesky by keyword and get scored leads with emails, engagement rates, influencer tiers, and website-enriched contact data. Extract bio emails, crawl linked websites for contacts, verify via MX lookup, and score every profile 0-100. No auth required.", "version": "1.0", "x-build-id": "kjsbow8gEnGriC7nU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brilliant_gum~bluesky-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brilliant_gum-bluesky-lead-finder", "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/brilliant_gum~bluesky-lead-finder/runs": { "post": { "operationId": "runs-sync-brilliant_gum-bluesky-lead-finder", "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/brilliant_gum~bluesky-lead-finder/run-sync": { "post": { "operationId": "run-sync-brilliant_gum-bluesky-lead-finder", "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", "type": "array", "description": "Keywords/niches to search on Bluesky (e.g. 'SaaS founder', 'fitness coach'). One search per item.", "items": { "type": "string" } }, "handles": { "title": "Direct Handles", "type": "array", "description": "Specific Bluesky handles to enrich directly (e.g. 'alice.bsky.social'). Skips the search step.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max Results Per Query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of profiles to fetch for each search query. Max 5000.", "default": 100 }, "minFollowers": { "title": "Min Followers", "type": "integer", "description": "Only include profiles with at least this many followers. 0 = no minimum.", "default": 0 }, "maxFollowers": { "title": "Max Followers", "type": "integer", "description": "Only include profiles with at most this many followers. 0 = no limit.", "default": 0 }, "minEngagementRate": { "title": "Min Engagement Rate (%)", "type": "number", "description": "Only include profiles with engagement rate above this threshold. Requires calculateEngagement=true.", "default": 0 }, "minLeadScore": { "title": "Min Lead Score (0-100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only save profiles that score at or above this threshold. 0 = save all.", "default": 0 }, "bioKeywords": { "title": "Bio Must Contain Keywords", "type": "array", "description": "Only return profiles whose bio contains at least one of these keywords.", "items": { "type": "string" } }, "crawlWebsites": { "title": "Crawl Linked Websites for Email", "type": "boolean", "description": "Visit the profile's website link and extract contact emails. Increases email yield 3-5x.", "default": true }, "verifyEmails": { "title": "Verify Emails (MX check)", "type": "boolean", "description": "Check MX DNS records to flag emails as valid/invalid/uncertain. Free, no external service.", "default": true }, "calculateEngagement": { "title": "Calculate Engagement Rate", "type": "boolean", "description": "Fetch recent posts to calculate real engagement rate. Uses 1 extra API call per profile.", "default": false }, "scoreWeights": { "title": "Lead Score Weights (JSON)", "type": "object", "description": "Customize lead scoring weights as a JSON object. Example: {\"hasEmail\":30,\"hasWebsite\":10,\"followersLog\":15,\"engagementRate\":20,\"bioCompleteness\":5}" }, "deduplicateByDid": { "title": "Deduplicate by DID", "type": "boolean", "description": "Skip profiles already seen in this run (matched by Decentralized Identifier). Prevents duplicate leads.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Built-in proxy is included. Override only if you need a specific proxy group." } } }, "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 } } } } } } } } } } ```