Skip to main content

app.bsky.feed.getFeedGenerators

GET 
/xrpc/app.bsky.feed.getFeedGenerators

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 guide.

Get information about a list of feed generators.

Request​

Query Parameters

    feeds at-uri[]required

Responses​

OK

Schema

    feeds

    object[]

    required

  • Array [

    • uri at-urirequired
    cid cidrequired
    did didrequired

    creator

    object

    required

    did didrequired
    handle handlerequired
    displayName string

    Possible values: <= 640 characters

    description string

    Possible values: <= 2560 characters

    avatar uri

    associated

    object

    lists integer
    feedgens integer
    starterPacks integer
    labeler boolean

    chat

    object

    allowIncoming stringrequired

    Possible values: [all, none, following]

    indexedAt date-time
    createdAt date-time

    viewer

    object

    Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.

    muted boolean

    mutedByList

    object

    uri at-urirequired
    cid cidrequired
    name stringrequired

    Possible values: non-empty and <= 64 characters

    purpose

    object

    required

    oneOf

    string

    avatar uri
    listItemCount integer

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • viewer

    object

    muted boolean
    blocked at-uri
    indexedAt date-time
    blockedBy boolean
    blocking at-uri

    blockingByList

    object

    uri at-urirequired
    cid cidrequired
    name stringrequired

    Possible values: non-empty and <= 64 characters

    purpose

    object

    required

    oneOf

    string

    avatar uri
    listItemCount integer

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • viewer

    object

    muted boolean
    blocked at-uri
    indexedAt date-time
    following at-uri
    followedBy at-uri

    knownFollowers

    object

    The subject's followers whom you also follow

    count integerrequired

    followers

    object[]

    required

    Possible values: &lt; 5

  • Array [

    • did didrequired
    handle handlerequired
    displayName string

    Possible values: <= 640 characters

    avatar uri

    associated

    object

    lists integer
    feedgens integer
    starterPacks integer
    labeler boolean

    chat

    object

    allowIncoming stringrequired

    Possible values: [all, none, following]

    viewer

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • createdAt date-time

  • ]

    • labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • displayName stringrequired
    description string

    Possible values: <= 3000 characters

    descriptionFacets

    object[]

  • Array [

    • index

    object

    required

    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 UTF-8 encoded text. NOTE: some languages, like Javascript, use UTF-16 or Unicode codepoints for string slice indexing; in these languages, convert to byte arrays before working with facets.

    byteStart integerrequired
    byteEnd integerrequired

    features

    object[]

    required

  • Array [

    • oneOf

    did didrequired

  • ]

  • ]

    • avatar uri
    likeCount integer
    acceptsInteractions boolean

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • viewer

    object

    like at-uri
    indexedAt date-timerequired

  • ]

Loading...