# Bluesky Feed Posts Scraper (`scrapingmonkey/bluesky-feed-posts-scraper`) Actor

Collect public posts from Bluesky custom feeds and curated list feeds. Export text, authors, engagement, dates and media with cursor pagination.

- **URL**: https://apify.com/scrapingmonkey/bluesky-feed-posts-scraper.md
- **Developed by:** [ScrapingMonkey](https://apify.com/scrapingmonkey) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

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?

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

Collect public publications from Bluesky custom feeds and curated list feeds. **Bluesky Feed Posts Scraper** accepts feed or list URLs and exports one post per row with text, authors, dates, engagement, media and source-feed context.

Start from a feed you already follow or a public list to create repeatable topic datasets, editorial samples and source-linked content archives.

| At a glance | Details |
|---|---|
| 📥 Input | Add canonical bsky.app/profile/handle/feed/key or bsky.app/profile/handle/lists/key HTTPS URLs, or matching at:// feed or list URIs. |
| 📤 Output | One unique publication per source feed or list |
| 📄 Pagination | Up to 30 source items per requested page |
| 🔐 Login required | No |
| ⚡ Processing | Up to 5 HTTP requests concurrently; up to 5 attempts for temporary failures |
| 💾 Delivery | One Apify dataset view with individual result rows, flattened object columns and complete nested JSON |

### What the Bluesky feed posts scraper collects 📰

The Actor recognizes custom feed and list-feed record types from your input and uses the corresponding public website request. Both sources produce the same post schema and the same dataset table.

Data can include:

- Post identifiers, canonical link, text, publication and indexing dates
- Visible engagement counts and author profiles
- Images, video playlist and thumbnail links, quoted content and external link previews
- Languages, hashtags, mentions, links and reply references
- Source type, URI, URL, name, description and creator where exposed
- Pinned and repost context supplied by the feed

| Source | Input | Result | Best for |
|---|---|---|---|
| `Custom feed input` | A /feed/ URL or feed URI | Posts selected by that feed | Topic or discovery feed research |
| `List input` | A /lists/ URL or list URI | Posts exposed by the list feed | A selected account-group feed |

### How to collect feed posts from Bluesky 🚀

1. Enter one or more supported inputs.
2. Choose a mode if available and set the page count for each input.
3. Start the Actor.
4. Open the **Posts** dataset view and review individual result rows.
5. Export the dataset or retrieve it from your application.

```json
{
  "inputList": [
    "https://bsky.app/profile/bsky.app/feed/whats-hot"
  ],
  "pagesPerFeed": 1
}
```

`pagesPerFeed` counts result pages independently for each feed or list. Each page requests up to 30 posts. Feed and list URLs can be mixed in one input list; the source type is detected from each record.

### Bluesky feed posts output fields 📦

| Field | Type | Meaning |
|---|---|---|
| `input` | string | Original submitted input, retained on success and failure. |
| `status` | string | `success` or `failed`. |
| `uri` | string or null | Stable AT publication URI. |
| `cid` | string or null | Content identifier for this version of the post. |
| `post_url` | string or null | Canonical URL of the returned publication. |
| `text` | string or null | Publication text. |
| `created_at` | string or null | Creation or publication time returned by the source. |
| `indexed_at` | string or null | Time the source indexed the record. |
| `like_count` | integer or null | Visible likes on the returned publication. |
| `repost_count` | integer or null | Visible repost count. |
| `reply_count` | integer or null | Visible reply count; replies themselves are not expanded. |
| `quote_count` | integer or null | Visible quote count. |
| `bookmark_count` | integer or null | Bookmark count only when exposed. |
| `author` | object or null | Author profile fields. |
| `languages` | array or null | Language tags supplied in the post record. |
| `hashtags` | array or null | Hashtags extracted from record tags and facets. |
| `mentioned_dids` | array or null | Mentioned account identifiers from text facets. |
| `links` | array or null | Link targets from text facets. |
| `reply_parent_uri` | string or null | Direct parent publication URI when this is a reply. |
| `reply_root_uri` | string or null | Root publication URI when this is a reply. |
| `labels` | array or null | Source label values. |
| `images` | array or null | Ordered image metadata: fullsize and thumbnail URLs, alt text and dimensions. |
| `video` | object or null | Video playlist URL, thumbnail, content identifier, alt text and dimensions. |
| `external` | object or null | External link preview URL, title, description and thumbnail. |
| `quote` | object or null | Embedded quoted-record reference, availability and exposed content. |
| `is_pinned` | boolean or null | Whether the feed response marks this entry as pinned. |
| `is_repost` | boolean or null | Whether the feed entry is a repost. |
| `reposted_at` | string or null | Feed-entry repost time when supplied. |
| `reposted_by` | object or null | Reposting profile when supplied by a feed entry. |
| `source_type` | string or null | Whether the source is a custom feed or list feed. |
| `source_uri` | string or null | Source feed or list URI. |
| `source_url` | string or null | Canonical source feed or list URL. |
| `source_name` | string or null | Source feed or list name. |
| `source_description` | string or null | Source feed or list description. |
| `source_creator` | object or null | Source creator profile when exposed. |

Nested objects keep the following fields. They appear as flattened columns in the single Store view; arrays stay together in their parent row:

- `author`: `did`, `handle`, `display_name`, `profile_url`, `description`, `avatar_url`, `banner_url`, `pronouns`, `created_at`, `indexed_at`, `followers_count`, `following_count`, `posts_count`, `verified_status`, `trusted_verifier_status`, `labels`.
- `images[]`: `fullsize_url`, `thumbnail_url`, `alt`, `width`, `height`.
- `video`: `playlist_url`, `thumbnail_url`, `cid`, `alt`, `width`, `height`.
- `external`: `url`, `title`, `description`, `thumbnail_url`.
- `quote`: `uri`, `cid`, `post_url`, `text`, `created_at`, `author`, `available`.
- `quote.author`: `did`, `handle`, `display_name`, `profile_url`, `description`, `avatar_url`, `banner_url`, `pronouns`, `created_at`, `indexed_at`, `followers_count`, `following_count`, `posts_count`, `verified_status`, `trusted_verifier_status`, `labels`.
- `reposted_by`: `did`, `handle`, `display_name`, `profile_url`, `description`, `avatar_url`, `banner_url`, `pronouns`, `created_at`, `indexed_at`, `followers_count`, `following_count`, `posts_count`, `verified_status`, `trusted_verifier_status`, `labels`.
- `source_creator`: `did`, `handle`, `display_name`, `profile_url`, `description`, `avatar_url`, `banner_url`, `pronouns`, `created_at`, `indexed_at`, `followers_count`, `following_count`, `posts_count`, `verified_status`, `trusted_verifier_status`, `labels`.

The successful examples below use normalized public response data. Values are snapshots rather than promises of current content or counts; every top-level output key is included.

Complete representative successful result:

```json
{
  "input": "https://bsky.app/profile/bsky.app/feed/whats-hot",
  "status": "success",
  "source_type": "feed",
  "source_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot",
  "source_url": "https://bsky.app/profile/did:plc:z72i7hdynmk6r22z27h6tvur/feed/whats-hot",
  "source_name": "Discover",
  "source_description": "Trending content from your personal network",
  "source_creator": {
    "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
    "handle": "bsky.app",
    "profile_url": "https://bsky.app/profile/did:plc:z72i7hdynmk6r22z27h6tvur",
    "labels": [],
    "verified_status": "none",
    "trusted_verifier_status": "valid",
    "display_name": "Bluesky",
    "description": "official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: support@bsky.app",
    "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka",
    "banner_url": null,
    "pronouns": null,
    "created_at": "2023-04-12T04:53:57.057Z",
    "indexed_at": "2025-10-27T21:05:26.152Z",
    "followers_count": null,
    "following_count": null,
    "posts_count": null
  },
  "uri": "at://did:plc:u2zs2typsklaohqmfyxiunvy/app.bsky.feed.post/3mv7syp7klc2z",
  "cid": "bafyreidw47rbcsrsps3osliklpcvjhtdlbkpikpuvtq4u2hm6mls553feq",
  "post_url": "https://bsky.app/profile/did:plc:u2zs2typsklaohqmfyxiunvy/post/3mv7syp7klc2z",
  "text": "Fucketyfucketyfuckfuckfuck´ by Annie Taylor from PEG - the Profanity Embroidery Group, Whitstable, UK, known for their stitching and swearing #WomensArt #FridayFeeling",
  "created_at": "2026-09-11T05:20:15.709Z",
  "indexed_at": "2026-09-11T05:20:17.963Z",
  "author": {
    "did": "did:plc:u2zs2typsklaohqmfyxiunvy",
    "handle": "womensartbluesky.bsky.social",
    "profile_url": "https://bsky.app/profile/did:plc:u2zs2typsklaohqmfyxiunvy",
    "labels": [],
    "verified_status": null,
    "trusted_verifier_status": null,
    "display_name": null,
    "description": null,
    "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:u2zs2typsklaohqmfyxiunvy/bafkreibjaljsx6h2jl264yss2bp3ji4zamzrvkskfhkz6hjni2ydietjvy",
    "banner_url": null,
    "pronouns": null,
    "created_at": "2024-11-12T10:01:39.805Z",
    "indexed_at": null,
    "followers_count": null,
    "following_count": null,
    "posts_count": null
  },
  "languages": [
    "en"
  ],
  "hashtags": [
    "WomensArt",
    "FridayFeeling"
  ],
  "mentioned_dids": [],
  "links": [],
  "labels": [],
  "reply_parent_uri": null,
  "reply_root_uri": null,
  "is_pinned": false,
  "is_repost": false,
  "reposted_at": null,
  "reposted_by": null,
  "images": [
    {
      "fullsize_url": "https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:u2zs2typsklaohqmfyxiunvy/bafkreicmchueabpkrhi7hgfwb7oekjzhjivkbuayekovc7ppo2xc5jccke",
      "thumbnail_url": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:u2zs2typsklaohqmfyxiunvy/bafkreicmchueabpkrhi7hgfwb7oekjzhjivkbuayekovc7ppo2xc5jccke",
      "alt": "Embroidery featuring two perched cute  blue birds among pink flowers surrounded by the embroidered text of the title",
      "width": 879,
      "height": 827
    }
  ],
  "video": null,
  "external": null,
  "quote": null,
  "like_count": 613,
  "repost_count": 139,
  "reply_count": 5,
  "quote_count": 8,
  "bookmark_count": 21
}
```

Complete failed dataset item:

```json
{
  "input": "   ",
  "status": "failed",
  "uri": null,
  "cid": null,
  "post_url": null,
  "text": null,
  "created_at": null,
  "indexed_at": null,
  "like_count": null,
  "repost_count": null,
  "reply_count": null,
  "quote_count": null,
  "bookmark_count": null,
  "author": null,
  "languages": null,
  "hashtags": null,
  "mentioned_dids": null,
  "links": null,
  "reply_parent_uri": null,
  "reply_root_uri": null,
  "labels": null,
  "images": null,
  "video": null,
  "external": null,
  "quote": null,
  "is_pinned": null,
  "is_repost": null,
  "reposted_at": null,
  "reposted_by": null,
  "source_type": null,
  "source_uri": null,
  "source_url": null,
  "source_name": null,
  "source_description": null,
  "source_creator": null
}
```

Each failed row preserves `input`, uses `status: failed`, and sets every other top-level field to `null`. The reason is written to the run log. Successful rows may contain null optional fields or empty arrays when the source does not supply a value. The dataset is not split into separate tables for media, authors, modes or failures.

### Input and pagination settings ⚙️

| Parameter | Type | Required | Default | Rules |
|---|---|---|---|---|
| `inputList` | array of strings | Yes | None | Add canonical bsky.app/profile/handle/feed/key or bsky.app/profile/handle/lists/key HTTPS URLs, or matching at:// feed or list URIs. |
| `pagesPerFeed` | integer | No | `1` | Number of result pages to attempt per input. Each page requests up to 30 items; actual public rows can be fewer. Bootstrap requests do not count as pages. Stops when the cursor ends or repeats. Minimum `1`. |

Accept `https://bsky.app/profile/ACCOUNT/feed/KEY` and `https://bsky.app/profile/ACCOUNT/lists/KEY`, or `at://` URIs using `app.bsky.feed.generator` or `app.bsky.graph.list`. A home-page URL, profile URL, starter-pack URL or keyword is not a feed input.

For supported website URLs, use the exact `https://bsky.app` host and canonical path without a query string or fragment. URLs from other hosts and unsupported record types are rejected. Handles are normalized; duplicate normalized inputs in the same mode are processed once. Different source inputs retain their own results, while repeated record identifiers within one input’s pagination are removed.

The first result request counts as page 1; resolving a handle or validating source metadata does not consume a result page. Pagination stops at the requested page count, a missing cursor or a repeated cursor. A short, empty or fully filtered page can still continue when it includes a usable next cursor. No exact result total is guaranteed.

### Bluesky feed posts use cases 🎯

#### Topic-feed research

Collect a selected custom feed and inspect returned text, authors and media. Treat its selection as the feed operator’s result set rather than a complete topic archive.

#### Editorial source monitoring

Use public list feeds to collect posts from a selected account group. Preserve source metadata while combining outputs in an editorial database.

#### Feed comparisons

Submit several feed or list inputs and compare their returned publications using post URIs. A post found in two source feeds stays associated with both sources.

### Pricing and saved-result behavior 💰

See the Actor’s **Pricing** tab for the active charging model and current rate. Store settings are separate from this local implementation, so this README does not state an unverified fixed price or runtime.

Under dataset-item pricing:

- Every unique record saved as `success` is one result for that source input. Nested author, media or profile fields do not become separate rows.
- An invalid or unavailable input, an exhausted temporary failure, or an input with no publicly available results within its page budget can save one `failed` row.
- Automatic retry attempts do not create extra dataset rows by themselves.
- A normal empty continuation after earlier successes creates no extra result row.
- More requested pages can produce more saved rows. Check the active listing for how saved failed rows are billed; they are not assumed to be free.

The final total depends on source availability, duplicate removal and the chosen page budget. Start with a small run and check its actual usage before selecting a larger budget.

### Bluesky feed posts API 🔌

Replace `$ACTOR_ID` with the identifier from this Actor’s **API** tab and `$APIFY_TOKEN` with your Apify token.

```bash
curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputList":["https://bsky.app/profile/bsky.app/feed/whats-hot"],"pagesPerFeed":1}'
```

Retrieve the default dataset through the Apify API or download JSON, CSV, Excel, XML and other formats available in the Console. Schedules, completion webhooks and Apify integrations can connect results to Google Sheets, Make, Zapier, n8n, cloud storage or your own backend. These are platform connection options, not integrations preconfigured by this Actor.

### Reliability, retries, and public-data limits ⚠️

The Actor uses pure HTTP collection with up to five requests concurrently. It does not launch a browser. Invalid syntax and confirmed missing, removed or inaccessible targets stop without unnecessary retries. Temporary network and proxy failures, timeouts, blocks, malformed responses, throttling and server errors are retried up to five total attempts.

Earlier successful pages remain saved if a later page fails. If no publicly available rows are found before the source ends or the selected page budget is reached, one failed row records that input; this does not mean the underlying account or collection necessarily does not exist. A later empty page after successes is normal exhaustion. A later request that exhausts retries can append a failed row while preserving earlier results.

Bluesky controls public availability and returned fields. Objects restricted from unauthenticated viewing are excluded; a restricted target produces a failed row. Deleted, suspended, unavailable or otherwise restricted records may be missing. Optional counts are not inferred from an incomplete sample, and media links may change or expire.

Custom feed operators control selection, ranking, availability and whether anonymous access works. A feed can return fewer posts, change order or go offline. A list-feed input returns posts, not list members. The Actor does not search arbitrary post keywords.

Three consecutive result pages were verified for every paginated mode in HTTP runs of the packaged Actor on September 11, 2026. These checks demonstrate working continuation on the tested sources and do not guarantee future source availability.

One invalid string inside an otherwise valid input list does not stop other inputs. A configuration that fails the input schema logs an input warning and exits without starting requests: for example, a list containing a number instead of a string, an unsupported mode or an invalid page-count type. Infrastructure failures such as startup errors, unavailable dataset storage or an unrecoverable result-save error can still stop the whole run. Result-save failures are not retried as fresh scraping requests.

### Frequently asked questions ❓

#### Can I mix feeds and lists?

Yes. The Actor identifies each input’s record type and stores all resulting publications in the same dataset view.

#### Does a list input export the list members?

No. It returns the publications in that list’s feed. Starter-pack member export is available in Bluesky Starter Pack Scraper.

#### Can I search posts by keyword?

No. Supply an existing feed or list URL. The Actor does not offer unrestricted post search.

#### Does it require Bluesky login or cookies?

No Bluesky login, password, session cookie or account token is accepted or required. The Actor uses HTTP requests used by the public website and respects restrictions on unauthenticated access.

#### What happens to invalid or unavailable inputs?

Invalid individual inputs are saved as failed rows without an HTTP request. Confirmed missing, removed or restricted targets also become failed rows without unnecessary retries. Temporary failures are retried up to five total attempts. Other inputs and already saved pages remain available.

#### Can I export results or automate collection?

Yes. Use the Apify dataset to download JSON, CSV, Excel, XML or other supported formats, or retrieve records through its API. Apify schedules and webhooks can connect repeated runs to your own workflow.

### Support, responsible use, and related actors 🛟

For a reproducible problem, open an issue in the Actor’s **Issues** tab. Include the run ID, approximate time, mode if relevant, page count, safe public input, expected result and actual result. Do not share access tokens, proxy credentials or other secrets.

Use public data responsibly and follow applicable privacy, copyright, contractual and platform requirements before storing, combining or redistributing collected information.

# Actor input Schema

## `inputList` (type: `array`):

Add canonical bsky.app/profile/handle/feed/key or bsky.app/profile/handle/lists/key HTTPS URLs, or matching at:// feed or list URIs.

## `pagesPerFeed` (type: `integer`):

Number of result pages to attempt per input. Each page requests up to 30 items; actual public rows can be fewer. Bootstrap requests do not count as pages. Stops when the cursor ends or repeats.

## Actor input object example

```json
{
  "inputList": [
    "https://bsky.app/profile/bsky.app/feed/whats-hot"
  ],
  "pagesPerFeed": 1
}
```

# Actor output Schema

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

One unique publication per source feed or list. Failed rows preserve the original input.

# 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 = {
    "inputList": [
        "https://bsky.app/profile/bsky.app/feed/whats-hot"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapingmonkey/bluesky-feed-posts-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 = { "inputList": ["https://bsky.app/profile/bsky.app/feed/whats-hot"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapingmonkey/bluesky-feed-posts-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 '{
  "inputList": [
    "https://bsky.app/profile/bsky.app/feed/whats-hot"
  ]
}' |
apify call scrapingmonkey/bluesky-feed-posts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapingmonkey/bluesky-feed-posts-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/s4iNkG3X79QNJHn7X/builds/3rAfJTtCQzC0hHbVP/openapi.json