Skip to content

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

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

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

Terminal window
curl -G "https://api.scrapier.io/api/v2/bluesky-user-posts/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "handles=espn.com" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyesβ€”Your API key from the dashboard.
handlesstringyese.g. espn.comBluesky account: a handle ("espn.com", "@espn.com"), a profile URL (https://bsky.app/profile/espn.com), an at:// URI or a DID ("did:plc:x7d6j54pm22ufehkes6jo4jf") -> ONE native getAuthorFeed page (30 posts) per call in feed order, each row with the post's text, author, media, like / reply / repost / quote counts, the full post record + embed and the computed block (engagement_rate, language, content_category). An unknown / deactivated / taken-down / blocked account or an empty feed answers one status row (next_cursor null). Required on the first call; ignored when cursor is supplied. A raw Bluesky cursor (a v1 row's pagination.next_cursor) passed as cursor on the first call starts the walk there.
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.
filterstringnoposts_and_author_threadsposts_and_author_threads (default) | posts_no_replies | posts_with_replies | posts_with_media | posts_with_video - getAuthorFeed's own filter (applied by Bluesky after slicing, so a page can be shorter than 30).
posts_and_author_threadsposts_no_repliesposts_with_repliesposts_with_mediaposts_with_video
locked in cursor
include_pinsbooleannotruetrue (default) = the pinned post rides on top of page 1 (is_pinned_copy true, an extra item); false = chronological only.
locked in cursor
compute_metricsbooleannotruetrue (default) = getProfile on page 1 fills account_followers_count / account_posts_count and computed.engagement_rate (carried in the cursor for later pages).
locked in cursor
video_durationbooleannotruetrue (default) = video posts get duration_seconds from their HLS playlist.
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": {
"handles": "espn.com",
"handle": "espn.com",
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"filter": "posts_no_replies",
"include_pins": true,
"status": "ok",
"note": null,
"account_followers_count": 296583,
"account_posts_count": 872,
"page": 1,
"page_size": 30,
"cursor_sent": null,
"bluesky_cursor": "2025-09-25T17:06:11.912Z",
"has_more": true,
"posts": [
{
"input_handle": "espn.com",
"handle": "espn.com",
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"status": "ok",
"position": 1,
"post_id": "3muznlkmspz2x",
"uri": "at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3muznlkmspz2x",
"cid": "bafyreiceaay7jrgqznvxhttsmizofewx3mj6bwebjtz76nd2wh4hix4fty",
"url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x",
"text": "One more sleep until NFL football is BACK. 🏈",
"published_at": "2026-09-08T18:27:24.700Z",
"indexed_at": "2026-09-08T18:27:30.159Z",
"author_handle": "espn.com",
"author_did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"author_display_name": "ESPN",
"like_count": 85,
"reply_count": 8,
"repost_count": 11,
"quote_count": 6,
"bookmark_count": 0,
"is_pinned": false,
"is_pinned_copy": false,
"is_repost": false,
"is_reply": false,
"media_urls": [
"https://video.bsky.app/watch/.../playlist.m3u8"
],
"thumbnail_url": "https://video.bsky.app/watch/.../thumbnail.jpg",
"duration_seconds": 34.567,
"post": {
"id": "3muznlkmspz2x",
"url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x",
"content": {
"text": "One more sleep until NFL football is BACK. 🏈",
"...": "..."
},
"author": {
"username": "espn.com",
"display_name": "ESPN",
"verified": true,
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"...": "..."
},
"engagement": {
"views": null,
"likes": 85,
"comments": 8,
"shares": 11,
"saves": 0,
"quote_count": 6
},
"flags": {
"nsfw": false,
"spoiler": null,
"pinned": false,
"deleted": false
},
"published_at": "2026-09-08T18:27:24.700Z",
"record": {
"$type": "app.bsky.feed.post",
"...": "..."
},
"embed": {
"$type": "app.bsky.embed.video#view",
"...": "..."
},
"...": "(same shape as the v1 row)"
},
"computed": {
"engagement_rate": 0.0371,
"language": "en",
"content_category": "sports",
"estimated_reach": null
},
"category_keywords": [
"football",
"nfl"
],
"account_followers_count": 296583,
"account_posts_count": 872,
"filter": "posts_no_replies",
"pagination": {
"page": 1,
"cursor_sent": null,
"next_cursor": "2025-09-25T17:06:11.912Z",
"has_more": true
},
"scraped_at": "2026-09-22T08:47:10.412Z"
},
{
"position": 2,
"post_id": "3mpglmolczz2w",
"text": "Former Tennessee Titans and Arizona Cardinals running back Chris Johnson...",
"like_count": 129,
"reply_count": 16,
"repost_count": 33,
"quote_count": 17,
"...": "(same shape as row 1)"
},
"... 28 more rows (positions 3-30: 3mov4cob7hn2x, 3mnzrylb65e2d, ... 3lzogruhwz52e) ..."
],
"warnings": [],
"next_cursor": "eyJjIjoiMjAyNS0wOS0yNVQxNzowNjoxMS45MTJaIiwiaCI6ImVzcG4uY29tIiwibGsiOnsiZmlsdGVyIjoicG9zdHNfbm9fcmVwbGllcyJ9LCJwIjoxLCJwZiI6eyJkaWQiOiJkaWQ6cGxjOng3ZDZqNTRwbTIydWZlaGtlczZqbzRqZiIsImZvbGxvd2Vyc0NvdW50IjoyOTY1ODMsImhhbmRsZSI6ImVzcG4uY29tIiwicG9zdHNDb3VudCI6ODcyfSwicGluIjpudWxsLCJwb3MiOjMwLCJzIjpbImtlczZqbzRqZi8zbXV6bmxrbXNwejJ4Iiwia2VzNmpvNGpmLzNtcGdsbW9sY3p6MnciLCIuLi4iXX0"
}
}

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

