Search APIs
Loading…
← API Store
Social

Bluesky

Bluesky

Bluesky user posts

GET /bluesky/v1/user/posts
Test this endpoint

Every 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

NameTypeDescription
handlerequiredstring Example: jay.bsky.team
filterstringposts_with_replies, posts_no_replies, posts_with_media or posts_and_author_threads. Example: posts_no_replies
limitintegerPosts per page, 1-100 (default 50).
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.filterstring
$.handlestring
$.next_cursorstring
$.postsarray
$.posts[]object | string
$.posts[].authorobject
$.posts[].author.avatarstring
$.posts[].author.created_atstring
$.posts[].author.didstring
$.posts[].author.handlestring
$.posts[].author.labelernull
$.posts[].author.labelsarray
$.posts[].author.namestring
$.posts[].author.pronounsnull | string
$.posts[].author.trusted_verifierboolean
$.posts[].author.urlstring
$.posts[].author.verifiedboolean
$.posts[].bookmarksinteger
$.posts[].cidstring
$.posts[].created_atstring
$.posts[].embedobject
$.posts[].embed.descriptionstring
$.posts[].embed.imagesarray
$.posts[].embed.images[]object
$.posts[].embed.images[].…string
$.posts[].embed.thumbstring
$.posts[].embed.titlestring
$.posts[].embed.typestring
$.posts[].embed.urlstring
$.posts[].embed_rawobject
$.posts[].embed_raw.$typestring
$.posts[].embed_raw.externalobject
$.posts[].embed_raw.external.descriptionstring
$.posts[].embed_raw.external.thumbstring
$.posts[].embed_raw.external.titlestring
$.posts[].embed_raw.external.uristring
$.posts[].embed_raw.imagesarray
$.posts[].embed_raw.images[]object
$.posts[].embed_raw.images[].…string
$.posts[].facetsarray
$.posts[].facets[]object
$.posts[].facets[].featuresarray
$.posts[].facets[].features[]object
$.posts[].facets[].features[].…string
$.posts[].facets[].indexobject
$.posts[].facets[].index.…string
$.posts[].feed_contextnull
$.posts[].indexed_atstring
$.posts[].labelsarray
$.posts[].langsarray
$.posts[].langs[]string
$.posts[].likesinteger
$.posts[].linksarray
$.posts[].links[]string
$.posts[].mentionsarray
$.posts[].pinnedboolean
$.posts[].quotesinteger
$.posts[].reasonobject
$.posts[].reason.$typestring
$.posts[].reason.byobject
$.posts[].reason.by.associatedobject
$.posts[].reason.by.associated.…string
$.posts[].reason.by.avatarstring
$.posts[].reason.by.createdAtstring
$.posts[].reason.by.didstring
$.posts[].reason.by.displayNamestring
$.posts[].reason.by.handlestring
$.posts[].reason.by.labelsarray
$.posts[].reason.by.verificationobject
$.posts[].reason.by.verification.…string
$.posts[].reason.cidstring
$.posts[].reason.indexedAtstring
$.posts[].reason.uristring
$.posts[].record_embedobject
$.posts[].record_embed.$typestring
$.posts[].record_embed.externalobject
$.posts[].record_embed.external.descriptionstring
$.posts[].record_embed.external.thumbobject
$.posts[].record_embed.external.thumb.…string
$.posts[].record_embed.external.titlestring
$.posts[].record_embed.external.uristring
$.posts[].record_embed.imagesarray
$.posts[].record_embed.images[]object
$.posts[].record_embed.images[].…string
$.posts[].record_typestring
$.posts[].repliesinteger
$.posts[].reply_grandparent_authornull
$.posts[].reply_parentnull
$.posts[].reply_parent_cidnull
$.posts[].reply_rootnull
$.posts[].reply_root_cidnull
$.posts[].reply_root_postnull
$.posts[].reply_tonull
$.posts[].repost_bystring
$.posts[].repost_by_detailsobject
$.posts[].repost_by_details.avatarstring
$.posts[].repost_by_details.created_atstring
$.posts[].repost_by_details.didstring
$.posts[].repost_by_details.handlestring
$.posts[].repost_by_details.labelernull
$.posts[].repost_by_details.labelsarray
$.posts[].repost_by_details.namestring
$.posts[].repost_by_details.pronounsnull
$.posts[].repost_by_details.trusted_verifierboolean
$.posts[].repost_by_details.urlstring
$.posts[].repost_by_details.verifiedboolean
$.posts[].reposted_atstring
$.posts[].repostsinteger
$.posts[].tagsarray
$.posts[].textstring
$.posts[].threadgatenull
$.posts[].uristring
$.posts[].urlstring
$.posts[].viewernull