How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Bluesky

Bluesky Social Graph API

Operations for managing follows, followers, blocks, mutes, and lists.

Documentation Provider Profile APIs.io OpenAPI GitHub

Bluesky Social Graph API is one of 24 APIs that Bluesky publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Social Graph. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and an AsyncAPI specification.

This API exposes 20 operations across 20 paths, and defines 26 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://bsky.social/xrpc, https://public.api.bsky.app/xrpc.

20 operations 20 paths 26 schemas 14 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
https://bsky.social/xrpc
https://public.api.bsky.app/xrpc
Authentication
HTTP Bearer
Contact
Bluesky Support
License
MIT
Resource Areas
1

Authentication & Security 1

Bluesky Social Graph API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Bearer).

Paths & Operations 20

Across 20 paths, the API surfaces 20 operations — 14 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Social Graph 20

Operations for managing follows, followers, blocks, mutes, and lists.

GET
/xrpc/app.bsky.graph.getActorStarterPacks
Bluesky Get a list of starter packs created by the actor.
graphGetActorStarterPacks 3 params → 200400401
GET
/xrpc/app.bsky.graph.getBlocks
Bluesky Enumerates which accounts the requesting account is currently blocking.
graphGetBlocks 2 params → 200400401
GET
/xrpc/app.bsky.graph.getFollowers
Bluesky Enumerates accounts which follow a specified account (actor).
graphGetFollowers 3 params → 200400401
GET
/xrpc/app.bsky.graph.getFollows
Bluesky Enumerates accounts which a specified account (actor) follows.
graphGetFollows 3 params → 200400401
GET
/xrpc/app.bsky.graph.getKnownFollowers
Bluesky Enumerates accounts which follow a specified account (actor) and are followed by the viewer.
graphGetKnownFollowers 3 params → 200400401
GET
/xrpc/app.bsky.graph.getList
Bluesky Gets a 'view' (with additional context) of a specified list.
graphGetList 3 params → 200400401
GET
/xrpc/app.bsky.graph.getListBlocks
Bluesky Get mod lists that the requesting account (actor) is blocking.
graphGetListBlocks 2 params → 200400401
GET
/xrpc/app.bsky.graph.getListMutes
Bluesky Enumerates mod lists that the requesting account (actor) currently has muted.
graphGetListMutes 2 params → 200400401
GET
/xrpc/app.bsky.graph.getLists
Bluesky Enumerates the lists created by a specified account (actor).
graphGetLists 3 params → 200400401
GET
/xrpc/app.bsky.graph.getMutes
Bluesky Enumerates accounts that the requesting account (actor) currently has muted.
graphGetMutes 2 params → 200400401
GET
/xrpc/app.bsky.graph.getRelationships
Bluesky Enumerates public relationships between one account, and a list of other accounts.
graphGetRelationships 2 params → 200400401
GET
/xrpc/app.bsky.graph.getStarterPack
Bluesky Gets a view of a starter pack.
graphGetStarterPack 1 param → 200400401
GET
/xrpc/app.bsky.graph.getStarterPacks
Bluesky Get views for a list of starter packs.
graphGetStarterPacks 1 param → 200400401
GET
/xrpc/app.bsky.graph.getSuggestedFollowsByActor
Bluesky Enumerates follows similar to a given account (actor).
graphGetSuggestedFollowsByActor 1 param → 200400401
POST
/xrpc/app.bsky.graph.muteActor
Bluesky Creates a mute relationship for the specified account.
graphMuteActor body → 200400401
POST
/xrpc/app.bsky.graph.muteActorList
Bluesky Creates a mute relationship for the specified list of accounts.
graphMuteActorList body → 200400401
POST
/xrpc/app.bsky.graph.muteThread
Bluesky Mutes a thread preventing notifications from the thread and any of its children.
graphMuteThread body → 200400401
POST
/xrpc/app.bsky.graph.unmuteActor
Bluesky Unmutes the specified account.
graphUnmuteActor body → 200400401
POST
/xrpc/app.bsky.graph.unmuteActorList
Bluesky Unmutes the specified list of accounts.
graphUnmuteActorList body → 200400401
POST
/xrpc/app.bsky.graph.unmuteThread
Bluesky Unmutes the specified thread.
graphUnmuteThread body → 200400401

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are AppBskyFeedDefsGeneratorView (13 properties), AppBskyGraphDefsListView (12 properties), AppBskyGraphDefsStarterPackView (11 properties), AppBskyActorDefsProfileView (10 properties). Each schema is shown below with its type and property counts.