FieldTypeExampleDescription
handlesstringespn.comβ€”
handlestringespn.comβ€”
didstringdid:plc:x7d6j54pm22ufehkes6jo4jfβ€”
filterstringposts_no_repliesβ€”
include_pinsbooleantrueβ€”
statusstringokβ€”
notenullnullβ€”
account_followers_countinteger296583β€”
account_posts_countinteger872β€”
pageinteger1β€”
page_sizeinteger30β€”
cursor_sentnullnullβ€”
bluesky_cursorstring2025-09-25T17:06:11.912Zβ€”
has_morebooleantrueβ€”
postsarray[3 items]The results.
warningsarray[]β€”
next_cursorstringeyJjIjoiMjAyNS0wOS0yNVQxNzowNjoxMS45MTJaIiwia…Pass back as cursor for the next page. null on the last page.
posts[].input_handlestringespn.comβ€”
posts[].handlestringespn.comβ€”
posts[].didstringdid:plc:x7d6j54pm22ufehkes6jo4jfβ€”
posts[].statusstringokβ€”
posts[].positioninteger1β€”
posts[].post_idstring3muznlkmspz2xβ€”
posts[].uristringat://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsk…—
posts[].cidstringbafyreiceaay7jrgqznvxhttsmizofewx3mj6bwebjtz7…—
posts[].urlstringhttps://bsky.app/profile/espn.com/post/3muznl…—
posts[].textstringOne more sleep until NFL football is BACK. πŸˆβ€”
posts[].published_atstring2026-09-08T18:27:24.700Zβ€”
posts[].indexed_atstring2026-09-08T18:27:30.159Zβ€”
posts[].author_handlestringespn.comβ€”
posts[].author_didstringdid:plc:x7d6j54pm22ufehkes6jo4jfβ€”
posts[].author_display_namestringESPNβ€”
posts[].like_countinteger85β€”
posts[].reply_countinteger8β€”
posts[].repost_countinteger11β€”
posts[].quote_countinteger6β€”
posts[].bookmark_countinteger0β€”
posts[].is_pinnedbooleanfalseβ€”
posts[].is_pinned_copybooleanfalseβ€”
posts[].is_repostbooleanfalseβ€”
posts[].is_replybooleanfalseβ€”
posts[].media_urlsarray[1 item]β€”
posts[].thumbnail_urlstringhttps://video.bsky.app/watch/.../thumbnail.jpgβ€”
posts[].duration_secondsnumber34.567β€”
posts[].postobject{…}β€”
posts[].computedobject{…}β€”
posts[].category_keywordsarray[2 items]β€”
posts[].account_followers_countinteger296583β€”
posts[].account_posts_countinteger872β€”
posts[].filterstringposts_no_repliesβ€”
posts[].paginationobject{…}β€”
posts[].scraped_atstring2026-09-22T08:47:10.412Zβ€”

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-user-posts/";
let params = { handles: "espn.com" };
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.posts ?? []));
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: filter, include_pins, compute_metrics, 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 Single Posts β€” Structured Bluesky data: send urls. Cursor-paginated, 1 credit per successful call.