Bluesky Actor Profiles 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 Actor Profiles. 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
7 operations
across 7 paths,
and defines 35 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.
7 operations7 paths35 schemas6 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
Bluesky Find actor suggestions for a prefix search term.
actorSearchActorsTypeahead2 params→ 200400401
Schemas 35
The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are AppBskyActorDefsProfileViewDetailed (16 properties), AppBskyActorDefsProfileView (10 properties), AppBskyGraphDefsStarterPackViewBasic (9 properties), ComAtprotoLabelDefsLabel (9 properties). Each schema is shown below with its type and property counts.
AppBskyActorDefsLabelersPref
object
1 property1 required
AppBskyGraphDefsListViewBasic
object
9 properties4 required
ComAtprotoLabelDefsLabel
object
Metadata tag on an atproto resource (eg, repo or record).
9 properties4 required
AppBskyActorDefsBskyAppProgressGuide
object
If set, an active progress guide. Once completed, can be set to undefined. Should have unspecced fields tracking progress.
1 property1 required
AppBskyActorDefsFeedViewPref
object
6 properties1 required
AppBskyActorDefsSavedFeedsPrefV2
object
1 property1 required
AppBskyActorDefsProfileView
object
10 properties2 required
AppBskyActorDefsContentLabelPref
object
3 properties2 required
AppBskyActorDefsMutedWord
object
A word that the account owner has muted.
5 properties2 required
AppBskyActorDefsProfileAssociatedChat
object
1 property1 required
AppBskyActorDefsProfileViewDetailed
object
16 properties2 required
AppBskyActorDefsViewerState
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
8 properties
ComAtprotoRepoStrongRef
object
2 properties2 required
AppBskyActorDefsSavedFeedsPref
object
3 properties2 required
AppBskyActorDefsProfileAssociated
object
5 properties
AppBskyActorDefsKnownFollowers
object
The subject's followers whom you also follow
2 properties2 required
AppBskyActorDefsProfileViewBasic
object
8 properties2 required
AppBskyGraphDefsListPurpose
AppBskyActorDefsHiddenPostsPref
object
1 property1 required
AppBskyActorDefsBskyAppStatePref
object
A grab bag of state that's specific to the bsky.app program. Third-party apps shouldn't use this.
3 properties
AppBskyActorDefsPersonalDetailsPref
object
1 property
AppBskyActorDefsMutedWordsPref
object
1 property1 required
AppBskyActorDefsLabelerPrefItem
object
1 property1 required
AppBskyGraphDefsCuratelist
string
A list of actors used for curation purposes such as list feeds or interaction gating.
AppBskyActorDefsNux
object
A new user experiences (NUX) storage object
4 properties2 required
AppBskyActorDefsThreadViewPref
object
2 properties
AppBskyGraphDefsReferencelist
string
A list of actors used for only for reference purposes such as within a starter pack.
AppBskyActorDefsMutedWordTarget
string
AppBskyGraphDefsModlist
string
A list of actors to apply an aggregate moderation action (mute/block) on.
AppBskyActorDefsAdultContentPref
object
1 property1 required
AppBskyActorDefsInterestsPref
object
1 property1 required
AppBskyGraphDefsListViewerState
object
2 properties
AppBskyActorDefsSavedFeed
object
4 properties4 required
AppBskyGraphDefsStarterPackViewBasic
object
9 properties5 required
AppBskyActorDefsPreferences
array
Specification
The full machine-readable OpenAPI contract behind this narrative.
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.
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 Actor Profiles 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.
