Bluesky website screenshot

Bluesky

API for the Bluesky decentralized social network built on the AT Protocol.

2 APIs 0 Features
At-ProtocolDecentralizedFederatedOpen-SourceSocial NetworksSocial-Media

APIs

Bluesky API

The Bluesky API allows you to work programmatically with actors, feeds, graph, conversations, and other resources available for the the Bluesky app and social network.

Bluesky Jetstream

Jetstream is a simplified JSON event stream for the AT Protocol that converts CBOR-encoded MST blocks from the firehose into JSON objects over WebSocket connections, making it e...

Collections

Pricing Plans

Bluesky Plans Pricing

3 plans

PLANS

Rate Limits

Bluesky Rate Limits

5 limits

RATE LIMITS

FinOps

Event Specifications

Bluesky / AT Protocol Event Streams

AsyncAPI definition for the public event streams of the Bluesky network and the underlying AT Protocol. Three streams are documented: * **`com.atproto.sync.subscribeRepos`** - t...

ASYNCAPI

Resources

🔗
LinkedIn
LinkedIn
🔗
Bots
Bots
💬
Support
Support
📰
Blog
Blog
🚀
GettingStarted
GettingStarted
🔗
Templates
Templates
🎓
Tutorials
Tutorials
📰
Newsletter
Newsletter
🔗
PostmanWorkspace
PostmanWorkspace
🔗
Guidelines
Guidelines
🔗
CustomFeeds
CustomFeeds
🔗
Protocol
Protocol
🔗
AdvancedGuides
AdvancedGuides
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
🔗
CommunityGuidelines
CommunityGuidelines
📦
SDKs
SDKs
🔗
ProtocolOverview
ProtocolOverview
🔗
Specification
Specification
👥
GitHubOrg
GitHubOrg
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
👥
GitHubRepository
GitHubRepository
🔗
Forums
Forums

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Bluesky Social API
  version: 1.0.0
