# Bluesky Profile API. Send a handle or profile link. Exact follower counts, bio, links and DID. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dbluesky.profile) ## Bluesky Profile API at a glance Returns a public Bluesky profile from its handle, DID or link, with exact follower, following and post counts. It also has the stable DID and current handle, display name, bio, pronouns, avatar, banner, join date, the verified badge with who verified the account and when, its links with their titles, labels such as bot, its pinned post, and how many lists, custom feeds and starter packs it made. GET `/v1/bluesky/profile` [Read the API reference](https://socialtap.dev/docs/reference/bluesky/profile/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **19 typed fields** null when unknown - **`handle`** is all it needs, e.g. `bsky.app` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 19 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = bsky.app` [Open in playground](https://socialtap.dev/playground/?endpoint=bluesky.profile) cURL: ```shell curl 'https://socialtap.dev/v1/bluesky/profile?handle=espn.com' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.bluesky.profile.get({ handle: "espn.com" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "espn.com", }); const res = await fetch(`https://socialtap.dev/v1/bluesky/profile?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/bluesky/profile", params={"handle": "espn.com"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "espn.com") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/bluesky/profile?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [], "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie", "banner_url": null, "bio": "Serving sports fans. Anytime. Anywhere.", "category": null, "country_code": null, "created_at": "2024-11-25T21:49:49Z", "display_name": "ESPN", "external_links": [], "id": "did:plc:x7d6j54pm22ufehkes6jo4jf", "is_private": false, "is_verified": true, "location": null, "metrics": { "follower_count": 305103, "following_count": 32, "post_count": 872, "total_like_count": null, "total_view_count": null }, "platform": "bluesky", "platform_specific": { "bluesky": { "feed_count": 0, "indexed_at": "2024-12-19T20:49:48Z", "is_labeler": false, "is_trusted_verifier": false, "labels": [], "list_count": 0, "pinned_post_id": null, "pronouns": null, "starter_pack_count": 0, "verified_by": [ { "created_at": "2025-04-21T10:44:20Z", "id": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f", "is_valid": true, "issuer": { "avatar_url": null, "display_name": "Bluesky", "id": "did:plc:z72i7hdynmk6r22z27h6tvur", "is_verified": null, "url": "https://bsky.app/profile/bsky.app", "username": "bsky.app" } } ] } }, "type": "unknown", "unknown_fields": [], "url": "https://bsky.app/profile/espn.com", "username": "espn.com" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "bluesky", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 196, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "did:plc:x7d6j54pm22ufehkes6jo4jf", "url": "https://bsky.app/profile/espn.com" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` ## One schema on 27 platforms. The [response reference](https://socialtap.dev/docs/reference/bluesky/profile/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/profile/index.md). - ### Null means unknown A field Bluesky doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The Bluesky account: its handle, a domain name (espn.com, alice.bsky.social), with or without the @; its DID (did:plc:z72i7hdynmk6r22z27h6tvur or did:web:…), which is the id every answer gives and survives a change of handle; or its link (https://bsky.app/profile/bsky.app), by handle or DID, with any tab under it. - ### Write one parser Bluesky, TikTok, Instagram and 24 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native account ID (string; YouTube UC…, Reddit t2_…). - **`username`string**: Handle without the @; null when the account has none. - **`display_name`string**: Display name, channel title or page name; null when empty or not exposed. - **`url`string**: Canonical profile URL. - **`type`string**: Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. - **`bio`string**: Profile bio, channel description or page about text; null when empty or not exposed. - **`avatar_url`string**: Profile picture URL (largest available). Platform CDN URLs can expire within hours. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Bluesky Profile API. - ### Enrich a handle with followers, bio and links - ### Track followers and posts over time - ### Resolve a handle to its DID and back - ### Tell verified accounts, bots and moderation services apart ## Good to know before you build. - id is the account's DID, its one stable reference: a handle can change, and handle takes the DID back. username is null when the handle no longer proves itself (Bluesky shows handle.invalid), and url then names the DID. - An account that chose to be seen only by signed-in people returns private_or_unavailable, as the app answers a logged-out visitor. A suspended or deactivated account returns not_found, and the message says which. - type is unknown because Bluesky doesn't say whether an account is a person or an organization. is_labeler and the bot label say what they can of a service. - If Bluesky's API refuses, the account is read from its public page. The counts stay exact, is_verified and the Bluesky-specific fields are null, external_links holds only the links in the bio, and a partial_data warning says so. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/bluesky/profile/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Bluesky Profile API. More in the [API reference](https://socialtap.dev/docs/reference/bluesky/profile/index.md). **What is a DID?** The account's permanent ID (did:plc:…). A handle can change and the DID stays, so store the DID and send it to fetch the account after a rename. **How much does the Bluesky Profile API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Profiles on 26 more platforms. - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Threads Profile API](https://socialtap.dev/apis/threads/profile/index.md) (1 credit · `GET /v1/threads/profile`) - [Spotify Artist API](https://socialtap.dev/apis/spotify/artist/index.md) (1 credit · `GET /v1/spotify/artist`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Apple Music Artist API](https://socialtap.dev/apis/applemusic/artist/index.md) (1 credit · `GET /v1/applemusic/artist`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Rumble Channel API](https://socialtap.dev/apis/rumble/profile/index.md) (1 credit · `GET /v1/rumble/profile`) - [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`) - [Twitch Profile API](https://socialtap.dev/apis/twitch/profile/index.md) (1 credit · `GET /v1/twitch/profile`) - [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`) - [Telegram Channel API](https://socialtap.dev/apis/telegram/channel/index.md) (1 credit · `GET /v1/telegram/channel`) - [Kwai Profile API](https://socialtap.dev/apis/kwai/profile/index.md) (1 credit · `GET /v1/kwai/profile`) - [Snapchat Profile API](https://socialtap.dev/apis/snapchat/profile/index.md) (1 credit · `GET /v1/snapchat/profile`) - [SoundCloud Artist API](https://socialtap.dev/apis/soundcloud/artist/index.md) (1 credit · `GET /v1/soundcloud/artist`) - [Truth Social Profile API](https://socialtap.dev/apis/truthsocial/profile/index.md) (1 credit · `GET /v1/truthsocial/profile`) - [Komi Page API](https://socialtap.dev/apis/komi/page/index.md) (1 credit · `GET /v1/komi/page`) - [Lnk.Bio Profile API](https://socialtap.dev/apis/linkbio/profile/index.md) (1 credit · `GET /v1/linkbio/profile`) - [Linkme Profile API](https://socialtap.dev/apis/linkme/profile/index.md) (1 credit · `GET /v1/linkme/profile`) - [Linktree Profile API](https://socialtap.dev/apis/linktree/profile/index.md) (1 credit · `GET /v1/linktree/profile`) - [Pillar Page API](https://socialtap.dev/apis/pillar/page/index.md) (1 credit · `GET /v1/pillar/page`) - [Facebook Ad Library Advertiser Search API](https://socialtap.dev/apis/facebook/search_advertisers/index.md) (1 credit / page · `GET /v1/facebook/search_advertisers`) - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) More Bluesky ## Bluesky API. 5 endpoints, one key. - [Bluesky Post API](https://socialtap.dev/apis/bluesky/post/index.md) (1 credit · `GET /v1/bluesky/post`) - [Bluesky User Posts API](https://socialtap.dev/apis/bluesky/posts/index.md) (1 credit / page · `GET /v1/bluesky/posts`) - [Bluesky Post Search API](https://socialtap.dev/apis/bluesky/search_posts/index.md) (1 credit / page · `GET /v1/bluesky/search_posts`) - [Bluesky Comments API](https://socialtap.dev/apis/bluesky/comments/index.md) (1 credit / page · `GET /v1/bluesky/comments`) ## Try it on an account you know. Paste its handle or link in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/bluesky/profile/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)