app.bsky.feed.searchPosts
GET/xrpc/app.bsky.feed.searchPosts
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.
Find posts matching search criteria, returning views of those posts.
Request
Query Parameters
Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.
Possible values: [top, latest]
Default value: latest
Specifies the ranking order of results.
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).
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).
Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.
Filter to posts by the given account. Handles are resolved to DID before query-time.
Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.
Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.
Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.
Possible values: <= 640 characters
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.
Possible values: >= 1 and <= 100
Default value: 25
Optional pagination mechanism; may not necessarily allow scrolling through entire result set.
Responses
- 200
- 400
- 401
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
]
- app.bsky.embed.images.view
- app.bsky.embed.video.view
- app.bsky.embed.external.view
- app.bsky.embed.record.view
- app.bsky.embed.recordWithMedia.view
Array [
]
- app.bsky.embed.record.viewRecord
- app.bsky.embed.record.viewNotFound
- app.bsky.embed.record.viewBlocked
- app.bsky.embed.record.viewDetached
- app.bsky.feed.defs.generatorView
- app.bsky.graph.defs.listView
- app.bsky.labeler.defs.labelerView
- app.bsky.graph.defs.starterPackViewBasic
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
]
Array [
]
Array [
- app.bsky.embed.images.view
- app.bsky.embed.video.view
- app.bsky.embed.external.view
- app.bsky.embed.recordWithMedia.view
Array [
]
- app.bsky.embed.images.view
- app.bsky.embed.video.view
- app.bsky.embed.external.view
Array [
]
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
Array [
Array [
- app.bsky.richtext.facet.mention
- app.bsky.richtext.facet.link
- app.bsky.richtext.facet.tag
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
Array [
- app.bsky.richtext.facet.mention
- app.bsky.richtext.facet.link
- app.bsky.richtext.facet.tag
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
]
Array [
]
- app.bsky.embed.record.viewRecord
- app.bsky.embed.record.viewNotFound
- app.bsky.embed.record.viewBlocked
- app.bsky.embed.record.viewDetached
- app.bsky.feed.defs.generatorView
- app.bsky.graph.defs.listView
- app.bsky.labeler.defs.labelerView
- app.bsky.graph.defs.starterPackViewBasic
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
]
Array [
]
Array [
- app.bsky.embed.images.view
- app.bsky.embed.video.view
- app.bsky.embed.external.view
Array [
]
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
Array [
Array [
- app.bsky.richtext.facet.mention
- app.bsky.richtext.facet.link
- app.bsky.richtext.facet.tag
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
Array [
- app.bsky.richtext.facet.mention
- app.bsky.richtext.facet.link
- app.bsky.richtext.facet.tag
]
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
Array [
]
]
Array [
]
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
Array [
]
Array [
]
- app.bsky.embed.images.view
- app.bsky.embed.video.view
- app.bsky.embed.external.view
Array [
]
Array [
]
Array [
- app.bsky.graph.defs.modlist
- app.bsky.graph.defs.curatelist
- app.bsky.graph.defs.referencelist
Array [
]
]
]
posts
object[]
required
author
object
required
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
Possible values: <= 5
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
embed
object
oneOf
images
object[]
required
Possible values: < 4
Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
Alt text description of the image, for accessibility.
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
Possible values: <= 10000 characters
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
external
object
required
record
object
required
oneOf
author
object
required
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
Possible values: <= 5
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
embeds
object[]
oneOf
images
object[]
required
Possible values: < 4
Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
Alt text description of the image, for accessibility.
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
Possible values: <= 10000 characters
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
external
object
required
media
object
required
oneOf
images
object[]
required
Possible values: < 4
Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
Alt text description of the image, for accessibility.
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
Possible values: <= 10000 characters
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
external
object
required
Default value: true
Default value: true
author
object
required
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Default value: true
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Possible values: <= 3000 characters
descriptionFacets
object[]
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.
features
object[]
required
oneOf
Possible values: <= 640 characters
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
Possible values: <= 3000 characters
descriptionFacets
object[]
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.
features
object[]
required
oneOf
Possible values: <= 640 characters
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
creator
object
required
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
Possible values: <= 5
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
record
object
required
record
object
required
oneOf
author
object
required
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
Possible values: <= 5
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
embeds
object[]
oneOf
images
object[]
required
Possible values: < 4
Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
Alt text description of the image, for accessibility.
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
Possible values: <= 10000 characters
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
external
object
required
Default value: true
Default value: true
author
object
required
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Default value: true
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Possible values: <= 3000 characters
descriptionFacets
object[]
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.
features
object[]
required
oneOf
Possible values: <= 640 characters
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
Possible values: <= 3000 characters
descriptionFacets
object[]
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.
features
object[]
required
oneOf
Possible values: <= 640 characters
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
creator
object
required
Possible values: <= 640 characters
Possible values: <= 2560 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
followers
object[]
required
Possible values: < 5
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
creator
object
required
Possible values: <= 640 characters
associated
object
chat
object
Possible values: [all, none, following]
viewer
object
Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
mutedByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
blockingByList
object
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
knownFollowers
object
The subject's followers whom you also follow
Possible values: <= 5
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
media
object
required
oneOf
images
object[]
required
Possible values: < 4
Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.
Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View.
Alt text description of the image, for accessibility.
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
Possible values: <= 10000 characters
aspectRatio
object
width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.
Possible values: >= 1
Possible values: >= 1
external
object
required
viewer
object
Metadata about the requesting account's relationship with the subject content. Only has meaningful content for authed requests.
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
threadgate
object
lists
object[]
Possible values: non-empty and <= 64 characters
purpose
object
required
oneOf
string
string
string
labels
object[]
DID of the actor who created this label.
AT URI of the record, repository (account), or other resource that this label applies to.
Optionally, CID specifying the specific version of 'uri' resource this label applies to.
Possible values: <= 128 characters
The short string name of the value or type of this label.
If true, this is a negation label, overwriting a previous label.
Timestamp when this label was created.
Timestamp at which this label expires (no longer applies).
Signature of dag-cbor encoded label.
viewer
object
{
"cursor": "string",
"hitsTotal": 0,
"posts": [
{
"uri": "string",
"cid": "string",
"author": {
"did": "string",
"handle": "string",
"displayName": "string",
"avatar": "string",
"associated": {
"lists": 0,
"feedgens": 0,
"starterPacks": 0,
"labeler": true,
"chat": {
"allowIncoming": "all"
}
},
"viewer": {
"muted": true,
"mutedByList": {
"uri": "string",
"cid": "string",
"name": "string",
"purpose": "string",
"avatar": "string",
"listItemCount": 0,
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-11-07T00:27:30.240Z",
"exp": "2024-11-07T00:27:30.240Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-11-07T00:27:30.240Z"
},
"blockedBy": true,
"blocking": "string",
"blockingByList": {
"uri": "string",
"cid": "string",
"name": "string",
"purpose": "string",
"avatar": "string",
"listItemCount": 0,
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-11-07T00:27:30.240Z",
"exp": "2024-11-07T00:27:30.240Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-11-07T00:27:30.240Z"
},
"following": "string",
"followedBy": "string",
"knownFollowers": {
"count": 0,
"followers": [
null
]
}
},
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-11-07T00:27:30.240Z",
"exp": "2024-11-07T00:27:30.240Z",
"sig": "string"
}
],
"createdAt": "2024-11-07T00:27:30.240Z"
},
"record": {},
"embed": {},
"replyCount": 0,
"repostCount": 0,
"likeCount": 0,
"quoteCount": 0,
"indexedAt": "2024-11-07T00:27:30.240Z",
"viewer": {
"repost": "string",
"like": "string",
"threadMuted": true,
"replyDisabled": true,
"embeddingDisabled": true,
"pinned": true
},
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-11-07T00:27:30.240Z",
"exp": "2024-11-07T00:27:30.240Z",
"sig": "string"
}
],
"threadgate": {
"uri": "string",
"cid": "string",
"record": {},
"lists": [
{
"uri": "string",
"cid": "string",
"name": "string",
"purpose": "string",
"avatar": "string",
"listItemCount": 0,
"labels": [
{
"ver": 0,
"src": "string",
"uri": "string",
"cid": "string",
"val": "string",
"neg": true,
"cts": "2024-11-07T00:27:30.240Z",
"exp": "2024-11-07T00:27:30.240Z",
"sig": "string"
}
],
"viewer": {
"muted": true,
"blocked": "string"
},
"indexedAt": "2024-11-07T00:27:30.240Z"
}
]
}
}
]
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [InvalidRequest, ExpiredToken, InvalidToken, BadQueryString]
{
"error": "InvalidRequest",
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}