# Bluesky Post Likes Scraper (`scrapingmonkey/bluesky-post-likes-scraper`) Actor

Collect the public accounts that liked Bluesky posts. Export paginated profile rows with handles, biographies, avatars, available like dates and source post links.

- **URL**: https://apify.com/scrapingmonkey/bluesky-post-likes-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

Find the public accounts that liked selected Bluesky posts and export one account per result. **Bluesky Post Likes Scraper** returns handles, names, biographies, avatar links and available like timestamps with the source post attached to every row.

Use post links you already have to build an engagement audience dataset for campaign reviews, community research or comparisons between announcements.

| At a glance | Details |
|---|---|
| 📥 Input | Add canonical https://bsky.app/profile/handle/post/record-key URLs or at:// post URIs. One post per item. |
| 📤 Output | One unique account that liked a source post |
| 📄 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 post likes scraper collects ❤️

The Actor paginates the public list of accounts that liked a source post. It collects the identities behind visible likes, making the output useful when a single engagement count is not enough.

Data can include:

- Liker DID, handle, display name and profile URL
- Biography, avatar, profile verification and other fields exposed in the like response
- Like creation time and indexing time when supplied
- Source post URI and canonical URL for joining rows to your post inventory

### How to collect post likes 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 **Likes** 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/post/3msqpuobiwk2t"
  ],
  "pagesPerPost": 1
}
```

`pagesPerPost` counts like-list pages independently for each submitted post. Each page requests up to 30 likes. One success row represents one distinct liking account for that source post.

### Bluesky post likes output fields 📦

| Field | Type | Meaning |
|---|---|---|
| `input` | string | Original submitted input, retained on success and failure. |
| `status` | string | `success` or `failed`. |
| `did` | string or null | Stable Bluesky account identifier. |
| `handle` | string or null | Current complete account handle. |
| `display_name` | string or null | Display name returned by the source. |
| `profile_url` | string or null | Canonical account profile URL. |
| `description` | string or null | Public biography or collection description, according to row type. |
| `avatar_url` | string or null | Profile or feed avatar URL. |
| `banner_url` | string or null | Profile banner URL when exposed. |
| `pronouns` | string or null | Profile pronouns when exposed. |
| `created_at` | string or null | Creation or publication time returned by the source. |
| `indexed_at` | string or null | Time the source indexed the record. |
| `followers_count` | integer or null | Profile follower count when present in this response. |
| `following_count` | integer or null | Profile following count when present in this response. |
| `posts_count` | integer or null | Profile post count when present in this response. |
| `verified_status` | string or null | Source verification state, when supplied. |
| `trusted_verifier_status` | string or null | Source trusted-verifier state, when supplied. |
| `labels` | array or null | Source label values. |
| `source_post_uri` | string or null | URI of the original post submitted for likes, reposts or quotes. |
| `source_post_url` | string or null | Canonical URL of the original submitted post. |
| `liked_at` | string or null | Like creation time when supplied. |
| `like_indexed_at` | string or null | Like indexing time when supplied. |

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/post/3msqpuobiwk2t",
  "status": "success",
  "source_post_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3msqpuobiwk2t",
  "source_post_url": "https://bsky.app/profile/did:plc:z72i7hdynmk6r22z27h6tvur/post/3msqpuobiwk2t",
  "did": "did:plc:b72ji7mqn7brlc3ycrp653zq",
  "handle": "frenziedstars.neocities.org",
  "profile_url": "https://bsky.app/profile/did:plc:b72ji7mqn7brlc3ycrp653zq",
  "labels": [],
  "verified_status": null,
  "trusted_verifier_status": null,
  "display_name": "Micah",
  "description": "★ he/they ★ queer ★\n\n🔞 18+ ONLY 🔞\n\nmostly at https://blorbo.social/@frenziedstars and https://frenziedstars.neocities.org/",
  "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:b72ji7mqn7brlc3ycrp653zq/bafkreid3othuku6frujkmr4npgmirju7ybd2xxo5azyrqntk4lxldourei",
  "banner_url": null,
  "pronouns": "he/they",
  "created_at": "2023-12-14T00:58:07.218Z",
  "indexed_at": "2026-07-17T16:51:30.064Z",
  "followers_count": null,
  "following_count": null,
  "posts_count": null,
  "liked_at": "2026-09-11T07:08:30.266Z",
  "like_indexed_at": "2026-09-11T07:08:30.266Z"
}
```

Complete failed dataset item:

```json
{
  "input": "   ",
  "status": "failed",
  "did": null,
  "handle": null,
  "display_name": null,
  "profile_url": null,
  "description": null,
  "avatar_url": null,
  "banner_url": null,
  "pronouns": null,
  "created_at": null,
  "indexed_at": null,
  "followers_count": null,
  "following_count": null,
  "posts_count": null,
  "verified_status": null,
  "trusted_verifier_status": null,
  "labels": null,
  "source_post_uri": null,
  "source_post_url": null,
  "liked_at": null,
  "like_indexed_at": 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 https://bsky.app/profile/handle/post/record-key URLs or at:// post URIs. One post per item. |
| `pagesPerPost` | 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`. |

Use canonical HTTPS post URLs such as `https://bsky.app/profile/bsky.app/post/3msqpuobiwk2t`, or an `at://ACCOUNT/app.bsky.feed.post/RECORD_KEY` URI. Profile links, plain handles, short record keys and links to other record types are invalid.

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 post likes use cases 🎯

#### Announcement audience research

Collect liking accounts from a public announcement and review their biographies and profile links. Keep the source post reference when adding the records to a research sheet.

#### Campaign response comparisons

Submit several post URLs and compare the returned audiences using DIDs. Likes on separate posts remain separate source-to-account records.

#### Repeated engagement snapshots

Schedule later runs to refresh the visible liker list. Compare saved snapshots yourself; the Actor does not label accounts as new or lost automatically.

### 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 post likes 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/post/3msqpuobiwk2t"],"pagesPerPost":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.

A post’s visible like count may exceed the number of public accounts returned within your page budget. Deleted, restricted or changing records can also create differences. Profile fields come from the like response and are not separately enriched.

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 ❓

#### Does it return a like count or the people who liked?

It returns the public accounts that liked the post, with one account per row. It is useful for audience analysis beyond the aggregate count.

#### Can I get the time of each like?

The output includes `liked_at` and `like_indexed_at` when Bluesky supplies those values. Missing values are null.

#### Will the number of rows equal the post’s like count?

Not necessarily. Your page budget, unavailable accounts, source changes and deduplication can all reduce the returned total.

#### 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 https://bsky.app/profile/handle/post/record-key URLs or at:// post URIs. One post per item.

## `pagesPerPost` (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/post/3msqpuobiwk2t"
  ],
  "pagesPerPost": 1
}
```

# Actor output Schema

## `likes` (type: `string`):

One unique account that liked a source post. 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/post/3msqpuobiwk2t"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapingmonkey/bluesky-post-likes-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/post/3msqpuobiwk2t"] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapingmonkey/bluesky-post-likes-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/9arGLMSIKQAGX9z0F/builds/3lGCzl2QBQheTxvOl/openapi.json