String docs
Site integrations

Bluesky

Bluesky profiles, an account's posts and replies with permalinks and exact timestamps back to its first post, and account search by name or handle.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: bluesky
  • Version: 1.0.0
  • Reads from: bsky.app
ActionDescriptionListed price
profileRead Bluesky accounts' public profiles: handle, DID, display name, bio, avatar, banner, profile links, follower, following and post counts, creation date and pinned post. An account that does not exist, is deactivated or has been taken down fails with that reason. An account that asked to be hidden from logged-out viewers still returns its profile, with loggedOutHidden true.Billed per request at your plan's rates
postsList a Bluesky account's posts and replies, newest first, 100 per page, back to its first post: permalink, text, exact timestamp, the post a reply answers, quoted post, links, mentions, hashtags, images and like, repost, reply and quote counts. Reposts of others are left out unless asked for. An account that does not exist, is deactivated or has been taken down fails with that reason. An account that asked to be hidden from logged-out viewers is read like any other (the profile action flags it with loggedOutHidden true).Billed per request at your plan's rates
searchFind Bluesky accounts by a person's or organisation's name or part of a handle, in Bluesky's ranking: handle, DID, display name, bio, avatar and creation date. Use it to go from a name to a handle, then confirm the match from the bio or a linked site.Billed per request at your plan's rates

profile

Read Bluesky accounts' public profiles: handle, DID, display name, bio, avatar, banner, profile links, follower, following and post counts, creation date and pinned post. An account that does not exist, is deactivated or has been taken down fails with that reason. An account that asked to be hidden from logged-out viewers still returns its profile, with loggedOutHidden true.

POST https://request.usestring.ai/v1/integrations/bluesky/profile

Input

Unknown fields are rejected.

FieldTypeDescription
accountsstring[] | nullRequired. Each account: a handle such as pfrazee.com or @jay.bsky.team, a DID, or a bsky.app profile URL. A name with no dot is read as <name>.bsky.social. 1 to 100 entries.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
didstringThe account's permanent DID, which survives handle changes.
handlestringThe account's current handle, a domain name.
displayNamestring | nullThe display name; null when unset.
descriptionstring | nullThe bio text, links as written; null when unset.
avatarstring | nullThe avatar image URL; null when unset.
bannerstring | nullThe banner image URL; null when unset.
linksobject[] | nullThe links the account lists on its profile, in order, deduped by URL.
links[].titlestringThe link's title as the account wrote it, or its host when untitled.
links[].urlstring—
followersCountinteger—
followsCountinteger—
postsCountintegerPosts and replies the account has made.
createdAtstring | nullWhen the account was created, ISO 8601.
pinnedPostUrlstring | nullThe pinned post's bsky.app permalink; null when none is pinned.
loggedOutHiddenbooleanTrue when the account asked Bluesky not to show it to logged-out viewers (the !no-unauthenticated label). Reported only; the profile and posts are returned as the API serves them.
urlstringThe profile's page on bsky.app.

Example

curl https://request.usestring.ai/v1/integrations/bluesky/profile \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": ["pfrazee.com"]
  }'

data starts with these rows:

[
  {
    "did": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
    "handle": "pfrazee.com",
    "displayName": "P(aul) Frazee",
    "description": "CTO at Bluesky. Not a nerd.",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreiavsw7yv2krrcv6oac7miximpti6a5fi4zcjlxdttvsa42vmvzhb4",
    "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:ragtjsm2j2vknwkz3zp4oxrd/bafkreiai3mohqwakra23zdvgihyvyizjdfnf2plev7er5qbzkttgqm5nsy",
    "links": [
      {
        "title": "Paul's Leaflets",
        "url": "https://pfrazee.leaflet.pub/"
      }
    ],
    "followersCount": 309514,
    "followsCount": 720,
    "postsCount": 40515,
    "createdAt": "2022-11-17T00:35:16.391Z",
    "pinnedPostUrl": null,
    "loggedOutHidden": false,
    "url": "https://bsky.app/profile/pfrazee.com"
  }
]

Requests and billing

  • Requests: 1 Web Access request per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

posts

List a Bluesky account's posts and replies, newest first, 100 per page, back to its first post: permalink, text, exact timestamp, the post a reply answers, quoted post, links, mentions, hashtags, images and like, repost, reply and quote counts. Reposts of others are left out unless asked for. An account that does not exist, is deactivated or has been taken down fails with that reason. An account that asked to be hidden from logged-out viewers is read like any other (the profile action flags it with loggedOutHidden true).

POST https://request.usestring.ai/v1/integrations/bluesky/posts

Input

Unknown fields are rejected.

FieldTypeDescription
accountstringRequired. The account: a handle such as pfrazee.com, a DID, or a bsky.app profile URL. At least 1 character.
filterposts_and_replies posts posts_with_media threadsposts_and_replies (the default): every post and reply; posts: no replies; posts_with_media; threads: posts and the account's own self-reply threads.
includeRepostsbooleanKeep posts the account reposted from others, marked repost. Off by default, so every row is the account's own words.
maxPagesintegerThe most pages of 100 feed items to read, newest first, 1 to 100. Defaults to 1. From 1 to 100.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
uristringThe post's at:// URI.
urlstringThe post's permalink on bsky.app.
authorDidstring—
authorHandlestring—
textstringThe post's text as written.
createdAtstringWhen the author's client says the post was written, ISO 8601.
indexedAtstringWhen Bluesky's AppView first saw the post, ISO 8601.
repostbooleanTrue when the account reposted someone else's post; the author fields then name the original author.
replyToUrlstring | nullFor a reply, the permalink of the post it answers; null for a top-level post.
rootUrlstring | nullFor a reply, the permalink of the thread's first post; null for a top-level post.
quotedUrlstring | nullThe permalink of a post this one quotes; null when none.
linksstring[] | nullEvery link in the text and a link card's URL, in order.
mentionsstring[] | nullThe DIDs of accounts the text mentions.
tagsstring[] | nullHashtags in the text, without #.
imagesobject[] | nullAttached images.
images[].urlstringThe full-size image URL.
images[].altstring | nullThe alt text; null when none.
hasVideoboolean—
langsstring[] | nullThe languages the author's client tagged.
likeCountinteger—
repostCountinteger—
replyCountinteger—
quoteCountinteger—

