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

Scrape Bluesky without login: posts by keyword or hashtag, profiles with follower counts, every post of a profile, followers and following, and account search to find influencers.

- **URL**: https://apify.com/sndzcc/bluesky-scraper.md
- **Developed by:** [Sndz Data](https://apify.com/sndzcc) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 bluesky items

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 API: Posts, Profiles & Followers

Scrape **Bluesky** without an account or API key: **posts by keyword or #hashtag**, **profiles** with follower and post counts, every **post of a profile**, and their **followers and following**. You can also **search accounts** by name or bio to find creators, journalists or companies.

Straight from Bluesky's public API: fast, cheap and reliable. Pay per result.

### Why this one?

- **Everything in one Actor.** Search, profiles, user timelines, followers, following and account search, in one run.
- **Influencer finder.** Search accounts by topic and get follower counts, bios and websites, or add counts to every follower.
- **Engagement data.** Likes, reposts, replies and quotes on every post, plus hashtags, links, mentions, images and video.
- **No login, no risk.** No Bluesky account or app password needed.
- **Pay per result**, no start fee.

### Use cases

- **Brand monitoring and social listening:** what people say about your brand, product or topic on Bluesky.
- **Influencer and lead discovery:** accounts by niche with follower counts and websites.
- **Audience research:** who follows a competitor, a journalist or a community.
- **Research and journalism:** archive public posts and timelines for analysis.
- **AI and NLP:** clean post text for sentiment analysis, trends or training data.

### Input

| Field | What it does |
|---|---|
| **Search posts** | Keywords, phrases or #hashtags. Operators work: `from:handle`, `lang:es`, `"exact phrase"`. |
| **Search order** | Latest or Top. |
| **Profiles** | Handles or links. Each one comes with its follower, following and post counts. |
| **Profile posts / Include replies** | The profile's posts and reposts, newest first, optionally with replies. |
| **Followers / Following** | The profile's followers and the accounts it follows. |
| **Follower and post counts for followers** | Add counts to every follower and following row. |
| **Search accounts** | Find accounts by name or bio. |
| **Max items** | Limit per search term, per profile list and per account search. |
| **Posted since / Language** | Narrow down posts by date and language. |

```json
{
  "searchTerms": ["#buildinpublic", "apify"],
  "profiles": ["https://bsky.app/profile/bsky.app"],
  "followers": true,
  "detailedFollowers": true,
  "searchUsers": ["data journalism"],
  "maxItems": 500
}
```

### Output

Every item has a `type`: `post`, `profile`, `user` (from account search), `follower` or `following`.

```json
{
  "type": "post",
  "url": "https://bsky.app/profile/pyladies.com/post/3myrfhljs4s2u",
  "text": "PyLadies Around the World! This week we're featuring...",
  "createdAt": "2026-10-26T09:10:12.000Z",
  "authorHandle": "pyladies.com",
  "authorName": "PyLadies",
  "likes": 42,
  "reposts": 11,
  "replies": 3,
  "quotes": 1,
  "languages": ["en"],
  "hashtags": ["python"],
  "links": ["https://pyladies.com"],
  "images": ["https://cdn.bsky.app/img/feed_fullsize/..."],
  "isReply": false,
  "repostedBy": null,
  "searchTerm": "#python"
}
```

```json
{
  "type": "user",
  "url": "https://bsky.app/profile/data.ft.com",
  "handle": "data.ft.com",
  "displayName": "FT Visual & Data Journalism",
  "followers": 161799,
  "following": 512,
  "posts": 3400,
  "verified": true,
  "description": "The FT's team of reporters, statisticians, illustrators...",
  "website": null,
  "searchTerm": "data journalism"
}
```

### Good to know

- **Search returns up to 100 posts per term and run**: that's what Bluesky serves without logging in. Use several specific terms, the **Latest** order with **Posted since**, or schedule it hourly to collect everything over time. Profiles, timelines, followers and following have no such limit.
- Only public data is collected. Respect people's privacy and Bluesky's terms when you use it.

### Integrations

Schedule it and send new posts or followers to Google Sheets, Slack, Airtable, Zapier, Make, n8n or your own API.

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Fill in the input, or keep the example to see it working in seconds.
3. Click **Start** and wait for the run to finish.
4. Download the results as **Excel, CSV, JSON or HTML**, or get them through the Apify API.

### How much does it cost?

**$0.001 per result** ($1.00 per 1,000). No start fee, no monthly fee, and you only pay for the results saved to your dataset.

| Example | Cost |
|---|---|
| Followers of one account (2,000) | about $2.00 |
| Daily hashtag monitoring for a month | about $3.00 |

Apify's free plan includes monthly credit, so you can try it for free.

### FAQ

**Do I need a Bluesky account?**

No. It uses Bluesky's public API, with no login, app password or API key.

**How many posts does a search return?**

Up to 100 per term and run, which is what Bluesky serves without login. Profiles, timelines and followers have no limit.

**Can I find influencers in my niche?**

Yes. Use "Search accounts" with a topic and you get matching accounts with follower counts, bios and websites.

**Can I export followers?**

Yes. Turn on Followers (or Following) and add counts with "Follower and post counts for followers".

### More tools from Sndz Data

- [BORME Scraper API - Spain New Company Leads Daily](https://apify.com/sndzcc/borme-spain-companies): every new company registered in Spain, daily
- [App Store & Google Play Reviews Scraper API](https://apify.com/sndzcc/app-reviews-scraper): App Store and Google Play reviews in one run
- [Job Scraper API - Greenhouse, Lever, Ashby & Workable](https://apify.com/sndzcc/ats-jobs-scraper): all open jobs from Greenhouse, Lever, Ashby and more
- [Google News Scraper API - Articles with Real URLs](https://apify.com/sndzcc/google-news-scraper): news by keyword or topic, with real article URLs
- [Email & Contact Scraper API - Emails, Phones & Socials](https://apify.com/sndzcc/contact-details-scraper): emails, phones and social profiles from any website
- [Telegram Scraper API - Channel Posts, Views & Media](https://apify.com/sndzcc/telegram-channel-scraper): posts, views and media from public Telegram channels
- [Brand Monitoring API - Mentions Radar for News & Reddit](https://apify.com/sndzcc/brand-mentions-radar): brand mentions across 9 sources, with sentiment
- [AI Image Upscaler API - Upscale & Enhance Photos 4x](https://apify.com/sndzcc/ai-image-upscaler): upscale and enhance photos 4x with AI
- [Keyword Research API - Google, YouTube & Amazon Ideas](https://apify.com/sndzcc/keyword-ideas-machine): hundreds of keyword ideas from 5 search engines
- [Tech Stack Detector API - Wappalyzer & BuiltWith Alternative](https://apify.com/sndzcc/tech-stack-detector): the technologies behind any website, in bulk
- [Polymarket & Kalshi API - Prediction Market Odds](https://apify.com/sndzcc/prediction-markets-scraper): live odds from Polymarket and Kalshi in one dataset
- [WHOIS & Domain Lookup API - DNS, SSL & Availability](https://apify.com/sndzcc/domain-intel): WHOIS, availability, DNS and SSL for any list of domains
- [SEO Audit API - Broken Links, Meta Tags & Site Crawler](https://apify.com/sndzcc/seo-audit): SEO audit and broken link checker for any website
- [OCR API - Image & PDF to Text Extractor, 100+ Languages](https://apify.com/sndzcc/image-pdf-to-text): text from images and scanned PDFs, 100+ languages

### Support

Need another field or a new mode (likes, reposts, starter packs, feeds)? Open an issue on the **Issues** tab.

If this Actor saves you time, a quick ⭐ review helps a lot and keeps it maintained. Thank you!

# Actor input Schema

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

Keywords, phrases or #hashtags. Bluesky's search operators work: from:handle, lang:es, "exact phrase". Up to 100 posts per term and run.

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

Newest posts first, or the most engaging ones.

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

Handles or links (@name.bsky.social, https://bsky.app/profile/name, did:plc:...). You get each profile with its follower counts, plus the options below.

## `profilePosts` (type: `boolean`):

The posts and reposts of each profile, newest first.

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

Also the profile's replies to other people.

## `followers` (type: `boolean`):

The accounts that follow each profile.

## `following` (type: `boolean`):

The accounts each profile follows.

## `detailedFollowers` (type: `boolean`):

Add followers, following and post counts to every follower/following row. Great for finding influencers.

## `searchUsers` (type: `array`):

Find accounts by name or bio, e.g. data journalism, marketing agency, founder. Returned with follower counts.

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

Limit for each search term, each profile's posts, followers and following, and each account search.

## `postedSince` (type: `string`):

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

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

Only search results in this language, e.g. en, es, ja.

## Actor input object example

```json
{
  "searchTerms": [
    "#opensource"
  ],
  "sort": "latest",
  "profilePosts": true,
  "includeReplies": false,
  "followers": false,
  "following": false,
  "detailedFollowers": false,
  "maxItems": 100
}
```

# Actor output Schema

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

Posts with author, text, date, likes, reposts, replies, quotes, hashtags and link.

## `people` (type: `string`):

Profiles, accounts found by search, followers and following, with follower counts and bios.

## `allData` (type: `string`):

Every field of every item, including images, video, links, mentions and DIDs.

# 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": [
        "#opensource"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("sndzcc/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": ["#opensource"] }

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

```

## MCP server setup

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