Skip to content

Get a skeleton of a feed provided by a feed generator. Auth is optional, depending on provider requirements, and provides the DID of the requester. Implemented by Feed Generator Service.

GET
/xrpc/app.bsky.feed.getFeedSkeleton
curl --request GET \
--url 'https://example.com/xrpc/app.bsky.feed.getFeedSkeleton?feed=https%3A%2F%2Fexample.com&limit=50'
feed
required

Reference to feed generator record describing the specific feed being requested.

string format: uri

Reference to feed generator record describing the specific feed being requested.

limit
integer
default: 50 >= 1 <= 100
cursor
string

Success

Media typeapplication/json
object
feed
required
Array<object>
object
post
required
string format: uri
reason
One of:
object
repost
required
string format: uri
feedContext

Context that will be passed through to client and may be passed to feed generator back alongside interactions.

string
<= 2000 characters
reqId

Unique identifier per request that may be passed back alongside interactions.

string
<= 100 characters
cursor
string

Example generated

{
"feed": [
{
"post": "https://example.com",
"reason": {
"repost": "https://example.com"
},
"feedContext": "example"
}
],
"reqId": "example",
"cursor": "example"
}

Bad Request

Media typeapplication/json
object
error
required
One of:
string
Allowed value: UnknownFeed
message
required
string

Example

{
"error": "UnknownFeed"
}