> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Bluesky Single Posts

Structured Bluesky data: send `urls`. Cursor-paginated, 1 credit per successful call.

`GET|POST https://api.scrapier.io/api/v2/bluesky-single-posts/` · 1 credit per successful call · Cursor-paginated

## Overview

Call `GET /api/v2/bluesky-single-posts/` with `urls`. The results are in `data.rows`; send `data.next_cursor` back as `cursor` to get the next page. 10 optional parameters refine the call (see Parameters).

## Request

```bash
curl -G "https://api.scrapier.io/api/v2/bluesky-single-posts/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "urls=https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d" \
  --max-time 210
```

```python
import requests

resp = requests.get(
    "https://api.scrapier.io/api/v2/bluesky-single-posts/",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"urls": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d"},
    timeout=210,
)
body = resp.json()
if not resp.ok:
    raise RuntimeError(body.get("error") or body.get("detail"))

print(body["data"]["rows"])
```

POST with a JSON body works too (same parameters; the body is merged over the query string).

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `X-API-Key` (header) | string | yes | — | Your API key. |
| `urls` | string | yes | e.g. `https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d` | The Bluesky post: its URL (https://bsky.app/profile/<handle\|did>/post/<rkey>), an at:// URI (at://<did\|handle>/app.bsky.feed.post/<rkey>) or a bare "<handle>/post/<rkey>" -> 50 rows per call over the flattened thread: page 1 = the post row (row_type "post": text, author, media, like / reply / repost / quote counts, full postView, computed {engagement_rate, language, content_category, estimated_reach}, stats) + its ancestors when it is a reply (row_type "parent") + the first replies in thread order (row_type "reply", depth, thread_index, parent_uri, root_uri); later pages = replies only. A deleted / not-found / blocked post answers one status row (next_cursor null). Required on the first call; ignored when `cursor` is supplied. |
| `cursor` | string | no | — | Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. |
| `depth` | integer | no | `6` | Reply levels below the post (default 6). 0 = the post alone. Locked in cursor. |
| `parent_height` | integer | no | `80` | Ancestors included as "parent" rows on page 1 when the post is a reply (default 80; 0 = none). Locked in cursor. |
| `max_replies` | integer | no | `0` | Direct replies to deliver. 0 (default) = 200 (the AppView's own cap, so the reply-index top-up only runs for threads the AppView shortened); an explicit value is capped at 500. Trimmed after reply_sort. Locked in cursor. |
| `reply_index` | boolean | no | `true` | true (default) = top up direct replies past the AppView's cap from the public reply index (constellation.microcosm.blue + getPosts); false = the thread call alone. Locked in cursor. |
| `reply_sort` | string | no | `api` | api (default - the AppView's order) \| newest \| oldest \| top (likes, then replies), applied at every level. One of: `api`, `newest`, `oldest`, `top`. Locked in cursor. |
| `compute_metrics` | boolean | no | `true` | true (default) = getProfile on the author (page 1) -> author_followers_count, computed.engagement_rate, flags.pinned. Locked in cursor. |
| `estimate_reach` | boolean | no | `true` | true (default) = reposters + quoters follower counts (page 1) -> computed.estimated_reach. Locked in cursor. |
| `reach_max_amplifiers` | integer | no | `100` | Amplifiers resolved for estimated_reach. Capped at 100 so the call fits the timeout; past it the estimate is flagged partial. Locked in cursor. |
| `video_duration` | boolean | no | `true` | true (default) = a video post gets duration_seconds from its HLS playlist (page 1). Locked in cursor. |
| `use_proxy` | boolean | no | `true` | Route the request through Scrapier's residential proxy pool. Default: `true`. Leave as is unless support tells you otherwise. |
| `raw_data` | boolean | no | `false` | When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. |

## Response

HTTP 200. Results are in `data.rows`. Sample from the live catalog, arrays trimmed to 3 items.

```json
{
  "success": true,
  "data": {
    "urls": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d",
    "post_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
    "status": "ok",
    "note": null,
    "http_status": null,
    "depth": 6,
    "parent_height": 80,
    "reply_sort": "api",
    "max_replies": 200,
    "page": 1,
    "page_size": 50,
    "offset": 0,
    "next_offset": 49,
    "replies_total": 683,
    "has_more": true,
    "rows": [
      {
        "input_url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d",
        "post_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
        "row_type": "post",
        "status": "ok",
        "note": null,
        "http_status": null,
        "position": 1,
        "depth": 0,
        "thread_index": null,
        "parent_uri": null,
        "root_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
        "is_reply": false,
        "post_id": "3mk4lzkrnk22d",
        "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
        "url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d",
        "text": "v1.121 is live!\n\nWe've increased the quality of photos in posts by doubling the max file size to 2MB and the resolution limit to 4000x4000. \n\nPlus, posts with multiple photos now appear in a carousel so you can show off your photography in all its glory.",
        "published_at": "2026-04-23T19:39:35.560Z",
        "langs": [
          "en"
        ],
        "author_handle": "bsky.app",
        "author_did": "did:plc:z72i7hdynmk6r22z27h6tvur",
        "author_display_name": "Bluesky",
        "like_count": 7207,
        "reply_count": 2110,
        "repost_count": 1079,
        "quote_count": 2077,
        "bookmark_count": 0,
        "embed_type": "video",
        "media_urls": [
          "https://video.bsky.app/watch/did%3Aplc%3Az72i7hdynmk6r22z27h6tvur/.../playlist.m3u8"
        ],
        "thumbnail_url": "https://video.bsky.app/watch/did%3Aplc%3Az72i7hdynmk6r22z27h6tvur/.../thumbnail.jpg",
        "duration_seconds": 17.3,
        "labels": [],
        "flags": {
          "nsfw": false,
          "pinned": false,
          "deleted": false
        },
        "post": {
          "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
          "author": {
            "handle": "bsky.app",
            "...": "..."
          },
          "record": {
            "$type": "app.bsky.feed.post",
            "...": "..."
          },
          "embed": {
            "$type": "app.bsky.embed.video#view",
            "...": "..."
          },
          "like_count": 7207,
          "reply_count": 2110,
          "repost_count": 1079,
          "quote_count": 2077,
          "id": "3mk4lzkrnk22d",
          "url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d",
          "flags": {
            "nsfw": false,
            "pinned": false,
            "deleted": false
          },
          "...": "(the postView verbatim, keys snake_cased)"
        },
        "thread_context": {},
        "computed": {
          "engagement_rate": 0.0356,
          "language": "en",
          "content_category": "other",
          "estimated_reach": 35288055
        },
        "threadgate": null,
        "author_followers_count": 34997628,
        "partial": true,
        "warnings": [
          "reach estimate covers 100 of 3156 amplifiers (reach_max_amplifiers=100)"
        ],
        "stats": {
          "requests": 15,
          "api_calls": 12,
          "video_lookups": 1,
          "index_calls": 1,
          "proxy": false,
          "replies_requested": 200,
          "replies_available": 2110,
          "replies_from_thread": 196,
          "replies_index_total": 2114,
          "replies_index_hidden": 4,
          "replies_from_index": 4,
          "reach_amplifiers_resolved": 100,
          "reach_truncated": true,
          "replies_total": 683,
          "replies_top_level": 200,
          "replies_max_depth": 6,
          "repliers": 516,
          "language_source": "post_text",
          "rows_total": 684,
          "elapsed_ms": 7490,
          "...": "..."
        },
        "scraped_at": "2026-09-22T10:51:34.102Z"
      },
      {
        "row_type": "reply",
        "status": "ok",
        "position": 2,
        "depth": 1,
        "thread_index": 0,
        "parent_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
        "root_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d",
        "is_reply": true,
        "post_id": "3mk6ipt5iv22y",
        "url": "https://bsky.app/profile/bsky.app/post/3mk6ipt5iv22y",
        "text": "We hear and appreciate your feedback on the photo carousel. We're going to put it back in the oven for now. ...",
        "author_handle": "bsky.app",
        "like_count": 4162,
        "reply_count": 425,
        "repost_count": 499,
        "quote_count": 574,
        "computed": null,
        "stats": null,
        "...": "(same keys as the post row)"
      },
      {
        "row_type": "reply",
        "status": "ok",
        "position": 3,
        "depth": 2,
        "thread_index": 1,
        "parent_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk6ipt5iv22y",
        "post_id": "3mk6ycvqfnk2p",
        "url": "https://bsky.app/profile/bloops.uk/post/3mk6ycvqfnk2p",
        "text": "You're looking very cute right now Bluesky.",
        "author_handle": "bloops.uk",
        "like_count": 2,
        "...": "..."
      }
    ],
    "warnings": [
      "reach estimate covers 100 of 3156 amplifiers (reach_max_amplifiers=100)"
    ],
    "next_cursor": "eyJsayI6e30sIm8iOjQ5LCJwIjoxLCJwb3MiOjUwLCJyIjoiYXQ6Ly9kaWQ6cGxjOno3Mmk3aGR5bm1rNnIyMnoyN2g2dHZ1ci9hcHAuYnNreS5mZWVkLnBvc3QvM21rNGx6a3JuazIyZCIsInMiOlsiMjdoNnR2dXIvM21rNmlwdDVpdjIyeSIsImxlbjZ5em1tLzNtazZ5Y3ZxZm5rMnAiLCIuLi4iXSwidSI6Imh0dHBzOi8vYnNreS5hcHAvcHJvZmlsZS9ic2t5LmFwcC9wb3N0LzNtazRsemtybmsyMmQifQ"
  }
}
```

## Response fields

| Field | Type | Example | Description |
|---|---|---|---|
| `urls` | string | `https://bsky.app/profile/bsky.app/post/3mk4lz…` |  |
| `post_uri` | string | `at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…` |  |
| `status` | string | `ok` |  |
| `note` | null | `null` |  |
| `http_status` | null | `null` |  |
| `depth` | integer | `6` |  |
| `parent_height` | integer | `80` |  |
| `reply_sort` | string | `api` |  |
| `max_replies` | integer | `200` |  |
| `page` | integer | `1` |  |
| `page_size` | integer | `50` |  |
| `offset` | integer | `0` |  |
| `next_offset` | integer | `49` |  |
| `replies_total` | integer | `683` |  |
| `has_more` | boolean | `true` |  |
| `rows` | array | `[4 items]` | The results. |
| `warnings` | array | `[1 item]` |  |
| `next_cursor` | string | `eyJsayI6e30sIm8iOjQ5LCJwIjoxLCJwb3MiOjUwLCJyI…` | Pass back as `cursor` for the next page. `null` on the last page. |
| `rows[].input_url` | string | `https://bsky.app/profile/bsky.app/post/3mk4lz…` |  |
| `rows[].post_uri` | string | `at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…` |  |
| `rows[].row_type` | string | `post` |  |
| `rows[].status` | string | `ok` |  |
| `rows[].note` | null | `null` |  |
| `rows[].http_status` | null | `null` |  |
| `rows[].position` | integer | `1` |  |
| `rows[].depth` | integer | `0` |  |
| `rows[].thread_index` | null | `null` |  |
| `rows[].parent_uri` | null | `null` |  |
| `rows[].root_uri` | string | `at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…` |  |
| `rows[].is_reply` | boolean | `false` |  |
| `rows[].post_id` | string | `3mk4lzkrnk22d` |  |
| `rows[].uri` | string | `at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…` |  |
| `rows[].url` | string | `https://bsky.app/profile/bsky.app/post/3mk4lz…` |  |
| `rows[].text` | string | `v1.121 is live! We've increased the quality …` |  |
| `rows[].published_at` | string | `2026-04-23T19:39:35.560Z` |  |
| `rows[].langs` | array | `[1 item]` |  |
| `rows[].author_handle` | string | `bsky.app` |  |
| `rows[].author_did` | string | `did:plc:z72i7hdynmk6r22z27h6tvur` |  |
| `rows[].author_display_name` | string | `Bluesky` |  |
| `rows[].like_count` | integer | `7207` |  |
| `rows[].reply_count` | integer | `2110` |  |
| `rows[].repost_count` | integer | `1079` |  |
| `rows[].quote_count` | integer | `2077` |  |
| `rows[].bookmark_count` | integer | `0` |  |
| `rows[].embed_type` | string | `video` |  |
| `rows[].media_urls` | array | `[1 item]` |  |
| `rows[].thumbnail_url` | string | `https://video.bsky.app/watch/did%3Aplc%3Az72i…` |  |
| `rows[].duration_seconds` | number | `17.3` |  |
| `rows[].labels` | array | `[]` |  |
| `rows[].flags` | object | `{…}` |  |
| `rows[].post` | object | `{…}` |  |
| `rows[].thread_context` | object | `{…}` |  |
| `rows[].computed` | object | `{…}` |  |
| `rows[].threadgate` | null | `null` |  |
| `rows[].author_followers_count` | integer | `34997628` |  |
| `rows[].partial` | boolean | `true` |  |
| `rows[].warnings` | array | `[1 item]` |  |
| `rows[].stats` | object | `{…}` |  |
| `rows[].scraped_at` | string | `2026-09-22T10:51:34.102Z` |  |

## Pagination

Pass `data.next_cursor` back as `cursor` until it is `null`. Required inputs are ignored once a cursor is sent. Each page is one billed call.

```python
import requests

URL = "https://api.scrapier.io/api/v2/bluesky-single-posts/"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}
params = {"urls": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d"}
items = []

for _ in range(10):  # each page is one billed call
    resp = requests.get(URL, headers=HEADERS, params=params, timeout=210)
    resp.raise_for_status()
    data = resp.json()["data"]
    items.extend(data.get("rows") or [])
    if not data.get("next_cursor"):  # None = last page
        break
    params = {"cursor": data["next_cursor"]}
```

## Errors

Failed calls are free. Branch on HTTP status; the message is in `error` (or `detail`). See https://docs.scrapier.io/errors.md

- **400** Bad input. The exact message varies by endpoint. `{"success":false,"error":"…"}`
- **402** Balance below the endpoint's price. `{"error":"Insufficient credits. Buy more to scrape more.","balance":1,"required":2}`
- **403** Invalid or unknown API key. `{"detail":"Authentication service unavailable or invalid API key."}`
- **429** Throttled — wait for Retry-After. `{"detail":"Request was throttled. Expected available in N seconds."}`
- **404** unknown slug · **503** busy (retry after `Retry-After`) · **5xx** upstream failure or timeout (retry with backoff).

## Notes

- Locked into the cursor: `depth`, `parent_height`, `max_replies`, `reply_index`, `reply_sort`, `compute_metrics`, `estimate_reach`, `reach_max_amplifiers`, `video_duration`. Set them on the first call; later pages reuse them.

## Related

- [Bluesky Profile Info](https://docs.scrapier.io/api-reference/bluesky/bluesky-profile-info.md): Structured Bluesky data: send `handles`. Single lookup, 1 credit per successful call.
- [Bluesky User Posts](https://docs.scrapier.io/api-reference/bluesky/bluesky-user-posts.md): Structured Bluesky data: send `handles`. Cursor-paginated, 1 credit per successful call.
