← API Store
Social
Bluesky
Bluesky
Bluesky followers
GET /bluesky/v1/user/followersEvery 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 |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 89,
"credits_used": 1,
"followers": [
{
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mz4m6yo275wmhyjucq5n4cgu/bafkreiav7qlbxnj57z3mlczkdlnhcdv7kpv7g73ecyyyq6q6uqdwyulrfu",
"created_at": "2025-04-04T20:57:25.295Z",
"description": null,
"did": "did:plc:mz4m6yo275wmhyjucq5n4cgu",
"handle": "justmask.bsky.social",
"indexed_at": "2025-04-16T12:06:47.974Z",
"labeler": null,
"labels": [
"spam"
],
"name": "Mask",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/justmask.bsky.social",
"verified": false,
"viewer": null
},
{
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:mfolp7m237wqh3mrtjpsvbxm/bafkreihxrsjdubjkyvg5oqrdaszkhugw5ktrufskwgjssrf72hzm5mwdam",
"created_at": "2024-04-24T02:57:52.762Z",
"description": "security, distributed systems, networking, & rust\n\nATL",
"did": "did:plc:mfolp7m237wqh3mrtjpsvbxm",
"handle": "jan0ski.net",
"indexed_at": "2026-09-29T20:54:46.754Z",
"labeler": null,
"labels": [],
"name": "Tommy McCormick",
"pronouns": null,
"trusted_verifier": false,
"url": "https://bsky.app/profile/jan0ski.net",
"verified": false,
"viewer": null
},
"… 87 more"
],
"handle": "jay.bsky.team",
"next_cursor": "3my7pdrergz2m",
"subject": {
"avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:oky5czdrnfjpqslsw2a5iclo/bafkreihxtnc37g7jqdcgidtkknwuswtjiijcdnc6cx4imc4oq33cnsc5da",
"created_at": "2022-11-17T06:31:40.296Z",
"description": "Founder & Chief Innovation Officer @ Bluesky\n\nWorking on @attie.ai\n\n🌱 🪴 🌳",
"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
}
} Response fields (36)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.followers | array |
$.followers[] | object | string |
$.followers[].avatar | string |
$.followers[].created_at | string |
$.followers[].description | null | string |
$.followers[].did | string |
$.followers[].handle | string |
$.followers[].indexed_at | string |
$.followers[].labeler | null |
$.followers[].labels | array |
$.followers[].labels[] | string |
$.followers[].name | string |
$.followers[].pronouns | null |
$.followers[].trusted_verifier | boolean |
$.followers[].url | string |
$.followers[].verified | boolean |
$.followers[].viewer | null |
$.handle | string |
$.next_cursor | string |
$.subject | object |
$.subject.avatar | string |
$.subject.created_at | string |
$.subject.description | string |
$.subject.did | string |
$.subject.handle | string |
$.subject.labeler | null |
$.subject.labels | array |
$.subject.name | string |
$.subject.pronouns | null |
$.subject.trusted_verifier | boolean |
$.subject.url | string |
$.subject.verified | boolean |