Skip to content

Structured Bluesky data: send handles. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/bluesky-profile-info/Open in Playground

Call GET /api/v2/bluesky-profile-info/ with handles. The results are in data.profile. 8 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/bluesky-profile-info/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "handles=bsky.app" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
handlesstringyese.g. bsky.appThe Bluesky account: a handle ("espn.com", "@espn.com"), a profile URL (https://bsky.app/profile/espn.com, any host with the /profile/<actor> path), a DID ("did:plc:..", "did:web:..") or an at:// URI -> ONE profile record (did, handle, display_name, bio, avatar_url, banner, verified, followers, following, posts_count, likes_count, joined_at, labels, associated / verification blocks) + computed{engagement_rate, language, content_category, estimated_reach}. Single lookup: next_cursor is always null. An unknown / deactivated / taken-down account answers a status record (not_found | account_deactivated | account_takedown | invalid_input).
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.
compute_metricsbooleannotruetrue (default) = sample the latest feed_sample original posts for computed.language / engagement_rate / content_category and resolve the amplifiers of the newest reach_sample posts for computed.estimated_reach. false = profile only (1 request; engagement_rate / estimated_reach null, language and category from the bio).
locked in cursor
feed_sampleintegerno30Original posts sampled for the computed block (1..100, default 30).
locked in cursor
reach_sampleintegerno5Newest sampled posts whose reposters / quoters are resolved for estimated_reach. Capped at 5 so the call fits the timeout; 0 = skip.
locked in cursor
amplifier_pagesintegerno1Pages of 100 reposters / quoters read per sampled post before extrapolating. Capped at 1.
locked in cursor
count_likesbooleannotruetrue (default) = walk the post history (100 posts a call) and sum likeCount -> likes_count (likes received). false = likes_count null.
locked in cursor
likes_max_postsintegerno1000Cap on the likes walk. Capped at 1000 (= 10 calls): past it likes_count is a lower bound (stats.likes_count_complete false + warning).
locked in cursor
page_fallbackbooleannotruetrue (default) = bsky.app og-meta partial profile when the AppView is unreachable; false = status fetch_failed.
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",
"profile": {
"input_handle": "espn.com",
"handle": "espn.com",
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"status": "ok",
"note": null,
"http_status": 200,
"id": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"username": "espn.com",
"display_name": "ESPN",
"avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie",
"bio": "Serving sports fans. Anytime. Anywhere.",
"verified": true,
"followers": 296582,
"following": 32,
"posts_count": 872,
"likes_count": 220484,
"url": "https://bsky.app/profile/espn.com",
"joined_at": "2024-11-25",
"associated": {
"lists": 0,
"feedgens": 0,
"starter_packs": 0,
"labeler": false,
"activity_subscription": {
"allow_subscriptions": "followers"
}
},
"labels": [],
"verification": {
"verifications": [
{
"issuer": "did:plc:z72i7hdynmk6r22z27h6tvur",
"issuer_display_name": "Bluesky",
"issuer_handle": "bsky.app",
"uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f",
"is_valid": true,
"created_at": "2025-04-21T10:44:20.398Z"
}
],
"verified_status": "valid",
"trusted_verifier_status": "none"
},
"indexed_at": "2024-12-19T20:49:48.843Z",
"computed": {
"engagement_rate": 0.0512,
"language": "en",
"content_category": "sports",
"estimated_reach": 438639
},
"partial": false,
"warnings": [],
"stats": {
"requests": 28,
"retries": 0,
"api_calls": 28,
"page_loads": 0,
"proxy": true,
"source": "api",
"posts_sampled": 30,
"feed_sample": 30,
"reach_posts_sampled": 5,
"amplifiers_resolved": 174,
"likes_posts_scanned": 872,
"likes_count_complete": true,
"language_source": "post_text+langs",
"category_keywords": [
"espn",
"sports"
]
},
"duration_ms": 17756,
"scraped_at": "2026-09-22T08:31:44.102Z"
},
"next_cursor": null
}
}

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

FieldTypeExampleDescription
handlesstringespn.com—
profileobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
profile.input_handlestringespn.com—
profile.handlestringespn.com—
profile.didstringdid:plc:x7d6j54pm22ufehkes6jo4jf—
profile.statusstringok—
profile.notenullnull—
profile.http_statusinteger200—
profile.idstringdid:plc:x7d6j54pm22ufehkes6jo4jf—
profile.usernamestringespn.com—
profile.display_namestringESPN—
profile.avatar_urlstringhttps://cdn.bsky.app/img/avatar/plain/did:plc…—
profile.biostringServing sports fans. Anytime. Anywhere.—
profile.verifiedbooleantrue—
profile.followersinteger296582—
profile.followinginteger32—
profile.posts_countinteger872—
profile.likes_countinteger220484—
profile.urlstringhttps://bsky.app/profile/espn.com—
profile.joined_atstring2024-11-25—
profile.associatedobject{…}—
profile.labelsarray[]—
profile.verificationobject{…}—
profile.indexed_atstring2024-12-19T20:49:48.843Z—
profile.computedobject{…}—
profile.partialbooleanfalse—
profile.warningsarray[]—
profile.statsobject{…}—
profile.duration_msinteger17756—
profile.scraped_atstring2026-09-22T08:31:44.102Z—

Returns everything in one call; next_cursor is always null.

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
  • Nothing special: send the inputs, read the result.
  • Bluesky Single Posts — Structured Bluesky data: send urls. Cursor-paginated, 1 credit per successful call.
  • Bluesky User Posts — Structured Bluesky data: send handles. Cursor-paginated, 1 credit per successful call.