Search APIs
Loading…
← API Store
Social

Bluesky

Bluesky

Bluesky followers

GET /bluesky/v1/user/followers
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
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.followersarray
$.followers[]object | string
$.followers[].avatarstring
$.followers[].created_atstring
$.followers[].descriptionnull | string
$.followers[].didstring
$.followers[].handlestring
$.followers[].indexed_atstring
$.followers[].labelernull
$.followers[].labelsarray
$.followers[].labels[]string
$.followers[].namestring
$.followers[].pronounsnull
$.followers[].trusted_verifierboolean
$.followers[].urlstring
$.followers[].verifiedboolean
$.followers[].viewernull
$.handlestring
$.next_cursorstring
$.subjectobject
$.subject.avatarstring
$.subject.created_atstring
$.subject.descriptionstring
$.subject.didstring
$.subject.handlestring
$.subject.labelernull
$.subject.labelsarray
$.subject.namestring
$.subject.pronounsnull
$.subject.trusted_verifierboolean
$.subject.urlstring
$.subject.verifiedboolean