Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AT Protocol Feed API

Bluesky feeds, posts, and threads (app.bsky.feed.*)

AT Protocol Feed API is one of 12 APIs that AT Protocol publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Feed. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 4 operations across 4 paths. It is described by OpenAPI 3.1.0, at version 1.0.

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

4 operations 4 paths 0 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://atproto.com/xrpc
Authentication
HTTP Bearer
License
MIT
Resource Areas
1

Authentication & Security 1

AT Protocol Feed API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth).

  • bearerAuth — AT Protocol XRPC bearer auth using the accessJwt returned by com.atproto.server.createSession. The refreshJwt is used for com.atproto.server.refreshSession.

Paths & Operations 4

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

Feed 4

Bluesky feeds, posts, and threads (app.bsky.feed.)

GET
/xrpc/app.bsky.feed.getTimeline
Get the authenticated user's home feed
3 params → 200
GET
/xrpc/app.bsky.feed.getAuthorFeed
Get an actor's posts
4 params → 200
GET
/xrpc/app.bsky.feed.getPostThread
Get a post and its thread
3 params → 200
GET
/xrpc/app.bsky.feed.searchPosts
Full-text search posts
3 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

at-protocol-feed-api-openapi.yml Raw ↑

Other APIs AT Protocol publishes across the network.

AT Protocol XRPC API
AT Protocol Lexicon Schemas
Personal Data Server (PDS) API
AT Protocol Relay & Firehose
Bluesky AppView API
AT Protocol Identity (DID & Handles)
AT Protocol Actor API
AT Protocol Graph API
AT Protocol Identity API
AT Protocol Repo API
AT Protocol Server API