# Bluesky Post, Search & Profile Scraper (`webdatatools/bluesky-scraper`) Actor

Bluesky Post, Search & Profile Scraper returns post text, engagement counts, images, profile bios, followers, follows and thread replies from Bluesky's public API — one row per item, no login required.

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

## Pricing

from $0.30 / 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.
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?

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

### What does Bluesky Post, Search & Profile Scraper do?

**Bluesky Post, Search & Profile Scraper** pulls posts, search results, profiles, followers, follows and thread replies from [Bluesky](https://bsky.app), the decentralized social network built on the AT Protocol. Reading a user's posts, profile, followers, follows or a thread needs nothing at all — it reads Bluesky's own public, unauthenticated AppView API (`public.api.bsky.app`), the same data Bluesky's website and mobile apps use, so there is no login, no cookie, no proxy and no anti-bot workaround involved. Full-text **search** is the one exception: Bluesky requires a signed-in session for it, so that mode needs an optional app password (never your main password — see Input below). Give it a handle, a search query or a post link and get back clean, flat rows ready for a spreadsheet, a BI tool or another Actor. Run it once from the Apify Console, on a schedule, or call it from your own code through the Apify API — with automatic retries, pagination and monitoring built in.

### Why use Bluesky Post, Search & Profile Scraper?

- **Social listening** — track every mention of your brand, product or competitor with the `search` mode, filtered by date range and sorted by recency or engagement.
- **Lead & influencer research** — pull an account's bio, follower count and recent posts before reaching out, or export a whole follower/following list for outreach lists.
- **Content monitoring** — watch a list of accounts (journalists, competitors, industry voices) for new posts without opening the app.
- **Conversation analysis** — fetch a viral post's full reply thread to measure sentiment or find the most engaged replies.
- **No credentials for most modes** — `posts`, `profile`, `followers`, `follows` and `thread` all read Bluesky's public mirror, no login required. Only `search` needs an app password, because Bluesky itself requires a signed-in session for full-text search.

### How to use Bluesky Post, Search & Profile Scraper

1. Click **Try for free** and open the **Input** tab.
2. Pick a **Mode**: `posts` (default) to read one or more accounts' own posts, `search` to search all public posts, `profile`/`followers`/`follows` for account data, or `thread` to expand one post's replies.
3. Fill in the field that mode needs — **Handles, DIDs or profile URLs** for `posts`/`profile`/`followers`/`follows`, **Search query** for `search`, or **Post URL** for `thread`.
4. `search` also needs **Bluesky handle or e-mail** and **App password** filled in — create an app password at [bsky.app](https://bsky.app) under **Settings -> App Passwords** (never enter your main account password).
5. Adjust **Max items** (rows per handle or query) and **Max concurrency** if needed, then click **Start**.
6. Export the results as JSON, CSV, Excel or HTML from the **Storage** tab, or pull them from the dataset through the API.

### Input

| Field | Type | Used by | Description |
| --- | --- | --- | --- |
| `mode` | enum | all | `posts` (default), `search`, `profile`, `followers`, `follows` or `thread` |
| `handles` | array | posts, profile, followers, follows | Handles, DIDs or `bsky.app/profile/...` URLs, e.g. `bsky.app` |
| `searchQuery` | string | search | Full-text search query, e.g. `web scraping` |
| `identifier` | string | search | Your Bluesky handle or e-mail, to sign in for search |
| `appPassword` | string (secret) | search | An [app password](https://bsky.app) for that account — not your main password |
| `postUrl` | string | thread | A `bsky.app/profile/<handle>/post/<rkey>` URL or an `at://` URI |
| `maxItems` | integer | all | Max rows per handle/query (1-5000, default 100) |
| `sort` | enum | search | `latest` (default) or `top` |
| `since` / `until` | string | search | Optional ISO 8601 date bounds |
| `maxConcurrency` | integer | posts, profile, followers, follows | Handles processed in parallel (default 3) |

#### Example input — posts (no credentials needed)

```json
{
    "mode": "posts",
    "handles": ["bsky.app", "jay.bsky.team"],
    "maxItems": 50
}
```

#### Example input — search (needs an app password)

```json
{
    "mode": "search",
    "searchQuery": "web scraping",
    "identifier": "yourname.bsky.social",
    "appPassword": "xxxx-xxxx-xxxx-xxxx"
}
```

Bluesky moved full-text search behind a signed-in session — `app.bsky.feed.searchPosts` rejects anonymous calls outright. Every other mode (`posts`, `profile`, `followers`, `follows`, `thread`) stays fully anonymous and never needs `identifier`/`appPassword`. If `search` runs without them, it returns one row with a clear `error` message instead of crashing.

### Output

Every mode produces one flat row per item in the default dataset. Posts (from `posts`, `search` and `thread`) and profiles (from `profile`, `followers` and `follows`) use two different but overlapping row shapes — unused fields come back `null` so both shapes can share one dataset.

#### Example output — a post row (`posts`/`search`/`thread`)

```json
{
    "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l",
    "cid": "bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq",
    "postUrl": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
    "text": "Bluesky is an open social network...",
    "createdAt": "2024-10-17T07:06:51.491Z",
    "authorHandle": "bsky.app",
    "authorDisplayName": "Bluesky",
    "likeCount": 63686,
    "repostCount": 9530,
    "replyCount": 8580,
    "quoteCount": 708,
    "hasImages": false,
    "isReply": false,
    "isRepost": false,
    "hashtags": [],
    "mentions": [],
    "query": "bsky.app",
    "error": null,
    "scrapedAt": "2026-09-13T01:11:00.000Z"
}
```

#### Example output — a profile row (`profile`/`followers`/`follows`)

```json
{
    "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
    "handle": "bsky.app",
    "displayName": "Bluesky",
    "description": "official Bluesky account",
    "followersCount": 34878893,
    "followsCount": 15,
    "postsCount": 863,
    "createdAt": "2023-04-12T04:53:57.057Z",
    "profileUrl": "https://bsky.app/profile/bsky.app",
    "query": "bsky.app",
    "error": null,
    "scrapedAt": "2026-09-13T01:11:00.000Z"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

### Data table

| Field group | Fields |
| --- | --- |
| Post identity | `uri`, `cid`, `postUrl`, `text`, `createdAt`, `langs` |
| Post author | `authorHandle`, `authorDid`, `authorDisplayName`, `authorAvatar` |
| Post engagement | `likeCount`, `repostCount`, `replyCount`, `quoteCount` |
| Post media | `hasImages`, `imageCount`, `imageUrls`, `externalLinkUrl`, `externalLinkTitle` |
| Post context | `isReply`, `replyToUri`, `replyToAuthorHandle`, `isRepost`, `hashtags`, `mentions` |
| Profile | `did`, `handle`, `displayName`, `description`, `avatar`, `banner` |
| Profile stats | `followersCount`, `followsCount`, `postsCount`, `createdAt`, `profileUrl` |
| Every row | `query`, `error`, `scrapedAt` |

### Pricing / Cost estimation

This Actor makes lightweight JSON calls to Bluesky's public API — no browser, no proxy required — so it runs comfortably on the smallest (1 GB) memory tier at roughly a few seconds per 100 rows. A typical run (a handful of handles, 100 items each) finishes in well under a minute of compute. Apify's free plan's monthly compute-unit allowance covers thousands of such runs.

### Tips or advanced options

- Raise **Max items** to page further back in a feed, search or follower list — pagination via Bluesky's `cursor` is handled automatically.
- Lower **Max concurrency** if you see errors while scraping many handles at once; Bluesky's public API is generous but not unlimited.
- `since`/`until` only affect `search` mode and only filter by post creation time, not indexing time.
- Create the **App password** at [bsky.app](https://bsky.app) -> Settings -> App Passwords, not your main account password — Apify stores it encrypted as a secret input field and this Actor never logs it.
- A failed handle or query never crashes the run — it produces one row with `error` set and every other field `null`, so a large batch always finishes.

### FAQ, disclaimers and support

This Actor only reads data Bluesky already serves through its own API — the same data anyone gets by opening a profile, search or thread in the app. Five of the six modes (`posts`, `profile`, `followers`, `follows`, `thread`) read Bluesky's public, unauthenticated mirror and need no credentials at all. `search` is the exception: Bluesky requires a signed-in session for full-text search, so that mode needs an app password — never your main account password, and this Actor never logs or stores it beyond the single sign-in call it makes on your behalf. This Actor does not post, follow or otherwise write to any account, and respects the rates Bluesky's API itself imposes. Handle counts and follower graphs can change between the moment you run this Actor and the moment you read the results. Found a bug or need a custom field? Open an issue on the Actor's **Issues** tab — custom modifications are available on request.

### Related Actors

Part of the **webdatatools** web-intelligence suite — every Actor is pay-per-event, runs without
proxies or a headless browser, and returns one clean row per entity:

**Website & domain intelligence**

- [Website Contact & Social Extractor](https://apify.com/webdatatools/contact-extractor) — e-mails, phones and social profiles per domain
- [Website Tech Stack Detector](https://apify.com/webdatatools/tech-stack-detector) — CMS, e-commerce, analytics, pixels and payments per domain
- [Domain DNS & Email Security Checker](https://apify.com/webdatatools/dns-email-security-checker) — SPF, DKIM, DMARC, MX provider, registrar and domain age
- [Domain Security Audit](https://apify.com/webdatatools/domain-security-audit) — TLS expiry, security headers, redirect chain, robots and llms.txt
- [Subdomain Finder (Certificate Transparency)](https://apify.com/webdatatools/subdomain-finder) — every subdomain seen in CT logs, with a live DNS check
- [Bulk Core Web Vitals & PageSpeed Audit](https://apify.com/webdatatools/core-web-vitals-audit) — Lighthouse scores, LCP, CLS, INP and top fixes per URL
- [On-Page SEO Audit](https://apify.com/webdatatools/seo-page-audit) — title, meta, headings, links, images and schema issues per page
- [Sitemap URL Extractor & Change Monitor](https://apify.com/webdatatools/sitemap-extractor) — every sitemap URL, or new and removed pages between runs
- [Wayback Machine Snapshot & Page Change Tracker](https://apify.com/webdatatools/wayback-page-diff) — how a page changed over time, or every archived snapshot

**Content for AI, LLMs and RAG**

- [AI Web Search & Read](https://apify.com/webdatatools/ai-web-search) — a query turned into clean Markdown from the top search results
- [Website to Markdown Crawler for LLM & RAG](https://apify.com/webdatatools/website-to-markdown) — any site as clean Markdown per page, no browser
- [Article & News Extractor](https://apify.com/webdatatools/article-extractor) — clean article text, author, date and Markdown per URL
- [Structured Data & JSON-LD Extractor](https://apify.com/webdatatools/structured-data-extractor) — Schema.org and Open Graph data from any page
- [Google News Scraper](https://apify.com/webdatatools/google-news-scraper) — news results by keyword, topic or site
- [Press Release Monitor](https://apify.com/webdatatools/press-release-monitor) — PR Newswire, Business Wire and GlobeNewswire releases

**Search, video and social**

- [Google Search Results Scraper](https://apify.com/webdatatools/google-search-scraper) — organic SERP results per keyword and country
- [YouTube Comments Scraper](https://apify.com/webdatatools/youtube-comments-scraper) — comments and replies with likes, no API key
- [YouTube Channel Latest Videos](https://apify.com/webdatatools/youtube-channel-videos) — the latest 15 videos of any channel from RSS
- [YouTube Channel Videos Scraper](https://apify.com/webdatatools/youtube-channel-scraper) — a channel's full video, shorts and stream list
- [YouTube Search Results Scraper](https://apify.com/webdatatools/youtube-search-scraper) — videos, channels and playlists per query
- [YouTube Video Details Scraper](https://apify.com/webdatatools/youtube-video-details) — views, likes, description, tags and chapters per video
- [Apple Podcasts Lookup & Episodes Scraper](https://apify.com/webdatatools/podcast-lookup) — podcast metadata and episodes from iTunes and RSS

**Leads, jobs and company data**

- [Company 360](https://apify.com/webdatatools/company-360) — one row per domain: contacts, tech, security, hiring and company facts
- [Hiring Signals Scraper](https://apify.com/webdatatools/hiring-signals) — open jobs and hiring velocity from 10 public ATS boards
- [Y Combinator Companies & Founders Scraper](https://apify.com/webdatatools/yc-companies-scraper) — YC startups by batch, industry and hiring status
- [Wikidata Entity & Company Enrichment](https://apify.com/webdatatools/wikidata-entity-enrichment) — HQ, founders, employees, revenue and social IDs per company
- [Bulk Email Validator](https://apify.com/webdatatools/email-validator) — syntax, MX, disposable, role and free-provider checks
- [OpenStreetMap POI Extractor](https://apify.com/webdatatools/overpass-poi-extractor) — shops and amenities by radius, bbox or area

**Developer, app and research data**

- [npm, PyPI & Crates.io Package Health Checker](https://apify.com/webdatatools/package-health-checker) — releases, downloads, deprecation and a health score
- [GitHub Repository Health & Activity Report](https://apify.com/webdatatools/github-repo-health) — stars, commits, contributors and risk flags per repo
- [VS Code Marketplace Extension Scraper](https://apify.com/webdatatools/vscode-marketplace-extensions) — installs, ratings and versions per extension
- [Chrome Web Store Extension Scraper](https://apify.com/webdatatools/chrome-web-store-extensions) — users, rating, version and developer per extension
- [Google Play Store Scraper](https://apify.com/webdatatools/google-play-scraper) — apps, ratings, installs, developer contact and reviews
- [App Store (iOS) App Metadata & Top Charts](https://apify.com/webdatatools/app-store-lookup) — ratings, price, version and charts per app
- [CrossRef DOI & Citation Metadata Lookup](https://apify.com/webdatatools/crossref-doi-lookup) — papers, authors, journals and citation counts
- [FDA Recalls & Adverse Events Monitor](https://apify.com/webdatatools/openfda-recall-monitor) — food, drug and device recalls from openFDA
- [iCal / ICS Calendar Feed to Events Extractor](https://apify.com/webdatatools/ical-calendar-extractor) — any public calendar feed as event rows
- [Shopify Store Products Scraper](https://apify.com/webdatatools/shopify-products-scraper) — catalog, prices, variants and stock per store

# Actor input Schema

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

Choose what to scrape. "posts" reads a user's own posts, "search" finds posts matching a query (requires an app password below — Bluesky's public search API needs a signed-in session), "profile"/"followers"/"follows" read account data, and "thread" reads one post and its replies.

## `handles` (type: `array`):

Enter one or more Bluesky handles, DIDs or bsky.app profile URLs, e.g. bsky.app, did:plc:z72i7hdynmk6r22z27h6tvur or https://bsky.app/profile/jay.bsky.team. Used by the "posts", "profile", "followers" and "follows" modes.

## `searchQuery` (type: `string`):

Enter the text to search for across all public posts, e.g. web scraping. Used by the "search" mode only — also requires the app password below.

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

Enter the Bluesky handle or e-mail of an account to sign in as, e.g. yourname.bsky.social. Only required for the "search" mode, because Bluesky's search API requires a signed-in session. Leave blank for every other mode. Pair with an App password below — never your main account password.

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

Enter an app password for the account above, e.g. xxxx-xxxx-xxxx-xxxx. Create one at bsky.app under Settings -> App Passwords — never enter your main account password here. Only required for the "search" mode.

## `postUrl` (type: `string`):

Enter one post's bsky.app URL (e.g. https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l) or its at:// URI. Used by the "thread" mode only, to fetch that post and its replies.

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

Enter the maximum number of rows to return per handle or per search query, e.g. 100. Raise this for bulk exports; lower it to keep runs quick.

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

Choose how search results are ordered: "latest" (newest first) or "top" (most engagement first). Used by the "search" mode only.

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

Enter an ISO 8601 date/time to only return posts created on or after it, e.g. 2026-01-01. Leave blank for no lower bound. Used by the "search" mode only.

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

Enter an ISO 8601 date/time to only return posts created before it, e.g. 2026-06-01. Leave blank for no upper bound. Used by the "search" mode only.

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

Enter how many handles or queries to process in parallel, e.g. 3. Raise this for long handle lists; lower it if you see errors.

## Actor input object example

```json
{
  "mode": "posts",
  "handles": [
    "bsky.app",
    "jay.bsky.team"
  ],
  "searchQuery": "web scraping",
  "identifier": "",
  "postUrl": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
  "maxItems": 100,
  "sort": "latest",
  "since": "",
  "until": "",
  "maxConcurrency": 3
}
```

# Actor output Schema

## `dataset` (type: `string`):

All scraped rows — download as JSON, CSV, Excel or HTML.

# 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 = {
    "mode": "posts",
    "handles": [
        "bsky.app",
        "jay.bsky.team"
    ],
    "searchQuery": "web scraping",
    "identifier": "",
    "postUrl": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
    "maxItems": 100,
    "sort": "latest",
    "since": "",
    "until": "",
    "maxConcurrency": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdatatools/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 = {
    "mode": "posts",
    "handles": [
        "bsky.app",
        "jay.bsky.team",
    ],
    "searchQuery": "web scraping",
    "identifier": "",
    "postUrl": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
    "maxItems": 100,
    "sort": "latest",
    "since": "",
    "until": "",
    "maxConcurrency": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("webdatatools/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 '{
  "mode": "posts",
  "handles": [
    "bsky.app",
    "jay.bsky.team"
  ],
  "searchQuery": "web scraping",
  "identifier": "",
  "postUrl": "https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l",
  "maxItems": 100,
  "sort": "latest",
  "since": "",
  "until": "",
  "maxConcurrency": 3
}' |
apify call webdatatools/bluesky-scraper --silent --output-dataset

```

## MCP server setup

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