app.bsky.feed.searchPosts

GET app.bsky.feed.searchPosts

Find posts matching search criteria, returning views of those posts.

Request

Query Parameters

q stringrequired

Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended.

sort string

Possible values: [top, latest]

Default value: latest

Specifies the ranking order of results.

since string

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

until string

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

mentions at-identifier

Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions.

author at-identifier

Filter to posts by the given account. Handles are resolved to DID before query-time.

lang language

Filter to posts in the given language. Expected to be based on post language field, though server may override language detection.

domain string

Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization.

url uri

Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching.

tag string[]

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.

limit integer

Possible values: >= 1 and <= 100

Default value: 25

cursor string

Optional pagination mechanism; may not necessarily allow scrolling through entire result set.

Responses

application/json

Schema
Example (from schema)

Schema

cursor string

hitsTotal integer

posts

object[]

required

Array [

uri at-urirequired

cid cidrequired

author

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

avatar uri

associated

object

lists integer

feedgens integer

labeler boolean

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

record required

embed

object

oneOf

app.bsky.embed.images.view
app.bsky.embed.external.view
app.bsky.embed.record.view
app.bsky.embed.recordWithMedia.view

images

object[]

required

Possible values: < 4

Array [

thumb urirequired

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

fullsize urirequired

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 stringrequired

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.

width integerrequired

Possible values: >= 1

height integerrequired

Possible values: >= 1

]

record

object

required

oneOf

uri at-urirequired

cid cidrequired

author

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

avatar uri

associated

object

lists integer

feedgens integer

labeler boolean

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

value required

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.

]

replyCount integer

repostCount integer

likeCount integer

embeds

object[]

Array [

oneOf

app.bsky.embed.images.view
app.bsky.embed.external.view
app.bsky.embed.recordWithMedia.view

images

object[]

required

Possible values: < 4

Array [

thumb urirequired

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

fullsize urirequired

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 stringrequired

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.

width integerrequired

Possible values: >= 1

height integerrequired

Possible values: >= 1

]

record required

media

object

required

oneOf

app.bsky.embed.images.view
app.bsky.embed.external.view

images

object[]

required

Possible values: < 4

Array [

thumb urirequired

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

fullsize urirequired

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 stringrequired

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.

width integerrequired

Possible values: >= 1

height integerrequired

Possible values: >= 1

]

indexedAt date-timerequired

uri at-urirequired

notFound booleanrequired

Default value: true

uri at-urirequired

blocked booleanrequired

Default value: true

author

object

required

did didrequired

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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

app.bsky.richtext.facet.mention
app.bsky.richtext.facet.link
app.bsky.richtext.facet.tag

did didrequired

tag stringrequired

Possible values: <= 640 characters

]

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

uri at-urirequired

cid cidrequired

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

description string

Possible values: <= 3000 characters

descriptionFacets

object[]

Array [

index

object

required

byteStart integerrequired

byteEnd integerrequired

features

object[]

required

Array [

oneOf

app.bsky.richtext.facet.mention
app.bsky.richtext.facet.link
app.bsky.richtext.facet.tag

did didrequired

tag stringrequired

Possible values: <= 640 characters

]

avatar uri

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-timerequired

uri at-urirequired

cid cidrequired

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

likeCount integer

viewer

object

like at-uri

indexedAt date-timerequired

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.

]

record

object

required

record

object

required

oneOf

uri at-urirequired

cid cidrequired

author

object

required

did didrequired

handle handlerequired

displayName string

Possible values: <= 640 characters

avatar uri

associated

object

lists integer

feedgens integer

labeler boolean

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

value required

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.

]

replyCount integer

repostCount integer

likeCount integer

embeds

object[]

Array [

oneOf

app.bsky.embed.images.view
app.bsky.embed.external.view

images

object[]

required

Possible values: < 4

Array [

thumb urirequired

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

fullsize urirequired

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 stringrequired

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.

width integerrequired

Possible values: >= 1

height integerrequired

Possible values: >= 1

]

indexedAt date-timerequired

uri at-urirequired

notFound booleanrequired

Default value: true

uri at-urirequired

blocked booleanrequired

Default value: true

author

object

required

did didrequired

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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

byteStart integerrequired

byteEnd integerrequired

features

object[]

required

Array [

oneOf

app.bsky.richtext.facet.mention
app.bsky.richtext.facet.link
app.bsky.richtext.facet.tag

did didrequired

tag stringrequired

Possible values: <= 640 characters

]

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

uri at-urirequired

cid cidrequired

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

description string

Possible values: <= 3000 characters

descriptionFacets

object[]

Array [

index

object

required

byteStart integerrequired

byteEnd integerrequired

features

object[]

required

Array [

oneOf

app.bsky.richtext.facet.mention
app.bsky.richtext.facet.link
app.bsky.richtext.facet.tag

did didrequired

tag stringrequired

Possible values: <= 640 characters

]

avatar uri

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-timerequired

uri at-urirequired

cid cidrequired

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

labeler boolean

indexedAt 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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

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.

]

likeCount integer

viewer

object

like at-uri

indexedAt date-timerequired

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.

]

