Skip to content

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

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/bluesky-single-posts/Open in Playground

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).

Terminal window
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
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlsstringyese.g. https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22dThe 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.
cursorstringno—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.
depthintegerno6Reply levels below the post (default 6). 0 = the post alone.
locked in cursor
parent_heightintegerno80Ancestors included as "parent" rows on page 1 when the post is a reply (default 80; 0 = none).
locked in cursor
max_repliesintegerno0Direct 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_indexbooleannotruetrue (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_sortstringnoapiapi (default - the AppView's order) | newest | oldest | top (likes, then replies), applied at every level.
apinewestoldesttop
locked in cursor
compute_metricsbooleannotruetrue (default) = getProfile on the author (page 1) -> author_followers_count, computed.engagement_rate, flags.pinned.
locked in cursor
estimate_reachbooleannotruetrue (default) = reposters + quoters follower counts (page 1) -> computed.estimated_reach.
locked in cursor
reach_max_amplifiersintegerno100Amplifiers resolved for estimated_reach. Capped at 100 so the call fits the timeout; past it the estimate is flagged partial.
locked in cursor
video_durationbooleannotruetrue (default) = a video post gets duration_seconds from its HLS playlist (page 1).
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen 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.
{
"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"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.rows.

FieldTypeExampleDescription
urlsstringhttps://bsky.app/profile/bsky.app/post/3mk4lz…—
post_uristringat://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…—
statusstringok—
notenullnull—
http_statusnullnull—
depthinteger6—
parent_heightinteger80—
reply_sortstringapi—
max_repliesinteger200—
pageinteger1—
page_sizeinteger50—
offsetinteger0—
next_offsetinteger49—
replies_totalinteger683—
has_morebooleantrue—
rowsarray[4 items]The results.
warningsarray[1 item]—
next_cursorstringeyJsayI6e30sIm8iOjQ5LCJwIjoxLCJwb3MiOjUwLCJyI…Pass back as cursor for the next page. null on the last page.
rows[].input_urlstringhttps://bsky.app/profile/bsky.app/post/3mk4lz…—
rows[].post_uristringat://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…—
rows[].row_typestringpost—
rows[].statusstringok—
rows[].notenullnull—
rows[].http_statusnullnull—
rows[].positioninteger1—
rows[].depthinteger0—
rows[].thread_indexnullnull—
rows[].parent_urinullnull—
rows[].root_uristringat://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…—
rows[].is_replybooleanfalse—
rows[].post_idstring3mk4lzkrnk22d—
rows[].uristringat://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsk…—
rows[].urlstringhttps://bsky.app/profile/bsky.app/post/3mk4lz…—
rows[].textstringv1.121 is live! We've increased the quality …—
rows[].published_atstring2026-04-23T19:39:35.560Z—
rows[].langsarray[1 item]—
rows[].author_handlestringbsky.app—
rows[].author_didstringdid:plc:z72i7hdynmk6r22z27h6tvur—
rows[].author_display_namestringBluesky—
rows[].like_countinteger7207—
rows[].reply_countinteger2110—
rows[].repost_countinteger1079—
rows[].quote_countinteger2077—
rows[].bookmark_countinteger0—
rows[].embed_typestringvideo—
rows[].media_urlsarray[1 item]—
rows[].thumbnail_urlstringhttps://video.bsky.app/watch/did%3Aplc%3Az72i…—
rows[].duration_secondsnumber17.3—
rows[].labelsarray[]—
rows[].flagsobject{…}—
rows[].postobject{…}—
rows[].thread_contextobject{…}—
rows[].computedobject{…}—
rows[].threadgatenullnull—
rows[].author_followers_countinteger34997628—
rows[].partialbooleantrue—
rows[].warningsarray[1 item]—
rows[].statsobject{…}—
rows[].scraped_atstring2026-09-22T10:51:34.102Z—

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. More in Pagination.

const url = "https://api.scrapier.io/api/v2/bluesky-single-posts/";
let params = { urls: "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.rows ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • 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.
  • Bluesky Profile Info — Structured Bluesky data: send handles. Single lookup, 1 credit per successful call.
  • Bluesky User Posts — Structured Bluesky data: send handles. Cursor-paginated, 1 credit per successful call.