# Bluesky Email Scraper (`solid-scraper/bluesky-email-scraper`) Actor 🚀 Bluesky Email Scraper extracts verified emails from targeted Bluesky profiles by keyword and location. Perfect for lead gen, sales, and outreach teams seeking quality prospects fast. Start scraping in minutes—boost your pipeline today! 📈 - **URL**: https://apify.com/solid-scraper/bluesky-email-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Lead generation, Automation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 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/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 Email Scraper 📬 **Bluesky Email Scraper** is an Apify actor that helps you scrape email addresses from publicly available Bluesky profile bios and posts that match your chosen keywords. If you’re looking to **scrape Bluesky emails**, **get emails from Bluesky**, or build a **Bluesky outreach email list**, this actor can save you hours of manual research—especially when you’re combining keyword targeting with email-domain filters. Whether you’re a marketer, recruiter, founder, or data enthusiast, **Bluesky Email Scraper** turns public web data into structured results you can use for lead generation and outreach workflows—at scale. --- ### Why choose Bluesky Email Scraper? 🧠 | Feature | Benefit | | --- | --- | | ✅ **Keyword-based email discovery** | Finds emails from Bluesky bios and posts related to your keywords | | ✅ **Custom email domain targeting** | Focuses extraction on the domains you care about (e.g., `@gmail.com`) | | ✅ **Proxy support** | Helps keep runs stable with built-in proxy support for reliable scraping | | ✅ **Reliability with retries and fallbacks** | Includes retries and fallbacks for resilience when results are limited | | ✅ **Structured dataset output** | Produces clear JSON records for easy import into your pipeline | | ✅ **Scale controlled by limits** | Uses `maxEmails` to stop once your collection goal is reached (helps control scraping time) | --- ### Key features - 🔎 **Keyword and domain-driven harvesting**: Uses your keywords and custom email-domain filters to extract relevant contact emails. - 🧾 **Structured rows pushed to dataset**: Each discovered email is immediately saved with fields like `network`, `keyword`, `email`, `title`, `url`, and more. - 🛡️ **Proxy resilience**: Built-in proxy support helps keep scraping runs reliable across different conditions. - 🔄 **Retry logic & stopping rules**: Includes logic to handle empty/limited results and stop when continuing is unlikely to help. - 💾 **Progress persistence**: Saves progress (cursor + seen emails) using an internal key-value store to reduce repeat work on reruns. - ⚙️ **Configurable engine**: Lets you choose `cost-effective` or `legacy` for different tradeoffs in scraping behavior and reliability. - 📊 **Max limit to control cost**: `maxEmails` caps the extraction so runs don’t grow indefinitely. --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["founder", "marketing"], "location": "", "platform": "Bluesky", "customDomains": ["@gmail.com"], "maxEmails": 20, "engine": "cost-effective", "proxyConfiguration": {} } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `keywords` | ✅ Yes | A list of keywords to search for. The scraper uses these keywords to find relevant email mentions in Bluesky bios and posts. | | `location` | ❌ No | Location to filter search results. Leave empty (`""`) if you don’t want a location filter. | | `platform` | ❌ No | Select platform. For this actor, the only available option is `Bluesky`. | | `customDomains` | ❌ No | List of custom email domains to target. Use values like `@gmail.com` to focus extraction on specific provider domains. | | `maxEmails` | ❌ No | Maximum number of emails to collect. The scraper stops once this limit is reached. Higher values can find more results but may take longer. | | `engine` | ❌ No | Choose scraping engine: `cost-effective` (Cost Effective (New)) or `legacy` (Legacy). | | `proxyConfiguration` | ❌ No | Proxy settings for this Actor. Use this if you want to manage proxy details for your run. | *** ### Output The actor pushes discovered email records into the default dataset in JSON format (via `Actor.push_data`). Example output item: ```json { "network": "Bluesky.com", "keyword": "founder", "title": "No title", "description": "No data", "url": "No URL", "email": "example@gmail.com", "proxyGroups": ["your-proxy-groups"] } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `network` | string | The source network label (`"Bluesky.com"`). | | `keyword` | string | The keyword used for this search context. | | `title` | string | Title text associated with the result (as extracted by the actor). | | `description` | string | Description/snippet text where the email was found (as extracted by the actor). | | `url` | string | The result URL associated with the extracted email. | | `email` | string | The extracted email address. | | `proxyGroups` | array | Proxy groups used for the run (the actor includes this value in each pushed record). | Notes: - The actor extracts emails by matching email patterns that align with your `customDomains` values. - It avoids pushing duplicate emails by tracking `seen_emails`. *** ### How to use Bluesky Email Scraper (via Apify Console) 1. **Open Apify Console**\ Sign in at https://console.apify.com and open the Actors page. 2. **Find the actor**\ Search for **Bluesky Email Scraper** and open its actor page. 3. **Go to the INPUT tab**\ Use the built-in form to fill in your inputs: - Add your list of `keywords` (required) - Optionally set `customDomains` to target specific email providers/domains - Optionally set `maxEmails` to control how many emails to collect 4. **Set engine choice (optional)**\ Pick `engine` as either `cost-effective` or `legacy`, depending on your preference for speed/cost vs reliability. 5. **Configure proxies (optional)**\ If you need custom proxy settings, fill in `proxyConfiguration`. The actor also supports proxy usage via the engine choice. 6. **Run the actor**\ Click **Run**. During execution, you’ll see logs about progress, retries, and when `maxEmails` is reached. 7. **Review results in the DATASET tab**\ After the run completes, open the dataset to see pushed JSON records. 8. **Export your data**\ Export the dataset to JSON/CSV from Apify Console for use in spreadsheets, CRMs, or analysis tools. No coding required—you can generate a **Bluesky lead generation tool** style email list in minutes. *** ### Advanced features & SEO optimization - ✅ **Engineered for “Bluesky email scraper” use cases**: optimized around extracting emails from Bluesky bios and posts related to your keywords, and filtering them with `customDomains` (great for targeted outreach emails). - 🎯 **Better targeting with custom domains**: using domains like `@gmail.com` helps produce more relevant results for your **get emails from Bluesky** workflow. - 🧠 **Progress-aware reruns**: the actor persists progress (including a cursor and `seen_emails`) so reruns can be more efficient. - 💾 **Immediate structured saving**: each found email is pushed to the dataset right away, which helps if runs are interrupted. - 🔁 **Resilience on limited results**: includes logic to retry and stop when continuing is unlikely to improve results, supporting consistent **Bluesky contact scraper** outcomes. *** ### Best use cases - 📈 **Sales teams building a targeted outreach list**: Collect emails for **Bluesky outreach email list** campaigns based on niche-specific keywords. - 🎯 **Founders and startups doing partner outreach**: Find business contact emails by scanning public profile bios and posts tied to “founder” or similar themes. - 🧾 **Recruiters sourcing candidate networks**: Identify recruitment-relevant contacts using keyword-driven extraction and domain filtering. - 🔍 **Market researchers mapping creator niches**: Build a dataset of emails linked to creators/brands mentioned in public posts that match your research keywords. - 🧪 **Data analysts enriching lead lists**: Feed structured email records into downstream pipelines for segmentation and matching. - ⚙️ **Developers automating enrichment workflows**: Run **automated email scraping for Bluesky** on a schedule and ingest the JSON dataset into your systems. - 📣 **Content marketers scaling business discovery**: Use **Bluesky email collection software** to systematically discover contacts from public Bluesky profiles. *** ### Technical specifications - **Supported Input Formats** - ✅ `keywords` as an array (required) - ✅ `customDomains` as an array of email domains (e.g., `@gmail.com`) - ✅ `location` as a string (optional) - ✅ `platform` as `Bluesky` (optional; fixed by schema) - **Proxy Support** - ✅ Built-in proxy support via `proxyConfiguration` - ✅ Engine option: `cost-effective` or `legacy` (both support proxy-related behavior) - **Retry Mechanism** - ✅ Includes retries and fallbacks for resilience when results are limited or blocked - **Dataset Structure** - ✅ JSON records pushed per discovered email (`Actor.push_data`) - ✅ Deduplication via `seen_emails` - **Rate Limits & Performance** - ⚠️ Large searches or high `maxEmails` may take longer (actor input guidance notes this) - **Limitations** - ❌ Results depend on emails that are present in publicly available bios/posts that match your keywords and `customDomains` - ❌ Setting very high limits doesn’t guarantee reaching the exact count—extraction stops when `maxEmails` is reached or when results become unlikely *** ### FAQ #### Is Bluesky Email Scraper free to use? Apify actor pricing depends on your Apify account and the resources used during the run. You’ll see the actual cost estimate in Apify Console when you run **Bluesky Email Scraper**. #### Do I need to log in to use this actor? No special login steps are required to configure the actor inputs. If your Apify environment requires authentication for dataset storage or proxy access, that’s handled through Apify Console. #### What kinds of emails does Bluesky Email Scraper find? ✅ Bluesky Email Scraper extracts emails from publicly available sources where emails appear in Bluesky bios and posts related to your keywords, then filters them using your `customDomains` values. #### Can I scrape emails without specifying custom domains? Yes. You can keep the default `customDomains` (which includes `@gmail.com`) or set your own list to focus extraction on the domains you care about. #### What happens when I reach `maxEmails`? ❗ The scraper stops once the number of collected emails reaches your `maxEmails` limit, which helps control scraping time and cost. #### Can I run this at large scale? ✅ Yes, but large keyword searches or high email limits may take longer. The actor input description also suggests increasing the timeout in Run Options for larger runs. #### Does it avoid duplicates? ✅ Yes. The actor tracks `seen_emails` and will not push the same email address more than once into the dataset during the run. #### What about legal compliance and data privacy? ⚠️ You’re responsible for using the data in compliance with applicable laws and platform policies (including GDPR/CCPA where relevant). The actor only works with publicly accessible information. *** ### Support & feature requests If you have questions or want to improve your **Bluesky email scraper** experience, share feedback and ideas—we build these **Bluesky contact scraper** workflows to match real outreach needs. - 💡 **Feature Requests**: For example, ask for improvements like CSV export formats, additional output fields, or more flexible email filtering. - 📧 **Contact**: Reach out via . Your feedback directly shapes the roadmap for the **Bluesky Email Scraper**. *** ### Final thoughts *If you need the most comprehensive and SEO-optimized way to scrape Bluesky emails for lead generation, **Bluesky Email Scraper** is built to help you collect structured contacts from publicly available Bluesky bios and posts at scale.* *** ### Disclaimer **This tool accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected pages. You are responsible for complying with applicable laws and regulations (including GDPR/CCPA where relevant), as well as with platform terms of service and spam-related rules. Always use extracted contact information responsibly and ethically. For data removal requests, contact . # Actor input Schema ## `keywords` (type: `array`): A list of keywords to search for. ## `location` (type: `string`): Location to filter search results. ## `platform` (type: `string`): Select platform. ## `customDomains` (type: `array`): List of custom email domains ## `maxEmails` (type: `integer`): Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time. ## `engine` (type: `string`): Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE\_SERP proxy with traditional selectors - more reliable but slower and more expensive. ## `proxyConfiguration` (type: `object`): Configure proxies for this Actor. ## Actor input object example ```json { "keywords": [ "founder", "marketing" ], "location": "", "platform": "Bluesky", "customDomains": [ "@gmail.com" ], "maxEmails": 20, "engine": "cost-effective" } ``` # 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 = { "keywords": [ "founder", "marketing" ], "location": "", "customDomains": [ "@gmail.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/bluesky-email-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 = { "keywords": [ "founder", "marketing", ], "location": "", "customDomains": ["@gmail.com"], } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/bluesky-email-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 '{ "keywords": [ "founder", "marketing" ], "location": "", "customDomains": [ "@gmail.com" ] }' | apify call solid-scraper/bluesky-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/bluesky-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bluesky Email Scraper", "description": "🚀 Bluesky Email Scraper extracts verified emails from targeted Bluesky profiles by keyword and location. Perfect for lead gen, sales, and outreach teams seeking quality prospects fast. Start scraping in minutes—boost your pipeline today! 📈", "version": "0.0", "x-build-id": "6Nd7eX2ZLJPp3tBhm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~bluesky-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-bluesky-email-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/solid-scraper~bluesky-email-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-bluesky-email-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/solid-scraper~bluesky-email-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-bluesky-email-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "A list of keywords to search for.", "default": [ "founder", "marketing" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to filter search results.", "default": "" }, "platform": { "title": "Platform", "enum": [ "Bluesky" ], "type": "string", "description": "Select platform.", "default": "Bluesky" }, "customDomains": { "title": "Custom Email Domains", "type": "array", "description": "List of custom email domains", "default": [ "@gmail.com" ], "items": { "type": "string" } }, "maxEmails": { "title": "Max Emails", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time.", "default": 20 }, "engine": { "title": "Engine", "enum": [ "cost-effective", "legacy" ], "type": "string", "description": "Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE_SERP proxy with traditional selectors - more reliable but slower and more expensive.", "default": "cost-effective" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxies for this Actor." } } }, "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 } } } } } } } } } } ```