items:
- info:
    name: Actor Profiles
    type: folder
  items:
  - info:
      name: Bluesky Get private preferences attached to the current account.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.getPreferences
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get detailed profile view of an actor.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.getProfile
      params:
      - name: actor
        value: user.bsky.social
        type: query
        description: Handle or DID of account to fetch profile of.
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get detailed profile views of multiple actors.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.getProfiles
      params:
      - name: actors
        value: user.bsky.social
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of suggested actors.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.getSuggestions
      params:
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Set the private preferences attached to the account.
      type: http
    http:
      method: POST
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.putPreferences
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Find actors (profiles) matching search criteria.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.searchActors
      params:
      - name: q
        value: example-q
        type: query
        description: Search query string. Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is
          recommended.
      - name: limit
        value: '25'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Find actor suggestions for a prefix search term.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.actor.searchActorsTypeahead
      params:
      - name: q
        value: example-q
        type: query
        description: Search query prefix; not a full query string.
      - name: limit
        value: '10'
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
- info:
    name: Feeds
    type: folder
  items:
  - info:
      name: Bluesky Get information about a feed generator, including policies and offered feed URIs.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.describeFeedGenerator
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of feeds (feed generator records) created by the actor (in the actor's repo).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getActorFeeds
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of posts liked by an actor.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getActorLikes
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a view of an actor's 'author feed' (post and reposts by the author).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getAuthorFeed
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      - name: filter
        value: posts_with_replies
        type: query
        description: Combinations of post/repost types to include in response.
      - name: includePins
        value: 'true'
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a hydrated feed from an actor's selected feed generator.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getFeed
      params:
      - name: feed
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get information about a feed generator.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getFeedGenerator
      params:
      - name: feed
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: AT-URI of the feed generator record.
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get information about a list of feed generators.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getFeedGenerators
      params:
      - name: feeds
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a skeleton of a feed provided by a feed generator.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getFeedSkeleton
      params:
      - name: feed
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: Reference to feed generator record describing the specific feed being requested.
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get like records which reference a subject (by AT-URI and CID).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getLikes
      params:
      - name: uri
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: AT-URI of the subject (eg, a post record).
      - name: cid
        value: bafyreiabc123example
        type: query
        description: CID of the subject record (aka, specific version of record), to filter likes.
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a feed of recent posts from a list (posts and reposts from any actors on the list).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getListFeed
      params:
      - name: list
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: Reference (AT-URI) to the list record.
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get posts in a thread.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getPostThread
      params:
      - name: uri
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: Reference (AT-URI) to post record.
      - name: depth
        value: '6'
        type: query
        description: How many levels of reply depth should be included in response.
      - name: parentHeight
        value: '80'
        type: query
        description: How many levels of parent (and grandparent, etc) post to include.
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Gets post views for a specified list of posts (by AT-URI).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getPosts
      params:
      - name: uris
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: List of post AT-URIs to return hydrated views for.
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of quotes for a given post.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getQuotes
      params:
      - name: uri
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: Reference (AT-URI) of post record
      - name: cid
        value: bafyreiabc123example
        type: query
        description: If supplied, filters to quotes of specific version (by CID) of the post record.
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of reposts for a given post.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getRepostedBy
      params:
      - name: uri
        value: at://did:plc:example123/app.bsky.feed.post/abc123
        type: query
        description: Reference (AT-URI) of post record
      - name: cid
        value: bafyreiabc123example
        type: query
        description: If supplied, filters to reposts of specific version (by CID) of the post record.
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a list of suggested feeds (feed generators) for the requesting account.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getSuggestedFeeds
      params:
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Get a view of the requesting account's home timeline.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.getTimeline
      params:
      - name: algorithm
        value: example-algorithm
        type: query
        description: 'Variant ''algorithm'' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved
          to feed generator mechanism.'
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Find posts matching search criteria, returning views of those posts.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.searchPosts
      params:
      - name: q
        value: example-q
        type: query
        description: Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is
          recommended.
      - name: sort
        value: top
        type: query
        description: Specifies the ranking order of results.
      - name: since
        value: example-since
        type: query
        description: Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp,
          which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD).
      - name: until
        value: example-until
        type: query
        description: Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp,
          which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD).
      - name: mentions
        value: user.bsky.social
        type: query
        description: Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only
          matches rich-text facet mentions.
      - name: author
        value: user.bsky.social
        type: query
        description: Filter to posts by the given account. Handles are resolved to DID before query-time.
      - name: lang
        value: en
        type: query
        description: Filter to posts in the given language. Expected to be based on post language field, though server may
          override language detection.
      - name: domain
        value: example-domain
        type: query
        description: Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may
          apply hostname normalization.
      - name: url
        value: https://example.com/resource
        type: query
        description: Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization
          or fuzzy matching.
      - name: tag
        value: example-tag
        type: query
        description: Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the
          hash (#) prefix. Multiple tags can be specified, with 'AND' matching.
      - name: limit
        value: '25'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
        description: Optional pagination mechanism; may not necessarily allow scrolling through entire result set.
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Send information about interactions with feed items back to the feed generator that served them.
      type: http
    http:
      method: POST
      url: https://bsky.social/xrpc/xrpc/app.bsky.feed.sendInteractions
      body:
        type: json
        data: '{}'
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
- info:
    name: Social Graph
    type: folder
  items:
  - info:
      name: Bluesky Get a list of starter packs created by the actor.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.graph.getActorStarterPacks
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Enumerates which accounts the requesting account is currently blocking.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.graph.getBlocks
      params:
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Enumerates accounts which follow a specified account (actor).
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.graph.getFollowers
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with automatic service proxying. Authenticated requests can be used for
      both public and non-public endpoints.*


      *To learn more about calling atproto API endpoints like this one, see the [API Hosts and Auth](/docs/advance'
  - info:
      name: Bluesky Enumerates accounts which a specified account (actor) follows.
      type: http
    http:
      method: GET
      url: https://bsky.social/xrpc/xrpc/app.bsky.graph.getFollows
      params:
      - name: actor
        value: user.bsky.social
        type: query
      - name: limit
        value: '50'
        type: query
      - name: cursor
        value: eyJsYXN0SWQiOiIxMjM0NTYifQ
        type: query
      auth:
        type: bearer
        token: '{{bearerToken}}'
    docs: '*This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.*`). Public endpoints which don''t require
      authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated
      requests are usually made to the user''s PDS, with autom

# --- truncated at 32 KB (155 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/bluesky/refs/heads/main/apis.yml