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
| Action | Description | Listed price |
|---|---|---|
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. | Billed per request at your plan's rates |
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). | Billed per request at your plan's rates |
search | 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. | 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/profileInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
accounts | string[] | null | Required. 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:
| Field | Type | Description |
|---|---|---|
did | string | The account's permanent DID, which survives handle changes. |
handle | string | The account's current handle, a domain name. |
displayName | string | null | The display name; null when unset. |
description | string | null | The bio text, links as written; null when unset. |
avatar | string | null | The avatar image URL; null when unset. |
banner | string | null | The banner image URL; null when unset. |
links | object[] | null | The links the account lists on its profile, in order, deduped by URL. |
links[].title | string | The link's title as the account wrote it, or its host when untitled. |
links[].url | string | — |
followersCount | integer | — |
followsCount | integer | — |
postsCount | integer | Posts and replies the account has made. |
createdAt | string | null | When the account was created, ISO 8601. |
pinnedPostUrl | string | null | The pinned post's bsky.app permalink; null when none is pinned. |
loggedOutHidden | boolean | True 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. |
url | string | The 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/postsInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
account | string | Required. The account: a handle such as pfrazee.com, a DID, or a bsky.app profile URL. At least 1 character. |
filter | posts_and_replies posts posts_with_media threads | posts_and_replies (the default): every post and reply; posts: no replies; posts_with_media; threads: posts and the account's own self-reply threads. |
includeReposts | boolean | Keep posts the account reposted from others, marked repost. Off by default, so every row is the account's own words. |
maxPages | integer | The 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:
| Field | Type | Description |
|---|---|---|
uri | string | The post's at:// URI. |
url | string | The post's permalink on bsky.app. |
authorDid | string | — |
authorHandle | string | — |
text | string | The post's text as written. |
createdAt | string | When the author's client says the post was written, ISO 8601. |
indexedAt | string | When Bluesky's AppView first saw the post, ISO 8601. |
repost | boolean | True when the account reposted someone else's post; the author fields then name the original author. |
replyToUrl | string | null | For a reply, the permalink of the post it answers; null for a top-level post. |
rootUrl | string | null | For a reply, the permalink of the thread's first post; null for a top-level post. |
quotedUrl | string | null | The permalink of a post this one quotes; null when none. |
links | string[] | null | Every link in the text and a link card's URL, in order. |
mentions | string[] | null | The DIDs of accounts the text mentions. |
tags | string[] | null | Hashtags in the text, without #. |
images | object[] | null | Attached images. |
images[].url | string | The full-size image URL. |
images[].alt | string | null | The alt text; null when none. |
hasVideo | boolean | — |
langs | string[] | null | The languages the author's client tagged. |
likeCount | integer | — |
repostCount | integer | — |
replyCount | integer | — |
quoteCount | integer | — |
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.
search
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/searchInput
Unknown fields are rejected.
| Field | Type | Description |
|---|---|---|
query | string | Required. A person's or organisation's name, or part of a handle. At least 1 character. |
limit | integer | The 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:
| Field | Type | Description |
|---|---|---|
rank | integer | The account's position in Bluesky's ranking, from 1. |
did | string | — |
handle | string | The account's current handle. |
displayName | string | null | The display name; null when unset. |
description | string | null | The bio text; null when unset. |
avatar | string | null | The avatar image URL; null when unset. |
createdAt | string | null | When the account was created, ISO 8601. |
url | string | The 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.
Discogs
Discogs, the music database and record marketplace: a member's public profile (location, home page, profile text and the links in it, join date, collection and wantlist sizes) and the releases in their collection and wantlist, newest first, when the member made them public.
Medium
A Medium writer's public profile and their own published stories, newest first.