AppBskyGraphDefsListViewBasic
object
9 properties 4 required
AppBskyGraphDefsListItemView
object
2 properties 2 required
ComAtprotoLabelDefsLabel
object
Metadata tag on an atproto resource (eg, repo or record).
9 properties 4 required
AppBskyRichtextFacetLink
object
Facet feature for a URL. The text URL may have been simplified or truncated, but the facet reference should be a complete URL.
1 property 1 required
AppBskyActorDefsProfileView
object
10 properties 2 required
AppBskyFeedDefsGeneratorViewerState
object
1 property
AppBskyRichtextFacetMention
object
Facet feature for mention of another account. The text is usually a handle, including a '@' prefix, but the facet reference is a DID.
1 property 1 required
AppBskyActorDefsProfileAssociatedChat
object
1 property 1 required
AppBskyActorDefsViewerState
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
8 properties
AppBskyActorDefsProfileAssociated
object
5 properties
AppBskyGraphDefsStarterPackView
object
11 properties 5 required
AppBskyActorDefsKnownFollowers
object
The subject's followers whom you also follow
2 properties 2 required
AppBskyGraphDefsListView
object
12 properties 6 required
AppBskyActorDefsProfileViewBasic
object
8 properties 2 required
AppBskyGraphDefsListPurpose
AppBskyRichtextFacetByteSlice
object
Specifies the sub-string range a facet feature applies to. Start index is inclusive, end index is exclusive. Indices are zero-indexed, counting bytes of the UT…
2 properties 2 required
AppBskyRichtextFacet
object
Annotation of a sub-string within rich text.
2 properties 2 required
AppBskyGraphDefsNotFoundActor
object
indicates that a handle or DID could not be resolved
2 properties 2 required
AppBskyGraphDefsCuratelist
string
A list of actors used for curation purposes such as list feeds or interaction gating.
AppBskyGraphDefsReferencelist
string
A list of actors used for only for reference purposes such as within a starter pack.
AppBskyFeedDefsGeneratorView
object
13 properties 6 required
AppBskyGraphDefsRelationship
object
lists the bi-directional graph relationships between one actor (not indicated in the object), and the target actors (the DID included in the object)
3 properties 1 required
AppBskyGraphDefsModlist
string
A list of actors to apply an aggregate moderation action (mute/block) on.
AppBskyRichtextFacetTag
object
Facet feature for a hashtag. The text usually includes a '' prefix, but the facet reference should not (except in the case of 'double hash tags').
1 property 1 required
AppBskyGraphDefsListViewerState
object
2 properties
AppBskyGraphDefsStarterPackViewBasic
object
9 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

bluesky-social-graph-api-openapi.yml Raw ↑

Other APIs Bluesky publishes across the network.

Bluesky Jetstream
AE Profile APIs.io
Bluesky Actor Profiles API
AE Profile APIs.io
Bluesky Administration API
AE Profile APIs.io
Bluesky Chat Actors API
AE Profile APIs.io
Bluesky Chat Moderation API
AE Profile APIs.io
Bluesky Content Labels API
AE Profile APIs.io
Bluesky Conversations API
AE Profile APIs.io
Bluesky Feeds API
AE Profile APIs.io
Bluesky Identity API
AE Profile APIs.io
Bluesky Labels API
AE Profile APIs.io
Bluesky Moderation API
AE Profile APIs.io
Bluesky Notifications API
AE Profile APIs.io
#Social Graph
← Back to B APIs
API Details
ID
bluesky:bluesky-social-graph-api
Server
https://bsky.social/xrpc
Docs
https://docs.bsky.app/
Provider
Bluesky
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=bluesky-social-graph-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/bluesky-social-graph-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Bluesky Social Graph API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.