Bluesky User posts API
To get a Bluesky account's posts, call GET /v1/bluesky/user/posts?handle=… with your API key. You get clean JSON back.
/v1/bluesky/user/postscurl "https://api.scraperize.com/v1/bluesky/user/posts?handle=espn.com" \ -H "x-api-key: YOUR_API_KEY"
cursor to get the next page.cache_max_age to reuse a recent result for free.429 with a Retry-After header.Parameters
handleOptionalespn.com or name.bsky.social (a leading @ or a bsky.app/profile/... URL also work). Required unless userId is given.userIdOptionaldid:plc:x7d6j54pm22ufehkes6jo4jf. Required unless handle is given.cursorOptionalcursor from the previous page, to get the next one.cache_max_ageOptionalmeta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.One of 5 values.Send your key in the x-api-key header. Full API reference
Example response
{
"data": {
"user": {
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"handle": "espn.com",
"displayName": "ESPN",
"url": "https://bsky.app/profile/espn.com",
"avatarUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534…",
"pronouns": null,
"isVerified": true,
"labels": [],
"createdAt": "2024-11-25T21:49:49.345Z"
},
"posts": [
{
"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. 🏈",
"createdAt": "2026-09-08T18:27:24.700Z",
"indexedAt": "2026-09-08T18:27:30.159Z",
"langs": [],
"tags": [],
"via": null,
"hashtags": [],
"mentions": [],
"links": [],
"author": {
"did": "did:plc:x7d6j54pm22ufehkes6jo4jf",
"handle": "espn.com",
"displayName": "ESPN",
"url": "https://bsky.app/profile/espn.com",
"avatarUrl": "https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534…",
"pronouns": null,
"isVerified": true,
"labels": [],
"createdAt": "2024-11-25T21:49:49.345Z"
},
"likeCount": 100,
"repostCount": 11,
"replyCount": 11,
"quoteCount": 6,
"bookmarkCount": 0,
"media": {
"images": [],
"video": {
"playlistUrl": "https://video.bsky.app/watch/did%3Aplc%3Ax7d6j54pm22ufehkes6jo4jf/bafkreiflqivgi6afl5jv4qnmwzo3ks7jwe2dfurohsjfgafbtd5cr…",
"thumbnailUrl": "https://video.bsky.app/watch/did%3Aplc%3Ax7d6j54pm22ufehkes6jo4jf/bafkreiflqivgi6afl5jv4qnmwzo3ks7jwe2dfurohsjfgafbtd5cr…",
"alt": null,
"width": null,
"height": null
},
"link": null
},
"quote": null,
"embeddedRecord": null,
"isReply": false,
"reply": null,
"isRepost": false,
"repostedBy": null,
"repostedAt": null,
"isPinned": false,
"threadPostIndex": null,
"threadPostCount": null,
"replySettings": null,
"labels": []
}
],
"count": 30,
"cursor": "2025-09-25T17:06:11.912Z",
"hasMore": true,
"fetchedAt": "2026-10-17T19:15:44.136Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}A real response, shortened to one item per list.
Bluesky User posts API questions
How much does the Bluesky User posts API cost?
1 credit per successful call. Errors and cached results are free, and new accounts start with 100 free credits, no card required. See pricing.
Do I need a Bluesky account or API key?
No. You only need a Scraperize API key, sent in the x-api-key header. Scraperize returns publicly available data. No Bluesky login or developer app is needed.
How fresh is the data?
Each call fetches the data live. To trade freshness for cost, pass cache_max_age (e.g. 1h, 1d) to get a recent cached result instantly for 0 credits.
How do I get more results?
Each response includes a cursor. Send it back as the cursor parameter with the same other parameters to get the next page. It is null on the last page.
Where are the full parameters and response fields?
In the API reference, with every parameter, field and error.