# Bluesky Scraper - Profiles, Posts, Followers & Leads (`scrapesage/bluesky-scraper`) Actor

Scrape Bluesky (AT Protocol) with no login: search users by keyword, pull rich profiles with follower counts & verification, fetch posts, and map followers/following. Extracts bio emails & links for creator lead-gen. Monitor mode + JSON/CSV/Excel export.

- **URL**: https://apify.com/scrapesage/bluesky-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Social media, Lead generation, Agents
- **Features:** Limited permissions
- **Stats:** 7 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.10 / 1,000 result scrapeds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Bluesky Scraper - Profiles, Posts, Followers & Creator Leads

> **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Bluesky Social, PBC or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "Bluesky" is referenced only to describe the publicly available website this Actor collects data from.

Extract **complete Bluesky data** from the AT Protocol - **no login, no API key, no browser**. Search users by keyword, pull **rich profiles** (follower/following/post counts, verification, account age), fetch **posts** with full engagement, and map any account's **followers and following**. Every profile is turned into a **ready-to-contact lead**: emails and links parsed straight from the bio, an optional website crawl, social handles, and a 0–100 lead score.

Fast JSON extraction from Bluesky's own public AppView with 99%+ reliability.

### Why this Bluesky scraper?

This actor ships **a complete dataset** and a real lead-gen layer on top:

| Data | This actor |
| --- | --- |
| Handle, display name, DID, avatar, banner | ✅ |
| Followers / following / posts counts | ✅ always (auto-enriched) |
| Verification status & account age | ✅ |
| Bio **contact emails** | ✅ |
| Website / link-in-bio (incl. bare domains like `name.me`) | ✅ |
| **Emails crawled from the creator's website** | ✅ opt-in |
| Social links (Instagram, YouTube, TikTok, X, …) | ✅ |
| Lead score (0–100) per profile | ✅ |
| Posts with likes / reposts / replies / quotes + links | ✅ |
| Followers & following mapping (audience mining) | ✅ |
| Keyword **post** search (social listening) | ✅ opt-in (app password) |
| Monitor mode - only new posts / followers / users | ✅ |

### Use cases