media

object

required

oneOf

app.bsky.embed.images.view
app.bsky.embed.external.view

images

object[]

required

Possible values: < 4

Array [

thumb urirequired

Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View.

fullsize urirequired

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 stringrequired

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.

width integerrequired

Possible values: >= 1

height integerrequired

Possible values: >= 1

]

replyCount integer

repostCount integer

likeCount integer

indexedAt date-timerequired

viewer

object

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

repost at-uri

like at-uri

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

]

threadgate

object

uri at-uri

cid cid

record

lists

object[]

Array [

uri at-urirequired

cid cidrequired

name stringrequired

Possible values: non-empty and <= 64 characters

purpose

object

required

oneOf

app.bsky.graph.defs.modlist
app.bsky.graph.defs.curatelist

string

avatar uri

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

]

{
  "cursor": "string",
  "hitsTotal": 0,
  "posts": [
    {
      "uri": "string",
      "cid": "string",
      "author": {
        "did": "string",
        "handle": "string",
        "displayName": "string",
        "avatar": "string",
        "associated": {
          "lists": 0,
          "feedgens": 0,
          "labeler": true
        },
        "viewer": {
          "muted": true,
          "mutedByList": {
            "uri": "string",
            "cid": "string",
            "name": "string",
            "purpose": "string",
            "avatar": "string",
            "labels": [
              {
                "ver": 0,
                "src": "string",
                "uri": "string",
                "cid": "string",
                "val": "string",
                "neg": true,
                "cts": "2024-05-13T00:23:45.751Z",
                "exp": "2024-05-13T00:23:45.751Z",
                "sig": "string"
              }
            ],
            "viewer": {
              "muted": true,
              "blocked": "string"
            },
            "indexedAt": "2024-05-13T00:23:45.752Z"
          },
          "blockedBy": true,
          "blocking": "string",
          "blockingByList": {
            "uri": "string",
            "cid": "string",
            "name": "string",
            "purpose": "string",
            "avatar": "string",
            "labels": [
              {
                "ver": 0,
                "src": "string",
                "uri": "string",
                "cid": "string",
                "val": "string",
                "neg": true,
                "cts": "2024-05-13T00:23:45.752Z",
                "exp": "2024-05-13T00:23:45.752Z",
                "sig": "string"
              }
            ],
            "viewer": {
              "muted": true,
              "blocked": "string"
            },
            "indexedAt": "2024-05-13T00:23:45.752Z"
          },
          "following": "string",
          "followedBy": "string"
        },
        "labels": [
          {
            "ver": 0,
            "src": "string",
            "uri": "string",
            "cid": "string",
            "val": "string",
            "neg": true,
            "cts": "2024-05-13T00:23:45.752Z",
            "exp": "2024-05-13T00:23:45.752Z",
            "sig": "string"
          }
        ]
      },
      "record": {},
      "embed": {},
      "replyCount": 0,
      "repostCount": 0,
      "likeCount": 0,
      "indexedAt": "2024-05-13T00:23:45.752Z",
      "viewer": {
        "repost": "string",
        "like": "string",
        "replyDisabled": true
      },
      "labels": [
        {
          "ver": 0,
          "src": "string",
          "uri": "string",
          "cid": "string",
          "val": "string",
          "neg": true,
          "cts": "2024-05-13T00:23:45.752Z",
          "exp": "2024-05-13T00:23:45.752Z",
          "sig": "string"
        }
      ],
      "threadgate": {
        "uri": "string",
        "cid": "string",
        "record": {},
        "lists": [
          {
            "uri": "string",
            "cid": "string",
            "name": "string",
            "purpose": "string",
            "avatar": "string",
            "labels": [
              {
                "ver": 0,
                "src": "string",
                "uri": "string",
                "cid": "string",
                "val": "string",
                "neg": true,
                "cts": "2024-05-13T00:23:45.752Z",
                "exp": "2024-05-13T00:23:45.752Z",
                "sig": "string"
              }
            ],
            "viewer": {
              "muted": true,
              "blocked": "string"
            },
            "indexedAt": "2024-05-13T00:23:45.752Z"
          }
        ]
      }
    }
  ]
}

Bad Request

application/json

Schema
Example (from schema)

Schema

error stringrequired

Possible values: [InvalidRequest, ExpiredToken, InvalidToken, BadQueryString]

message stringrequired

{
  "error": "InvalidRequest",
  "message": "string"
}

Unauthorized

application/json

Schema
Example (from schema)

Schema

error required

message stringrequired

{
  "message": "string"
}

app.bsky.feed.searchPosts