# Bluesky Email Scraper (`scraper-mind/bluesky-email-scraper`) Actor

\[𝗖𝗵𝗲𝗮𝗽𝗲𝘀𝘁 𝗣𝗿𝗶𝗰𝗲] Bluesky Email Scraper is a powerful tool that extracts verified email addresses from websites in seconds. Ideal for lead generation and marketing, it helps you find targeted contacts effortlessly.

- **URL**: https://apify.com/scraper-mind/bluesky-email-scraper.md
- **Developed by:** [Scraper Mind](https://apify.com/scraper-mind) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 56 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 1.00 out of 5 stars

## Pricing

$10.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 - Fast, Accurate & Affordable

The **Bluesky Email Scraper** is a powerful tool designed to extract email addresses from Bluesky profiles and posts using custom keywords. Whether you're conducting outreach, social media marketing, or researching potential collaborations, this tool is **50% more affordable** than competitors, delivering reliable, high-quality results.

***

### 🌟 Key Features

- 🔍 **Custom Keyword Search**: Target Bluesky profiles and posts by searching with specific keywords to reach niche audiences.
- 📧 **Domain-based Email Extraction**: Extract email addresses from specific domains (e.g., @gmail.com, @yahoo.com) for focused email lists.
- 👤 **Complete Profile Information**: Collect profile names, URLs, bios, and related snippets for efficient outreach and marketing.
- 🔗 **Direct Bluesky Profile Links**: Gain direct access to Bluesky profiles for quicker engagement.
- ⚡ **Fast, Affordable, and Reliable**: Provides fast, accurate results at a fraction of the cost of competitors—**50% cheaper!**
- 🔄 **Automatic Pagination**: Easily handles large datasets with automatic pagination through search results.
- 📊 **Highly Scalable**: Works without proxies for smaller tasks, and supports **Datacenter, Residential, or Special Proxies** for large-scale scraping to avoid rate-limiting or blocking.

***

### 📥 Input

The Actor accepts the following JSON input:

```json
{
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "keyword": "digital marketing",
  "platform": "Bluesky",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

- **customDomains (required)**: Specify email domains to filter results (e.g., @gmail.com, @yahoo.com).
- **keyword (required)**: Search keyword related to Bluesky profiles or posts (e.g., "digital marketing").
- **platform**: Define the platform as Bluesky to ensure focused results.
- **proxyConfiguration (optional)**: For larger datasets, proxies can be used to avoid blocking. Use **Datacenter Proxies** first, and if needed, switch to **Residential or Special Proxies** for 100% success.

***

### 📤 Output

The scraper provides a dataset in JSON format with essential data about each extracted Bluesky profile or post:

```json
[
  {
    "title": "John Doe - Digital Marketing Expert | Bluesky",
    "description": "John Doe | Digital Marketing Expert | Helping businesses grow | Contact: john.doe@gmail.com",
    "url": "https://bsky.app/profile/johndoe",
    "email": "john.doe@gmail.com"
  },
  .....
]
```

Each result includes:

- **Title**: Profile title, typically including the user's name and related keywords.
- **Description**: A short snippet from the profile bio or post, giving context to the result.
- **URL**: Direct link to the Bluesky profile.
- **Email**: Extracted email address from the profile or post.

***

### 💻 How to Use

1. **Enter Keywords and Email Domains**: Input your desired keyword and email domains to filter the search results.
2. **Run the Scraper**: The scraper will perform Bluesky searches and extract relevant profiles or posts into your dataset.
3. **Set Up Proxies (optional)**: Use proxies for larger scraping tasks to prevent rate-limiting or blocking.
4. **Download and Use the Data**: Export your data in various formats like JSON, CSV, or Excel for easy use in outreach, analysis, or marketing.

***

### 💡 Best Use Cases

- 🎯 **Influencer Marketing**: Find influencers' email addresses for marketing campaigns.
- 📣 **Social Media Outreach**: Collect contact information to promote your products or services.
- 🔬 **Market Research**: Analyze Bluesky profiles within your target industry or niche.
- 🤝 **Business Collaborations**: Identify potential partners and reach out to them directly.

***

### 🆘 Support & Feedback

For any issues, bugs, or feature requests, please contact us through the **Issues** section. We're here to make sure the **Bluesky Email Scraper** works perfectly for your needs!

# 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.

## `perKeywordMaxContacts` (type: `boolean`):

ON (default): "Max Emails" is a target for EACH keyword, so the scraper keeps going through every keyword instead of stopping as soon as the first one fills up. OFF: "Max Emails" is a single total for the whole run. ⚠️ Heads-up: with this ON the run can collect (and be billed for) Max Emails × number of keywords, and takes proportionally longer.

## `perEmailExtensionMaxContacts` (type: `boolean`):

ON (default): "Max Emails" is a target for EACH custom email domain, so the scraper works through every extension instead of stopping once the first one fills up. OFF: extensions share one budget. ⚠️ Heads-up: with this ON the run can collect (and be billed for) Max Emails × number of email extensions, and takes proportionally longer.

## `proxyConfiguration` (type: `object`):

Configure proxies for this Actor.

## Actor input object example

```json
{
  "keywords": [
    "founder",
    "marketing"
  ],
  "location": "",
  "platform": "Bluesky",
  "customDomains": [
    "@gmail.com"
  ],
  "maxEmails": 20,
  "perKeywordMaxContacts": true,
  "perEmailExtensionMaxContacts": true
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by Bluesky Email Scraper, stored in the run's default dataset.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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("scraper-mind/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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("scraper-mind/bluesky-email-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 scraper-mind/bluesky-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper-mind/bluesky-email-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/18wknKnz4brzldzFe/builds/9JTOBbA1oTf7CAzil/openapi.json