# Bluesky Scraper: Posts, Search, Profiles & Followers (`scrape-smith/bluesky-posts-profiles`) Actor

Bluesky scraper for posts by keyword or hashtag, any user's feed, profiles, followers and follows via the official public AT Protocol (bsky) API. No browser, no cookies; optional app password fallback if Bluesky requires login for search. Export likes, reposts, replies and author data.

- **URL**: https://apify.com/scrape-smith/bluesky-posts-profiles.md
- **Developed by:** [Ryan Sofranko](https://apify.com/scrape-smith) (community)
- **Categories:** Social media, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

### What does Bluesky Scraper do?

Bluesky scraper for posts by keyword or hashtag, any user's feed, profiles, followers and follows via the official public AT Protocol (bsky) API. No browser, no cookies; optional app password fallback if Bluesky requires login for search. Export likes, reposts, replies and author data.

**Popular searches this actor answers:** Bluesky scraper, Bluesky API, bsky posts, Bluesky followers export, AT Protocol, social listening.

**Try it free:** the input is prefilled, so just click **Start** and you get real results in seconds for a fraction of a cent.

### What data does it return?

Real rows from a test run with the example input (truncated):

| type | authorHandle | text | likeCount | createdAt |
|---|---|---|---|---|
| post | unadhi.bsky.social | Build log, 22 Oct: yesterday we shipped 16 free guides on un… | 0 | 2026-10-22T05:14:08.438561Z |
| post | practical-ai-lab.bsky.social | Your price vs a competitor's price—on the FIRST run. PAL com… | 0 | 2026-10-22T00:16:07.084077114Z |
| post | ranovam.bsky.social | Greenhouse Jobs Scraper  Scrape any company's Greenhouse job… | 1 | 2026-10-21T18:00:32.190448Z |
| post | samuel.fm | 🔜 | 530 | 2026-10-21T18:44:55.442Z |
| post | pleasebegneiss.bsky.social | bluesky introduced me to a life without:  1) ads 2) catturd | 2486 | 2026-10-20T06:43:51.951Z |

Full JSON for one row:

```json
[
  {
    "type": "post",
    "source": "search:apify",
    "uri": "at://did:plc:xsjr57pfyudt6vkuna4eab2d/app.bsky.feed.post/3mygvrm2wo727",
    "cid": "bafyreiaiuvzyy6o5dv6vzz4giql3irxpijb5yjl7pmo3khptjohecwa3ly",
    "url": "https://bsky.app/profile/unadhi.bsky.social/post/3mygvrm2wo727",
    "text": "Build log, 22 Oct: yesterday we shipped 16 free guides on unadhi.com (CA firm GST and TDS sheets, GDPR sheets for EU AI tool users, store data sheets) and 4 com…",
    "createdAt": "2026-10-22T05:14:08.438561Z",
    "indexedAt": "2026-10-22T05:14:12.041Z",
    "langs": [
      "en"
    ],
    "authorHandle": "unadhi.bsky.social",
    "authorDid": "did:plc:xsjr57pfyudt6vkuna4eab2d",
    "authorDisplayName": "Unadhi",
    "likeCount": 0,
    "repostCount": 0,
    "replyCount": 0,
    "quoteCount": 0,
    "isReply": false,
    "replyParentUri": null,
    "hashtags": [],
    "links": [],
    "embedUrl": "https://unadhi.com/suite/?utm_source=bluesky&utm_medium=social&utm_campaign=bip",
    "imageUrls": [],
    "labels": []
  }
]
```

Download results as JSON, CSV, Excel, XML or HTML, call it via the Apify API, or connect it to Zapier, Make, n8n, Google Sheets and AI agents (Apify MCP server).

### Use cases

- Social listening and brand monitoring on Bluesky
- Hashtag and trend research
- Influencer discovery and follower export
- Datasets for NLP and sentiment analysis
- Archive your own posts

### How to use Bluesky Scraper

1. Open the actor and keep the prefilled example, or replace it with your own input.
2. Click **Start** and wait for the run to finish.
3. Export the dataset or fetch it via API.

#### Input

| Field | Description |
|---|---|
| `searchQueries` | Post search queries, one per line. Supports Bluesky search syntax: keywords, `#hashtag`, `"exact phrase"`, `from:handle.bsky.social`. |
| `sort` | Search order: `latest` = newest first, `top` = most engaged first. |
| `lang` | Optional language filter for search, ISO code such as `en`, `de`, `ja`. |
| `authorFeeds` | Handles whose own posts to export, e.g. `bsky.app` or `@user.bsky.social`. |
| `includeReplies` | Include the user's replies when exporting author feeds. |
| `profiles` | Handles or DIDs to fetch full profile rows for (bio, follower and post counts). |
| `followersOf` | Handles whose followers to export (one profile row per follower). |
| `followsOf` | Handles whose followed accounts to export. |
| `userSearch` | Keywords to search Bluesky users by name or bio, e.g. `data journalist`. |
| `maxItems` | Maximum items per query or handle (each post/profile is one billed row). Example: 100. |
| `onlyNewSince` | Only return posts created on or after this date (YYYY-MM-DD). |
| `handle` | Optional. Your Bluesky handle, only used with an app password if Bluesky refuses public search. |
| `appPassword` | Optional. Create at bsky.app > Settings > Privacy and security > App passwords. Never your main password. Used only as a fallback when a public request is refused. |