Example

curl https://request.usestring.ai/v1/integrations/bluesky/posts \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "pfrazee.com"
  }'

data starts with these rows:

[
  {
    "uri": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3n2cbku7htk2w",
    "url": "https://bsky.app/profile/pfrazee.com/post/3n2cbku7htk2w",
    "authorDid": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
    "authorHandle": "pfrazee.com",
    "text": "If we're talking about reducing PDS level takedowns, we made some progress on reducing those decisions, but it's a whole matrix of policies and I haven't checked in recently",
    "createdAt": "2026-11-14T19:52:14.942Z",
    "indexedAt": "2026-11-14T19:52:16.244Z",
    "repost": false,
    "replyToUrl": "https://bsky.app/profile/did:plc:h3wpawnrlptr4534chevddo6/post/3n27yziu2mc2f",
    "rootUrl": "https://bsky.app/profile/did:plc:oio4hkxaop4ao4wz2pp3f4cr/post/3n262l666cs24",
    "quotedUrl": null,
    "links": [],
    "mentions": [],
    "tags": [],
    "images": [],
    "hasVideo": false,
    "langs": ["en"],
    "likeCount": 3,
    "repostCount": 0,
    "replyCount": 0,
    "quoteCount": 0
  },
  {
    "uri": "at://did:plc:ragtjsm2j2vknwkz3zp4oxrd/app.bsky.feed.post/3n2cbh4gjk22o",
    "url": "https://bsky.app/profile/pfrazee.com/post/3n2cbh4gjk22o",
    "authorDid": "did:plc:ragtjsm2j2vknwkz3zp4oxrd",
    "authorHandle": "pfrazee.com",
    "text": "Seatac is honestly pretty calm, as far as I can see. The terminals are a bit overcrowded but security was a short line. My flight is delayed by just an hour.\n\nThere are people around me who clearly started their travel yesterday. They seem unhappy.",
    "createdAt": "2026-11-14T19:50:09.345Z",
    "indexedAt": "2026-11-14T19:50:09.841Z",
    "repost": false,
    "replyToUrl": null,
    "rootUrl": null,
    "quotedUrl": null,
    "links": [],
    "mentions": [],
    "tags": [],
    "images": [],
    "hasVideo": false,
    "langs": ["en"],
    "likeCount": 49,
    "repostCount": 1,
    "replyCount": 3,
    "quoteCount": 0
  }
]

Requests and billing

  • Requests: 1 Web Access request per result page.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

Find Bluesky accounts by a person's or organisation's name or part of a handle, in Bluesky's ranking: handle, DID, display name, bio, avatar and creation date. Use it to go from a name to a handle, then confirm the match from the bio or a linked site.

POST https://request.usestring.ai/v1/integrations/bluesky/search

Input

Unknown fields are rejected.

FieldTypeDescription
querystringRequired. A person's or organisation's name, or part of a handle. At least 1 character.
limitintegerThe most accounts to return, 1 to 100. Defaults to 25. From 1 to 100.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
rankintegerThe account's position in Bluesky's ranking, from 1.
didstring—
handlestringThe account's current handle.
displayNamestring | nullThe display name; null when unset.
descriptionstring | nullThe bio text; null when unset.
avatarstring | nullThe avatar image URL; null when unset.
createdAtstring | nullWhen the account was created, ISO 8601.
urlstringThe profile's page on bsky.app.

Example

curl https://request.usestring.ai/v1/integrations/bluesky/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "NASA",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "rank": 1,
    "did": "did:plc:ocmyknbwkxjyjkactio272im",
    "handle": "nasawebb.extwitter.link",
    "displayName": "NASA Webb Telescope",
    "description": "⚠️ MIRROR OF twitter.com/NASAWebb\n⚠️ If you own the original account and want to claim this, please contact @twttr-mirrors.bsky.social",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:ocmyknbwkxjyjkactio272im/bafkreich4qumrtdmi7xcffg3bqquyijspjftc7ejaaodbujqyoo5lyagcu",
    "createdAt": "2024-02-22T17:10:21.640Z",
    "url": "https://bsky.app/profile/nasawebb.extwitter.link"
  },
  {
    "rank": 2,
    "did": "did:plc:6udbhveni6zbejqdt5ancvkr",
    "handle": "uahirise.bsky.social",
    "displayName": "HiRISE Beautiful Mars (NASA)",
    "description": "Images from the High Resolution Imaging Science Experiment (HiRISE) on board the Mars Reconnaissance Orbiter (NASA). We are based out of the Lunar and Planetary Laboratory at the University of Arizona in Tucson, AZ. https://uahirise.org",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:6udbhveni6zbejqdt5ancvkr/bafkreicu6s4y4e4nopdrbilvchfij4ar3t2nil4f7ctur67q7ktsdy3n3m",
    "createdAt": "2023-10-17T23:54:39.050Z",
    "url": "https://bsky.app/profile/uahirise.bsky.social"
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.