- **Creator & influencer lead generation** - find people by niche (`searchUsers` → `photographer`, `crypto`, `ux designer`), get their reach, verification, and **contact email** straight from the bio or their linked website. Score them by audience size and contactability.
- **Audience mining** - pull the **followers** of a competitor, community, or thought leader and turn them into a targeted prospect list with `followers` mode.
- **Social listening & brand monitoring** - track every post mentioning your brand, product, or topic with `searchPosts`, then schedule it in monitor mode to capture only new mentions.
- **Account & content tracking** - watch specific accounts for new posts (`userPosts` + monitor mode) for competitive intelligence, PR, or newsletters.
- **Market & trend research** - measure follower growth, engagement, and topic activity across the fastest-growing open social network.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) - the free plan is enough to try this actor.
2. Open the **Bluesky Scraper**, pick a **mode**, and enter search terms or handles.
3. Click **Start** and watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS - or pull results via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "mode": "searchUsers",
    "searchTerms": ["photographer", "wedding photographer"],
    "maxResultsPerQuery": 200,
    "enrichProfiles": true,
    "enrichEmails": true,
    "includePosts": false
}
```

- **mode** - `searchUsers` (find profiles by keyword), `profiles` (details for specific handles), `userPosts` (an account's posts), `followers` / `following` (map an audience), or `searchPosts` (keyword post search - needs the optional login).
- **searchTerms** - keywords for `searchUsers` and `searchPosts`.
- **actors** - handles (`bsky.app`, `@nasa.gov`), DIDs (`did:plc:…`), or profile URLs for the `profiles`, `userPosts`, `followers`, and `following` modes.
- **maxResultsPerQuery** - cap per search term / per account (the actor paginates to reach it).
- **enrichProfiles** *(default true)* - fetch full profile detail (follower counts, verification) for every discovered/followed user.
- **includePosts / maxPostsPerUser / postFilter** - optionally attach each user's recent posts.
- **enrichEmails** *(default false)* - crawl each profile's website / link-in-bio for contact emails.
- **identifier + appPassword** *(optional)* - a Bluesky [App Password](https://bsky.app/settings/app-passwords) (never your main password) to unlock `searchPosts` keyword search.
- **monitorMode** *(default false)* - output only records not seen in previous runs.

### Output

One record per **profile** (`type: "profile"`) and per **post** (`type: "post"`):

```json
{
    "type": "profile",
    "did": "did:plc: ...",
    "handle": "janedoe.bsky.social",
    "url": "https://bsky.app/profile/janedoe.bsky.social",
    "displayName": "Jane Doe Photography",
    "description": "Wedding & portrait photographer ✷ NYC ✷ Bookings: hello@janedoe.com  janedoe.com",
    "createdAt": "2023-08-02T12:00:00.000Z",
    "accountAgeYears": 2.9,
    "followersCount": 18420,
    "followsCount": 640,
    "postsCount": 5123,
    "isVerified": true,
    "verifiedStatus": "valid",
    "bioEmails": ["hello@janedoe.com"],
    "bioLinks": ["https://janedoe.com"],
    "website": "https://janedoe.com",
    "socialLinks": { "instagram": "https://instagram.com/janedoephoto" },
    "contactEmails": ["bookings@janedoe.com"],
    "emails": ["hello@janedoe.com", "bookings@janedoe.com"],
    "leadScore": 78,
    "scrapedAt": "2026-06-16T01:00:00.000Z"
}
```

```json
{
    "type": "post",
    "uri": "at://did:plc:.../app.bsky.feed.post/3xyz",
    "url": "https://bsky.app/profile/janedoe.bsky.social/post/3xyz",
    "text": "New gallery from last weekend's wedding ✷",
    "createdAt": "2026-06-15T18:00:00.000Z",
    "authorHandle": "janedoe.bsky.social",
    "likeCount": 212,
    "repostCount": 18,
    "replyCount": 9,
    "quoteCount": 3,
    "langs": ["en"],
    "externalLink": "https://janedoe.com/galleries/spring",
    "hashtags": ["weddingphotography"],
    "links": ["https://janedoe.com/galleries/spring"]
}
```

### How much does it cost to scrape Bluesky?

This Actor uses Apify's **pay-per-event** pricing: you are charged only for the results it delivers, with no monthly rental and no start fee. The events it can charge are:

- **Result scraped** - One record written to the dataset – a Bluesky profile/lead (handle, follower & post counts, verification, bio emails, website, social links, lead score) or a post (text, engagement & links). No start fee; you only pay for results.

The current price of each event is shown on the **Pricing** tab of this page. Set a maximum total charge on the run if you want a hard cap on spend, and use the input limits to control how much the Actor fetches.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** - start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** - official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** - run it hourly/daily to track new mentions, new followers, or newly matching users; perfect for social listening and lead pipelines.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** - trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/bluesky-scraper').call({
    mode: 'searchUsers',
    searchTerms: ['indie game dev'],
    maxResultsPerQuery: 200,
    enrichEmails: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} Bluesky profiles & leads`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps - no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** - multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** - push new leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** - get notified when a monitored search finds new posts or followers.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** - auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** - pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** - trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** - ask your assistant to "find Bluesky photographers with over 10k followers and list their contact emails" and let it run this scraper for you.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready**: AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)**: an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp), with no account and no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)**: agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### More scrapers from scrapesage

Build a complete **creator & social lead-gen stack**:

