# Bluesky Scraper – Posts, Profiles, Followers & Monitor (`nordic-data/bluesky-scraper`) Actor

Scrape Bluesky posts, profiles, threads and followers via the official public API. No login. Keyword/hashtag search, bio e-mails, monitor mode.

- **URL**: https://apify.com/nordic-data/bluesky-scraper.md
- **Developed by:** [Niklas Bergström](https://apify.com/nordic-data) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 posts

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/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 – Posts, Profiles, Followers & Monitor

Get Bluesky data as clean JSON, CSV or Excel **without a login, cookies or proxies**. The Actor uses Bluesky's own **official public API** (the AppView XRPC endpoints that power bsky.app), so runs are fast and reliable.

**What you can get**

| Input | Output |
|---|---|
| 🔎 **Search posts** by keyword, phrase or #hashtag, with Bluesky search operators (`from:`, `mentions:`, `domain:`), language and date range | Posts |
| 👤 **User feeds**: latest posts of any account (with or without replies, media only, reposts optional) | Posts |
| 🧵 **Threads**: a post plus its replies, most-liked first | Posts |
| 🪪 **Profiles** by handle or URL | Profiles |
| 🔍 **Search profiles** by name or bio keywords, e.g. "journalist", "founder stockholm" | Profiles |
| 👥 **Followers / following** of any account | Profiles |

Every **post** includes: URL, text, created time, language, author (handle, name, avatar), likes, reposts, replies, quotes, hashtags, mentioned accounts, links, images with alt text, video, link card, quoted post, reply parent and thread root.

Every **profile** includes: handle, DID, display name, bio, **e-mails and links found in the bio**, followers, following, posts count, join date, avatar, banner, verification and labels.

### Why this Actor

- **Cheap and fair:** $0.0009 per post, $0.0014 per profile. **No start fee**, and you never pay for duplicates, errors or already-seen items.
- **Monitor mode:** turn on *Only new*, schedule the task (e.g. hourly), and each run returns only posts or followers you haven't received before. Great for brand monitoring, keyword alerts and follower tracking.
- **Mix everything in one run:** searches, feeds, threads and profile lists together.
- **Official API:** no browser, no blocking, low memory (256 MB).

### Use cases

- Brand and competitor monitoring, social listening, sentiment analysis
- Lead generation: find journalists, founders, creators or agencies and their contact links
- Research datasets of public posts on a topic or hashtag
- Track new followers of your or a competitor's account

### Input examples

Latest English posts about AI:

```json
{"searchQueries": ["artificial intelligence", "#AI"], "searchSort": "latest", "language": "en", "maxItemsPerSource": 50, "includeReposts": false, "hydrateProfiles": true, "onlyNew": false}
```

Find marketing agencies and podcast hosts with their bio e-mails:

```json
{"profileSearchQueries": ["marketing agency", "podcast host"], "maxItemsPerSource": 25, "includeReposts": false, "hydrateProfiles": true, "onlyNew": false}
```

Hourly monitor of new mentions of your brand:

```json
{"searchQueries": ["\"my brand\"", "mybrand.com"], "searchSort": "latest", "onlyNew": true, "monitorId": "my-brand", "maxItemsPerSource": 500, "includeReposts": false, "hydrateProfiles": true}
```

### Output sample (post)

```json
{
  "recordType": "post",
  "url": "https://bsky.app/profile/example.bsky.social/post/3myz4jvjsnc22",
  "text": "An n8n template with one Apify node and one LLM node...",
  "createdAt": "2026-10-29T10:13:30.043Z",
  "langs": ["en"],
  "author": {"handle": "example.bsky.social", "displayName": "Example", "profileUrl": "https://bsky.app/profile/example.bsky.social"},
  "likeCount": 12, "repostCount": 3, "replyCount": 1, "quoteCount": 0,
  "hashtags": ["automation"], "links": ["https://apify.com"],
  "source": {"type": "search", "value": "apify"}
}
```

Errors (unknown handle, invalid URL) appear as free items with `recordType: "error"`. Run statistics are saved to the `RUN_STATS` key.

### Pricing

| Event | Price |
|---|---|
| Post | $0.0009 |
| Profile | $0.0014 |

1,000 posts cost $0.90. Set *Max charge per run* in run options to cap spending; the Actor stops cleanly at your limit.

### Limits and notes

- Bluesky's public search returns at most a few thousand results per query; split big topics into several queries or date ranges.
- Some hashtag searches don't support server-side date filters; the Actor then filters dates itself.
- Only public data is returned. Respect Bluesky's terms and privacy laws (e.g. GDPR) when you process personal data.
- Not affiliated with or endorsed by Bluesky Social PBC.

### FAQ

**Do I need a Bluesky account or app password?** No.

**Can I use it from Make, Zapier, n8n or an AI agent?** Yes, via the Apify API, integrations or the Apify MCP server.

# Changelog

This Actor's version history is a separate document: https://apify.com/nordic-data/bluesky-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords, phrases or hashtags. Bluesky search syntax works, e.g. <code>"climate tech"</code>, <code>#AI</code>, <code>from:bsky.app</code>, <code>domain:nytimes.com</code>, <code>mentions:alice.bsky.social</code>.

## `searchSort` (type: `string`):

Order of search results.

## `language` (type: `string`):

Only posts in this language (ISO code, e.g. en, sv, de). Applies to post search.

## `since` (type: `string`):

Only search results posted on/after this date (YYYY-MM-DD or ISO datetime).

## `until` (type: `string`):

Only search results posted before this date.

## `authorHandles` (type: `array`):

Get the latest posts of these accounts, e.g. <code>bsky.app</code>, <code>@nytimes.com</code> or <code>https://bsky.app/profile/bsky.app</code>.

## `authorFeedFilter` (type: `string`):

Which posts to take from user feeds.

## `includeReposts` (type: `boolean`):

Also return posts the account reposted (marked with repostedBy).

## `postUrls` (type: `array`):

Return the post and its replies, most-liked first. e.g. <code>https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l</code>.

## `threadDepth` (type: `integer`):

How many levels of nested replies to follow.

## `profileHandles` (type: `array`):

Look up these accounts: followers, posts count, bio, e-mails and links found in the bio.

## `profileSearchQueries` (type: `array`):

Find accounts by name, handle or bio keywords, e.g. <code>journalist</code>, <code>founder stockholm</code>.

## `followersOf` (type: `array`):

Return the followers of these accounts (newest first).

## `followingOf` (type: `array`):

Return the accounts these users follow.

## `hydrateProfiles` (type: `boolean`):

For profile search, followers and following, fetch full profiles (follower/post counts). Free; turn off only for speed.

## `maxItemsPerSource` (type: `integer`):

Cap per search query, user feed, thread or follower list.

## `maxItems` (type: `integer`):

Overall cap on charged results (0 = no cap besides the per-source cap and your max charge).

## `onlyNew` (type: `boolean`):

Schedule this task and get only posts / followers not returned in earlier runs of the same monitor. You only pay for new results.

## `monitorId` (type: `string`):

Optional name for the monitor state. Defaults to a fingerprint of the inputs.

## Actor input object example

```json
{
  "searchQueries": [
    "apify"
  ],
  "searchSort": "latest",
  "authorFeedFilter": "posts_no_replies",
  "includeReposts": false,
  "threadDepth": 6,
  "hydrateProfiles": true,
  "maxItemsPerSource": 100,
  "maxItems": 0,
  "onlyNew": false
}
```

# Actor output Schema

## `posts` (type: `string`):

Dataset items in the Posts view.

## `profiles` (type: `string`):

Dataset items in the Profiles view.

## `runStats` (type: `string`):

Counts of posts, profiles, duplicates, already-seen items, errors and HTTP requests.

# 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 = {
    "searchQueries": [
        "apify"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("nordic-data/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 = { "searchQueries": ["apify"] }

# Run the Actor and wait for it to finish
run = client.actor("nordic-data/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 '{
  "searchQueries": [
    "apify"
  ]
}' |
apify call nordic-data/bluesky-scraper --silent --output-dataset

```

## MCP server setup

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