← API Store
Social
Bluesky
Bluesky
Bluesky user posts
GET /bluesky/v1/user/postsEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
handlerequired | string | Example: jay.bsky.team |
filter | string | posts_with_replies, posts_no_replies, posts_with_media or posts_and_author_threads. Example: posts_no_replies |
limit | integer | Posts per page, 1-100 (default 50). |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 50,
"credits_used": 1,
"filter": "posts_with_replies",
"handle": "jay.bsky.team",
"next_cursor": "2026-09-15T03:15:48.132Z",
"posts": [
{
"author": {
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2zmxikig2sj7gqaezl5gntae/bafkreiesigpkfiuc4a7xflvnksawmy3gcb7qvmbb7cjrqpcmet42rwgn7y",
"created_at": "2023-07-03T15:28:53.831Z",
"did": "did:plc:2zmxikig2sj7gqaezl5gntae",
"handle": "iame.li",
"labeler": null,
"labels": [],
"name": "Eli Mallon",
"pronouns": "he/him",
"trusted_verifier": false,
"url": "https://bsky.app/profile/iame.li",
"verified": true
},
"bookmarks": 5,
"cid": "bafyreidv3dfab4dr2vzq66al7ffep4axv2h4hdzh263khsafrn7z3rn524",
"created_at": "2026-10-16T23:29:11.121Z",
"embed": {
"description": "Send proposal records. Tweak and approve.",
"thumb": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:2zmxikig2sj7gqaezl5gntae/bafkreia7ac5el2dqcyc6vap3tqyeavvyybxnnlwojrskn6x6yhm6kaaxjm",
"title": "Record Proposer",
"type": "link",
"url": "https://buzzing-ivory-wagon.attie.site/at://did:plc:wyvvl5ftfap4225hytnsvpia/com.iameli.record.proposal/3mxznp34lbkgz"
},
"embed_raw": {
"$type": "app.bsky.embed.external#view",
"external": {
"description": "Send proposal records. Tweak and approve.",
"thumb": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:2zmxikig2sj7gqaezl5gntae/bafkreia7ac5el2dqcyc6vap3tqyeavvyybxnnlwojrskn6x6yhm6kaaxjm",
"title": "Record Proposer",
"uri": "https://buzzing-ivory-wagon.attie.site/at://did:plc:wyvvl5ftfap4225hytnsvpia/com.iameli.record.proposal/3mxznp34lbkgz"
}
},
"facets": [
{
"features": [
{
"…": "2 fields"
}
],
"index": {
"…": "2 fields"
}
}
],
"feed_context": null,
"indexed_at": "2026-10-16T23:29:13.153Z",
"labels": [],
"langs": [
"en"
],
"likes": 21,
"links": [
"https://buzzing-ivory-wagon.attie.site/at://did:plc:wyvvl5ftfap4225hytnsvpia/com.iameli.record.proposal/3mxznp34lbkgz"
],
"mentions": [],
"pinned": false,
"quotes": 1,
"reason": {
"$type": "app.bsky.feed.defs#reasonRepost",
"by": {
"associated": {
"…": "2 fields"
},
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
"createdAt": "2022-11-17T06:31:40.296Z",
"did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
"displayName": "Jay 🦋",
"handle": "jay.bsky.team",
"labels": [],
"verification": {
"…": "3 fields"
}
},
"cid": "bafyreib4ughml4qizv5qurbvxk3racuxvabb7j3r6eryxozt5hre4uxwfy",
"indexedAt": "2026-10-17T04:00:08.164Z",
"uri": "at://did:plc:oky5czdrnfjpqslsw2a5iclo/app.bsky.feed.repost/3my27ckscrk2e"
},
"record_embed": {
"$type": "app.bsky.embed.external",
"external": {
"description": "Send proposal records. Tweak and approve.",
"thumb": {
"…": "4 fields"
},
"title": "Record Proposer",
"uri": "https://buzzing-ivory-wagon.attie.site/at://did:plc:wyvvl5ftfap4225hytnsvpia/com.iameli.record.proposal/3mxznp34lbkgz"
}
},
"record_type": "app.bsky.feed.post",
"replies": 5,
"reply_grandparent_author": null,
"reply_parent": null,
"reply_parent_cid": null,
"reply_root": null,
"reply_root_cid": null,
"reply_root_post": null,
"reply_to": null,
"repost_by": "jay.bsky.team",
"repost_by_details": {
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
"created_at": "2022-11-17T06:31:40.296Z",
"did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
"handle": "jay.bsky.team",
"labeler": null,
"labels": [],
"name": "Jay 🦋",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/jay.bsky.team",
"verified": true
},
"reposted_at": "2026-10-17T04:00:08.164Z",
"reposts": 4,
"tags": [],
"text": "Vibed up a lil Attie site that allows you to propose atproto records to be created by other users, like this: buzzing-ivory-wagon.attie.site…",
"threadgate": null,
"uri": "at://did:plc:2zmxikig2sj7gqaezl5gntae/app.bsky.feed.post/3mxzq62zy5c2c",
"url": "https://bsky.app/profile/iame.li/post/3mxzq62zy5c2c",
"viewer": null
},
{
"author": {
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreihhpqdyntku66himwor5wlhtdo44hllmngj2ofmbqnm25bdm454wq",
"created_at": "2022-11-17T00:35:16.391Z",
"did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
"handle": "pfrazee.com",
"labeler": null,
"labels": [],
"name": "P(aul) Frazee",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/pfrazee.com",
"verified": true
},
"bookmarks": 23,
"cid": "bafyreibt5o6ahxa6tmoicmghero5j6yhrlolgszbt56dv3zv6gw7iigmyu",
"created_at": "2026-10-17T01:29:43.856Z",
"embed": {
"images": [
{
"…": "4 fields"
}
],
"type": "images"
},
"embed_raw": {
"$type": "app.bsky.embed.images#view",
"images": [
{
"…": "4 fields"
}
]
},
"facets": [
{
"features": [
{
"…": "2 fields"
}
],
"index": {
"…": "2 fields"
}
}
],
"feed_context": null,
"indexed_at": "2026-10-17T01:29:46.464Z",
"labels": [],
"langs": [
"en"
],
"likes": 82,
"links": [
"https://attie.ai"
],
"mentions": [],
"pinned": false,
"quotes": 6,
"reason": {
"$type": "app.bsky.feed.defs#reasonRepost",
"by": {
"associated": {
"…": "2 fields"
},
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
"createdAt": "2022-11-17T06:31:40.296Z",
"did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
"displayName": "Jay 🦋",
"handle": "jay.bsky.team",
"labels": [],
"verification": {
"…": "3 fields"
}
},
"cid": "bafyreieogmrej7uio3e5apxtpxhtsikh5rxq6vvxyel4dpub3pzjpdbjgy",
"indexedAt": "2026-10-17T03:58:14.858Z",
"uri": "at://did:plc:oky5czdrnfjpqslsw2a5iclo/app.bsky.feed.repost/3my2776o6zw22"
},
"record_embed": {
"$type": "app.bsky.embed.images",
"images": [
{
"…": "3 fields"
}
]
},
"record_type": "app.bsky.feed.post",
"replies": 14,
"reply_grandparent_author": null,
"reply_parent": null,
"reply_parent_cid": null,
"reply_root": null,
"reply_root_cid": null,
"reply_root_post": null,
"reply_to": null,
"repost_by": "jay.bsky.team",
"repost_by_details": {
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
"created_at": "2022-11-17T06:31:40.296Z",
"did": "did:plc:oky5czdrnfjpqslsw2a5iclo",
"handle": "jay.bsky.team",
"labeler": null,
"labels": [],
"name": "Jay 🦋",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/jay.bsky.team",
"verified": true
},
"reposted_at": "2026-10-17T03:58:14.858Z",
"reposts": 12,
"tags": [],
"text": "Saw somebody ask: What is Attie?\n\nAttie's an agent, so I just asked it myself (attie.ai)",
"threadgate": null,
"uri": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3mxzwvmpkvc2t",
"url": "https://bsky.app/profile/pfrazee.com/post/3mxzwvmpkvc2t",
"viewer": null
},
"… 48 more"
]
} Response fields (118)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.filter | string |
$.handle | string |
$.next_cursor | string |
$.posts | array |
$.posts[] | object | string |
$.posts[].author | object |
$.posts[].author.avatar | string |
$.posts[].author.created_at | string |
$.posts[].author.did | string |
$.posts[].author.handle | string |
$.posts[].author.labeler | null |
$.posts[].author.labels | array |
$.posts[].author.name | string |
$.posts[].author.pronouns | null | string |
$.posts[].author.trusted_verifier | boolean |
$.posts[].author.url | string |
$.posts[].author.verified | boolean |
$.posts[].bookmarks | integer |
$.posts[].cid | string |
$.posts[].created_at | string |
$.posts[].embed | object |
$.posts[].embed.description | string |
$.posts[].embed.images | array |
$.posts[].embed.images[] | object |
$.posts[].embed.images[].… | string |
$.posts[].embed.thumb | string |
$.posts[].embed.title | string |
$.posts[].embed.type | string |
$.posts[].embed.url | string |
$.posts[].embed_raw | object |
$.posts[].embed_raw.$type | string |
$.posts[].embed_raw.external | object |
$.posts[].embed_raw.external.description | string |
$.posts[].embed_raw.external.thumb | string |
$.posts[].embed_raw.external.title | string |
$.posts[].embed_raw.external.uri | string |
$.posts[].embed_raw.images | array |
$.posts[].embed_raw.images[] | object |
$.posts[].embed_raw.images[].… | string |
$.posts[].facets | array |
$.posts[].facets[] | object |
$.posts[].facets[].features | array |
$.posts[].facets[].features[] | object |
$.posts[].facets[].features[].… | string |
$.posts[].facets[].index | object |
$.posts[].facets[].index.… | string |
$.posts[].feed_context | null |
$.posts[].indexed_at | string |
$.posts[].labels | array |
$.posts[].langs | array |
$.posts[].langs[] | string |
$.posts[].likes | integer |
$.posts[].links | array |
$.posts[].links[] | string |
$.posts[].mentions | array |
$.posts[].pinned | boolean |
$.posts[].quotes | integer |
$.posts[].reason | object |
$.posts[].reason.$type | string |
$.posts[].reason.by | object |
$.posts[].reason.by.associated | object |
$.posts[].reason.by.associated.… | string |
$.posts[].reason.by.avatar | string |
$.posts[].reason.by.createdAt | string |
$.posts[].reason.by.did | string |
$.posts[].reason.by.displayName | string |
$.posts[].reason.by.handle | string |
$.posts[].reason.by.labels | array |
$.posts[].reason.by.verification | object |
$.posts[].reason.by.verification.… | string |
$.posts[].reason.cid | string |
$.posts[].reason.indexedAt | string |
$.posts[].reason.uri | string |
$.posts[].record_embed | object |
$.posts[].record_embed.$type | string |
$.posts[].record_embed.external | object |
$.posts[].record_embed.external.description | string |
$.posts[].record_embed.external.thumb | object |
$.posts[].record_embed.external.thumb.… | string |
$.posts[].record_embed.external.title | string |
$.posts[].record_embed.external.uri | string |
$.posts[].record_embed.images | array |
$.posts[].record_embed.images[] | object |
$.posts[].record_embed.images[].… | string |
$.posts[].record_type | string |
$.posts[].replies | integer |
$.posts[].reply_grandparent_author | null |
$.posts[].reply_parent | null |
$.posts[].reply_parent_cid | null |
$.posts[].reply_root | null |
$.posts[].reply_root_cid | null |
$.posts[].reply_root_post | null |
$.posts[].reply_to | null |
$.posts[].repost_by | string |
$.posts[].repost_by_details | object |
$.posts[].repost_by_details.avatar | string |
$.posts[].repost_by_details.created_at | string |
$.posts[].repost_by_details.did | string |
$.posts[].repost_by_details.handle | string |
$.posts[].repost_by_details.labeler | null |
$.posts[].repost_by_details.labels | array |
$.posts[].repost_by_details.name | string |
$.posts[].repost_by_details.pronouns | null |
$.posts[].repost_by_details.trusted_verifier | boolean |
$.posts[].repost_by_details.url | string |
$.posts[].repost_by_details.verified | boolean |
$.posts[].reposted_at | string |
$.posts[].reposts | integer |
$.posts[].tags | array |
$.posts[].text | string |
$.posts[].threadgate | null |
$.posts[].uri | string |
$.posts[].url | string |
$.posts[].viewer | null |