- **[YouTube Scraper](https://apify.com/scrapesage/youtube-scraper)** - channels, videos, and creator contact leads.
- **[Telegram Scraper](https://apify.com/scrapesage/telegram-scraper)** - channels, messages, media, and search.
- **[Substack Scraper](https://apify.com/scrapesage/substack-scraper)** - newsletters, posts, and creator leads.
- **[Apple Podcasts Scraper](https://apify.com/scrapesage/apple-podcasts-scraper)** - shows, episodes, reviews, and host leads.
- **[Product Hunt Scraper](https://apify.com/scrapesage/product-hunt-scraper)** - launches, makers, and leads.
- **[GitHub Scraper](https://apify.com/scrapesage/github-scraper)** - repos, developers, and contact leads.
- **[Facebook Ad Library Scraper](https://apify.com/scrapesage/facebook-ad-library-scraper)** - competitor ad intelligence.
- **[LinkedIn Ad Library Scraper](https://apify.com/scrapesage/linkedin-ad-library-scraper)** - competitor B2B ads & creatives.

### Tips

- **Discovery first, enrich second**: `searchUsers` is the fastest way to build a niche list; turn on `enrichEmails` to add contact emails from each creator's website.
- **Audience mining**: run `followers` on a competitor or community account to harvest a warm, targeted prospect list.
- **Keyword post search**: `searchPosts` needs a Bluesky [App Password](https://bsky.app/settings/app-passwords) - create one (never use your main password) and paste it into `appPassword`. All other modes need no login.
- **Monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to capture only new posts, new followers, or newly matching users on every run.
- **Bare-domain bios**: many creators write their site as `name.me` with no `https://` - this actor still detects and (optionally) crawls it for emails.

### FAQ

**Do I need a Bluesky account or API key?** No. Everything except keyword post search uses Bluesky's public AppView with no login. Only `searchPosts` needs an App Password (which Bluesky restricts on the anonymous API).

**Where do the emails come from?** From the public profile bio, and - with `enrichEmails` on - from the creator's own linked website (the same pages a human visitor sees). Bluesky itself doesn't hide them; this actor just parses and (optionally) follows the links.

**Can I search posts by keyword?** Yes - set `mode: searchPosts` and supply `identifier` + `appPassword`. Without login, the public post-search endpoint returns HTTP 403, so the actor will tell you to add an App Password.

**Can I export to Google Sheets, CSV, or Excel?** Yes - one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I monitor new mentions or followers automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules); each run outputs only records not seen before. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or [Zapier zap](https://docs.apify.com/platform/integrations/zapier) to push them into your CRM.

**Is scraping Bluesky legal?** This actor collects publicly available data via Bluesky's own public API. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and Bluesky's terms.

**A field is null - why?** Some accounts genuinely don't set a website, email, or display name, and search results carry lighter data until `enrichProfiles` fills in the counts. Fields are `null` only when the data doesn't exist.

### Data & lawful use

This Actor reads only what Bluesky publishes to logged-out visitors: it does not log in, use cookies or session tokens, create accounts, or reach anything behind a sign-in. Names, handles, bios and engagement figures are public, but they relate to identifiable people, so treat the output as personal data. If you are in the EU or UK you are the data controller for what you do with it: have a lawful basis (usually legitimate interest for research, marketing analytics or B2B prospecting), honour access and deletion requests, and do not use the output for spam or unsolicited messaging.

Under [Apify's Standard Actor Contract](https://docs.apify.com/legal/standard-actor-contract), which governs your use of this Actor, you are the controller of any personal data in your input and output and scrapesage acts only as your processor: that data is processed solely to run your job, written only to your own Apify storage, never used for any other purpose and never shared onward. If you need help with a data-subject request that involves this Actor's output, open an issue on the Issues tab.

### Disclaimer

**This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Bluesky Social, PBC or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.**

"Bluesky" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official Bluesky product, is not authorised or certified by Bluesky Social, PBC, and does not distribute Bluesky software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome - this actor is actively maintained.

# Actor input Schema

## `mode` (type: `string`):

What to scrape. <b>searchUsers</b>: find profiles by keyword. <b>profiles</b>: full details for specific handles. <b>userPosts</b>: a user's posts. <b>followers</b> / <b>following</b>: map a user's audience. <b>searchPosts</b>: keyword post search (needs the optional login below).

## `searchTerms` (type: `array`):

Keywords for <b>searchUsers</b> and <b>searchPosts</b> modes, e.g. <code>photographer</code>, <code>indie game dev</code>, <code>climate</code>. Each term is scraped separately.

## `actors` (type: `array`):

Bluesky users for <b>profiles</b>, <b>userPosts</b>, <b>followers</b> and <b>following</b> modes. Accepts handles (<code>bsky.app</code>, <code>@nasa.gov</code>), DIDs (<code>did:plc:...</code>), or profile URLs (<code>https://bsky.app/profile/bsky.app</code>). A bare username is treated as <code>username.bsky.social</code>.

## `maxResultsPerQuery` (type: `integer`):

Cap on records per search term or per actor (followers, posts, etc.). The actor paginates to reach this number.

## `enrichProfiles` (type: `boolean`):

For searchUsers / followers / following: fetch each user's full profile (follower count, following count, post count, verification). Adds one batched lookup per 25 users. Turn off for a faster, lighter run.

## `includePosts` (type: `boolean`):

For searchUsers / profiles modes: also output each user's most recent posts as separate post records.

## `maxPostsPerUser` (type: `integer`):

How many recent posts to fetch per user when 'Include recent posts' is on.

## `postFilter` (type: `string`):

Which posts to include in userPosts / 'include recent posts'.

## `enrichEmails` (type: `boolean`):

Visit each profile's personal website / link-in-bio (Linktree, Beacons, Carrd, …) and extract contact emails. Bluesky bios often already contain a business email - this finds the rest. Adds a small fetch per profile that has a crawlable link.

## `identifier` (type: `string`):

Only needed for <b>searchPosts</b> (keyword post search), which Bluesky restricts on the anonymous API. Your handle (e.g. <code>you.bsky.social</code>) or account email.

## `appPassword` (type: `string`):

An App Password (format xxxx-xxxx-xxxx-xxxx) from Bluesky Settings → App Passwords. Used only to create a read session for searchPosts. Stored securely.

## `monitorMode` (type: `boolean`):

Remember records seen in previous runs (by post URI / profile DID) and output only NEW ones on each run. Pair with Apify Schedules to track new posts from accounts, new followers, or newly matching users. Complements (does not conflict with) the scheduler.

## `monitorStoreName` (type: `string`):

Named key-value store that holds the 'already seen' ids for monitor mode. Use different names to track different watchlists independently. Lowercase letters, digits and hyphens only.

## `maxConcurrency` (type: `integer`):

How many search terms / actors to process in parallel.

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

Proxy for outbound requests. The Bluesky API is reachable from datacenter IPs; the default Apify Proxy is fine and rotates IPs for higher throughput.

## Actor input object example

```json
{
  "mode": "searchUsers",
  "searchTerms": [
    "photographer"
  ],
  "actors": [
    "bsky.app"
  ],
  "maxResultsPerQuery": 100,
  "enrichProfiles": true,
  "includePosts": false,
  "maxPostsPerUser": 20,
  "postFilter": "posts_no_replies",
  "enrichEmails": false,
  "monitorMode": false,
  "monitorStoreName": "bluesky-monitor",
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

All scraped profile and post records as JSON items in the 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 = {
    "searchTerms": [
        "photographer"
    ],
    "actors": [
        "bsky.app"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["photographer"],
    "actors": ["bsky.app"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/bluesky-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 '{
  "searchTerms": [
    "photographer"
  ],
  "actors": [
    "bsky.app"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapesage/bluesky-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapesage/bluesky-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/VKKhvlndfmjMCmuWZ/builds/dM67hQjOJShAiEZGR/openapi.json