# Bluesky Scraper - Posts, Search and Profiles (`turboextract/bluesky-posts-profiles`) Actor

Bluesky posts by keyword search or account, with likes, reposts, replies, quotes, links and hashtags, plus people search with followers, bio, website and email. Uses the official public Bluesky API. No login.

- **URL**: https://apify.com/turboextract/bluesky-posts-profiles.md
- **Developed by:** [Moses Ndambuki](https://apify.com/turboextract) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 post or profile delivereds

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, Search and Profiles

**Search Bluesky posts by keyword, pull posts from any account, or find people by name or bio.** Posts come with likes, reposts, replies, quotes, links and hashtags. Profiles come with followers, following, post count, bio, websites and any email in the bio. Uses Bluesky's official public API, so there is no login and no blocking.

In one test, the actor returned 100 recent posts about web scraping, 24 posts from the Bluesky team account and 120 founder profiles in about 20 seconds.

***

### Who this is for

- **Social listening and PR teams** tracking brands, topics and hashtags on Bluesky
- **Marketers** finding creators and potential partners by bio and follower count
- **Sales teams** building lead lists of founders, agencies or journalists
- **Researchers** studying discussions, links shared and engagement
- **AI and data teams** collecting public posts with dates and language

***

### What you get

A post row:

```json
{
  "type": "post",
  "url": "https://bsky.app/profile/madewithlaravel.com/post/3n2luu4sosw2u",
  "text": "Laravel Scrapingbee is a PHP / Laravel library for web scraping...",
  "createdAt": "2026-11-18T15:31:24.650Z",
  "authorHandle": "madewithlaravel.com",
  "authorName": "MadeWithLaravel",
  "likes": 0,
  "reposts": 0,
  "replies": 0,
  "quotes": 0,
  "links": ["https://madewithlaravel.com/laravel-scrapingbee"],
  "hashtags": [],
  "query": "web scraping"
}
```

A profile row:

```json
{
  "type": "profile",
  "handle": "example.com",
  "displayName": "Example Co-Founder",
  "url": "https://bsky.app/profile/example.com",
  "description": "Co-founder of ... More info: linktr.ee/...",
  "followers": 354,
  "following": 301,
  "posts": 460,
  "websites": ["linktr.ee/..."],
  "emails": [],
  "customDomainHandle": true
}
```

***

### How it works

```mermaid
flowchart LR
    A[Search posts] --> D[Official Bluesky public API]
    B[Account handles] --> D
    C[Search people] --> D
    D --> E[Date, language and follower filters]
    E --> F[Post rows and profile rows]
```

***

### Quick start

1. Click **Try for free**.
2. Add **Search posts** like `web scraping` or `#buildinpublic`, **Accounts** like `bsky.app`, or **Search people** like `founder`.
3. Optional: set **Posted within (days)**, **Language** or **Minimum followers**.
4. Click **Start**, then export to CSV, JSON or Google Sheets.

#### API

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

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("Turboextract/bluesky-posts-profiles").call(run_input={
    "profileSearchQueries": ["marketing agency", "founder"],
    "minFollowers": 500,
})
for p in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(p["handle"], p["followers"], p["websites"])
```

***

### Input

| Field | Default | What it does |
|---|---|---|
| `searchQueries` | – | Post search. Bluesky syntax like `from:handle` works |
| `sort` | latest | Latest or top posts |
| `language` | – | Only posts in this language, like `en` |
| `handles` | – | Accounts whose posts you want |
| `includeReplies` | false | Include the account's replies |
| `profileSearchQueries` | – | Find people by name or bio |
| `minFollowers` | 0 | For people search |
| `postedWithinDays` | 0 (all) | Only recent posts |
| `maxResultsPerQuery` | 100 | Per search, account or people search |
| `maxResults` | 500 | Total cap per run |

***

### Pricing

**$0.003 per post or profile delivered.** 1,000 posts or profiles cost $3.

| Option | 1,000 rows |
|---|---|
| **Bluesky Scraper** | **$3**, posts, accounts and people in one actor |
| Other Bluesky actors on Apify | $1.50 to $5 |
| Social listening tools | $50+ a month |

***

### Use cases

- **Brand alerts**: your brand and product names, every hour
- **Creator discovery**: people search plus `minFollowers`, with websites from the bio
- **Lead lists**: founders, agencies or journalists with a website or email in their bio
- **Competitor watch**: every post from competitor accounts this month
- **Trend research**: hashtags and links shared on a topic

***

### Tips

- Without a login, Bluesky returns up to 100 posts per search query. Use several narrower queries for more, like one per hashtag or phrase.
- Handles with a custom domain (`customDomainHandle: true`) are often companies or professionals.
- Dedupe on `uri` for posts and `did` for profiles across scheduled runs.

***

### Pairs well with

- [Telegram Channel Scraper](https://apify.com/Turboextract/telegram-channel-scraper): public Telegram channel posts with views
- [Google News Scraper](https://apify.com/Turboextract/google-news-feed): news coverage of the same topics
- [B2B Lead Enrichment Pipeline](https://apify.com/Turboextract/b2b-lead-enrichment-pipeline): turn profile websites into company contacts

***

### FAQ

**Do I need a Bluesky account?** No. The actor uses Bluesky's official public API.

**How many posts can I get per search?** Up to 100 per query without a login. Account feeds go back much further.

**Where do emails come from?** Only from what people wrote in their own public bio.

**Does it include reposts?** Account feeds skip reposts of other people's posts, so you get what the account wrote.

**Is it legal?** It uses Bluesky's documented public API for public posts and profiles. Follow Bluesky's terms and privacy laws like GDPR when you contact people.

***

### Support

- Docs and examples: https://github.com/andersonjames38phd-cpu/bluesky-posts-profiles
- Community Discord: https://discord.gg/8SrXSCpvgj

Built and maintained by [Turboextract](https://apify.com/Turboextract) on the Apify platform.

# Actor input Schema

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

Keywords, hashtags or phrases. Bluesky search syntax works, like from:bsky.app or "exact phrase".

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

Order of post search results.

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

Only posts in this language code, like en, ja or pt. Empty for all.

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

Handles or profile links whose posts you want, like bsky.app or https://bsky.app/profile/jay.bsky.team.

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

Include the account's replies to others.

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

Find accounts by name or bio, like founder, journalist or marketing agency.

## `minFollowers` (type: `integer`):

Skip accounts with fewer followers.

## `postedWithinDays` (type: `integer`):

Only posts from the last N days. 0 means no limit.

## `maxResultsPerQuery` (type: `integer`):

Per search query, account or people search. Post search returns up to 100 posts per query without a login, so use several narrower queries for more.

## `maxResults` (type: `integer`):

Stop after this many rows in total. You only pay for what is delivered.

## Actor input object example

```json
{
  "searchQueries": [
    "web scraping"
  ],
  "sort": "latest",
  "language": "",
  "includeReplies": false,
  "minFollowers": 0,
  "postedWithinDays": 0,
  "maxResultsPerQuery": 100,
  "maxResults": 500
}
```

# Actor output Schema

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

Rows of type post (with engagement and links) and type profile (with followers, bio, websites and emails).

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

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

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

```

## MCP server setup

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