Search APIs
Loading…
← API Store
Social

Bluesky

Bluesky

Accounts a Bluesky user follows

GET /bluesky/v1/user/following
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": 100,
  "credits_used": 1,
  "follows": [
    {
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2zmxikig2sj7gqaezl5gntae/bafkreiesigpkfiuc4a7xflvnksawmy3gcb7qvmbb7cjrqpcmet42rwgn7y",
      "created_at": "2023-07-03T15:28:53.831Z",
      "description": "(it spells \"i am eli\")\n\nTrying to solve video for everybody forever at @stream.place, I livestream dev almost every day\n\nSeattle via Minneso…",
      "did": "did:plc:2zmxikig2sj7gqaezl5gntae",
      "handle": "iame.li",
      "indexed_at": "2026-10-22T21:11:00.034Z",
      "labeler": null,
      "labels": [],
      "name": "Eli Mallon",
      "pronouns": "he/him",
      "trusted_verifier": false,
      "url": "https://bsky.app/profile/iame.li",
      "verified": true,
      "viewer": null
    },
    {
      "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:2ziwq4hykj2yksqwviayrnnn/bafkreic5xb76ibh7cdcxsmv3aoiiex2i5o3wmoc276zlvraikwrjzjz7p4",
      "created_at": "2024-11-19T21:05:13.566Z",
      "description": "Live music and the great outdoors.",
      "did": "did:plc:2ziwq4hykj2yksqwviayrnnn",
      "handle": "carolinemockri4.bsky.social",
      "indexed_at": "2026-07-27T18:55:18.970Z",
      "labeler": null,
      "labels": [],
      "name": "Caroline M",
      "pronouns": null,
      "trusted_verifier": false,
      "url": "https://bsky.app/profile/carolinemockri4.bsky.social",
      "verified": false,
      "viewer": null
    },
    "… 98 more"
  ],
  "handle": "jay.bsky.team",
  "next_cursor": "3mazx7ejho52o",
  "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 (35)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.followsarray
$.follows[]object | string
$.follows[].avatarstring
$.follows[].created_atstring
$.follows[].descriptionstring
$.follows[].didstring
$.follows[].handlestring
$.follows[].indexed_atstring
$.follows[].labelernull
$.follows[].labelsarray
$.follows[].namestring
$.follows[].pronounsnull | string
$.follows[].trusted_verifierboolean
$.follows[].urlstring
$.follows[].verifiedboolean
$.follows[].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