Example input:

```json
{
  "searchQueries": [
    "#buildinpublic"
  ],
  "maxItems": 20
}
```

### Login / app password

Everything works without login through Bluesky's public AppView API. Bluesky has at times restricted unauthenticated **post search**. If a request is refused (401/403), the actor retries with your handle + **app password** (never your main password) if you supplied them; otherwise it writes a free error row explaining what to add. Respect deletions: re-run to refresh rather than keeping deleted posts.

### Pricing

Pay per event: **$0.0005 per post or profile**. 1,000 posts = $0.50. Apify platform usage is included. Charged events: `post` (per post) and `profile` (per profile/follower row). Error rows are free. Set a max charge per run to cap cost; the actor stops cleanly when the limit is reached.

| Example job | Approx. cost |
|---|---|
| 20 posts | $0.01 |
| 1,000 posts | $0.50 |
| 10,000 followers | $5.00 |

### FAQ

#### Do I need a Bluesky account?

Usually no. Everything uses public endpoints; an app password is only a fallback if Bluesky restricts unauthenticated search.

#### Is this allowed?

It uses Bluesky's official public API. Respect users' deletions by refreshing data rather than keeping deleted posts.

#### Can I monitor a hashtag daily?

Yes, schedule it with `onlyNewSince`.

#### Is it legal to use this data?

The actor only reads public, official endpoints. You are responsible for using the data in line with the source's terms and applicable laws (e.g. GDPR for personal data).

### API example

```bash
curl -X POST "https://api.apify.com/v2/acts/scrape-smith~bluesky-posts-profiles/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H 'Content-Type: application/json' -d '{"searchQueries": ["#buildinpublic"], "maxItems": 20}'
```

### More Scrape-Smith actors

- [Wayback Machine Scraper](https://apify.com/scrape-smith/wayback-snapshots)
- [Shopify Products Scraper](https://apify.com/scrape-smith/shopify-products-feed)
- [Apple App Store Reviews Scraper](https://apify.com/scrape-smith/apple-app-store-reviews)
- [USPTO Trademark Status Lookup](https://apify.com/scrape-smith/uspto-trademark-status)
- [ATS Jobs Scraper](https://apify.com/scrape-smith/multi-ats-jobs-feed)
- [Apple Podcasts Scraper](https://apify.com/scrape-smith/apple-podcasts-scraper)
- [Steam Reviews Scraper](https://apify.com/scrape-smith/steam-reviews-scraper)

# Actor input Schema

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

Post search queries, one per line. Supports Bluesky search syntax: keywords, `#hashtag`, `"exact phrase"`, `from:handle.bsky.social`.

## `sort` (type: `string`):

Search order: `latest` = newest first, `top` = most engaged first.

## `lang` (type: `string`):

Optional language filter for search, ISO code such as `en`, `de`, `ja`.

## `authorFeeds` (type: `array`):

Handles whose own posts to export, e.g. `bsky.app` or `@user.bsky.social`.

## `includeReplies` (type: `boolean`):

Include the user's replies when exporting author feeds.

## `profiles` (type: `array`):

Handles or DIDs to fetch full profile rows for (bio, follower and post counts).

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

Handles whose followers to export (one profile row per follower).

## `followsOf` (type: `array`):

Handles whose followed accounts to export.

## `userSearch` (type: `array`):

Keywords to search Bluesky users by name or bio, e.g. `data journalist`.

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

Maximum items per query or handle (each post/profile is one billed row). Example: 100.

## `onlyNewSince` (type: `string`):

Only return posts created on or after this date (YYYY-MM-DD).

## `handle` (type: `string`):

Optional. Your Bluesky handle, only used with an app password if Bluesky refuses public search.

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

Optional. Create at bsky.app > Settings > Privacy and security > App passwords. Never your main password. Used only as a fallback when a public request is refused.

## Actor input object example

```json
{
  "searchQueries": [
    "#buildinpublic"
  ],
  "sort": "latest",
  "includeReplies": false,
  "maxItems": 20
}
```

# Actor output Schema

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

Results stored 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 = {
    "searchQueries": [
        "#buildinpublic"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrape-smith/bluesky-posts-profiles").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": ["#buildinpublic"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("scrape-smith/bluesky-posts-profiles").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": [
    "#buildinpublic"
  ],
  "maxItems": 20
}' |
apify call scrape-smith/bluesky-posts-profiles --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrape-smith/bluesky-posts-profiles"
        }
    }
}
```

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/VX5Imd5kFoepMfMRE/builds/ZI42R29B64BBo2UAE/openapi.json