Skip to content
GET /v1/profile/followers

Followers

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/bluesky-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/bluesky-api/v1/profile/followers" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/bluesky-api/v1/profile/followers", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/bluesky-api/v1/profile/followers");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/bluesky-api/v1/profile/followers",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "cursor": "3mnc6mmjhht2q",
        "subject": {
            "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
            "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka",
            "handle": "bsky.app",
            "labels": [],
            "createdAt": "2023-04-12T04:53:57.057Z",
            "indexedAt": "2025-10-27T21:05:26.152Z",
            "associated": {
                "chat": {
                    "allowIncoming": "none"
                },
                "activitySubscription": {
                    "allowSubscriptions": "followers"
                }
            },
            "description": "official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: [email protected]",
            "displayName": "Bluesky",
            "verification": {
                "verifications": [],
                "verifiedStatus": "none",
                "trustedVerifierStatus": "valid"
            }
        },
        "followers": [
            {
                "did": "did:plc:sdo6kumfbnroeho6zllkzc2z",
                "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:sdo6kumfbnroeho6zllkzc2z/bafkreidlettqkts2ru3b7wscewep5mbkxjfppdrqbhyfgcqgbrk2zdfrvi",
                "handle": "handle.invalid",
                "labels": [],
                "createdAt": "2025-12-22T12:18:03.125Z",
                "indexedAt": "2025-12-22T12:18:03.125Z",
                "associated": {
                    "activitySubscription": {
                        "allowSubscriptions": "followers"
                    }
                },
                "displayName": "Dev Test Account"
            },
            {
                "did": "did:plc:rn6ymjv4ypbt6gli6eggz25t",
                "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:rn6ymjv4ypbt6gli6eggz25t/bafkreifibnihmxncdribjogmtp5iyeq42tdyvnqnwri3awj7z7fwope5ru",
                "handle": "ian.denazen.social",
                "labels": [],
                "createdAt": "2026-04-05T04:08:03.050Z",
                "indexedAt": "2026-04-08T20:14:58.453Z",
                "associated": {
                    "activitySubscription": {
                        "allowSubscriptions": "followers"
                    }
                },
                "description": "DIAGNOSTIC: Updated at 2026-04-05T21:38:43.471Z",
                "displayName": "Cory PDS Test"
            },
            {
                "did": "did:plc:nbfcyhs5h7jwrvnoiey6wffn",
                "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:nbfcyhs5h7jwrvnoiey6wffn/bafkreihwinhxdak5c3y2bikh3lle2ujesvajfonw7iv3crsfmt3a6j2lke",
                "handle": "discowaffles.bsky.social",
                "labels": [],
                "createdAt": "2026-05-27T11:50:51.457Z",
                "indexedAt": "2026-06-01T13:52:23.665Z",
                "associated": {
                    "activitySubscription": {
                
…