# 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, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
$4.00 / 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.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## Bluesky Scraper — Profiles, Posts, Followers & Creator Leads
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?
Most Bluesky scrapers return a thin profile or a list of posts. This actor ships the **richest dataset in the category** and a real lead-gen layer on top:
| Data | Typical scrapers | This actor |
|---|---|---|
| Handle, display name, DID, avatar, banner | ✅ | ✅ |
| Followers / following / posts counts | partial | ✅ 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 | partial | ✅ |
| Followers & following mapping (audience mining) | ❌ | ✅ |
| Keyword **post** search (social listening) | rare | ✅ 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"]
}
```
### 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.
### 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.
### 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. searchUsers: find profiles by keyword. profiles: full details for specific handles. userPosts: a user's posts. followers / following: map a user's audience. searchPosts: keyword post search (needs the optional login below).
## `searchTerms` (type: `array`):
Keywords for searchUsers and searchPosts modes, e.g. photographer, indie game dev, climate. Each term is scraped separately.
## `actors` (type: `array`):
Bluesky users for profiles, userPosts, followers and following modes. Accepts handles (bsky.app, @nasa.gov), DIDs (did:plc:...), or profile URLs (https://bsky.app/profile/bsky.app). A bare username is treated as username.bsky.social.
## `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 searchPosts (keyword post search), which Bluesky restricts on the anonymous API. Your handle (e.g. you.bsky.social) 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 '' with your token
const client = new ApifyClient({
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 '' with your token.
client = ApifyClient("")
# 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapesage/bluesky-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Bluesky Scraper - Profiles, Posts, Followers & Leads",
"description": "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.",
"version": "1.0",
"x-build-id": "K92ybgaTkStltth0a"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~bluesky-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-bluesky-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapesage~bluesky-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-bluesky-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapesage~bluesky-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-bluesky-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"title": "Mode",
"enum": [
"searchUsers",
"profiles",
"userPosts",
"followers",
"following",
"searchPosts"
],
"type": "string",
"description": "What to scrape. searchUsers: find profiles by keyword. profiles: full details for specific handles. userPosts: a user's posts. followers / following: map a user's audience. searchPosts: keyword post search (needs the optional login below).",
"default": "searchUsers"
},
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "Keywords for searchUsers and searchPosts modes, e.g. photographer, indie game dev, climate. Each term is scraped separately.",
"items": {
"type": "string"
}
},
"actors": {
"title": "Handles / DIDs / profile URLs",
"type": "array",
"description": "Bluesky users for profiles, userPosts, followers and following modes. Accepts handles (bsky.app, @nasa.gov), DIDs (did:plc:...), or profile URLs (https://bsky.app/profile/bsky.app). A bare username is treated as username.bsky.social.",
"items": {
"type": "string"
}
},
"maxResultsPerQuery": {
"title": "Max results per query",
"minimum": 1,
"type": "integer",
"description": "Cap on records per search term or per actor (followers, posts, etc.). The actor paginates to reach this number.",
"default": 100
},
"enrichProfiles": {
"title": "Enrich discovered profiles (follower counts, etc.)",
"type": "boolean",
"description": "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.",
"default": true
},
"includePosts": {
"title": "Include recent posts per user",
"type": "boolean",
"description": "For searchUsers / profiles modes: also output each user's most recent posts as separate post records.",
"default": false
},
"maxPostsPerUser": {
"title": "Max posts per user",
"minimum": 1,
"type": "integer",
"description": "How many recent posts to fetch per user when 'Include recent posts' is on.",
"default": 20
},
"postFilter": {
"title": "Post filter (author feed)",
"enum": [
"posts_no_replies",
"posts_with_replies",
"posts_and_author_threads",
"posts_with_media"
],
"type": "string",
"description": "Which posts to include in userPosts / 'include recent posts'.",
"default": "posts_no_replies"
},
"enrichEmails": {
"title": "Crawl bio links for contact emails",
"type": "boolean",
"description": "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.",
"default": false
},
"identifier": {
"title": "Bluesky handle or email (optional)",
"type": "string",
"description": "Only needed for searchPosts (keyword post search), which Bluesky restricts on the anonymous API. Your handle (e.g. you.bsky.social) or account email."
},
"appPassword": {
"title": "Bluesky app password (optional)",
"type": "string",
"description": "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": {
"title": "Monitor mode (only emit new records)",
"type": "boolean",
"description": "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.",
"default": false
},
"monitorStoreName": {
"title": "Monitor state store name",
"type": "string",
"description": "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.",
"default": "bluesky-monitor"
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "How many search terms / actors to process in parallel.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy for outbound requests. The Bluesky API is reachable from datacenter IPs; the default Apify Proxy is fine and rotates IPs for higher throughput.",
"default": {
"useApifyProxy": true
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```