Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/profile

Profile by handle or DID

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" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/bluesky-api/v1/profile", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/bluesky-api/v1/profile");
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",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
        "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka",
        "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreichzyovokfzmymz36p5jibbjrhsur6n7hjnzxrpbt5jaydp2szvna",
        "handle": "bsky.app",
        "labels": [],
        "createdAt": "2023-04-12T04:53:57.057Z",
        "indexedAt": "2025-10-27T21:05:26.152Z",
        "associated": {
            "chat": {
                "allowIncoming": "none"
            },
            "lists": 12,
            "labeler": false,
            "feedgens": 7,
            "starterPacks": 9,
            "activitySubscription": {
                "allowSubscriptions": "followers"
            }
        },
        "pinnedPost": {
            "cid": "bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq",
            "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"
        },
        "postsCount": 756,
        "description": "official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: [email protected]",
        "displayName": "Bluesky",
        "followsCount": 5,
        "verification": {
            "verifications": [],
            "verifiedStatus": "none",
            "trustedVerifierStatus": "valid"
        },
        "followersCount": 33520628
    },
    "meta": {
        "timestamp": "2026-06-02T08:33:13.681Z",
        "request_id": "7164b546-5d6e-4ecc-ac9b-f05a8ec9b7bb"
    },
    "status": "ok",
    "message": "Profile",
    "success": true
}