Skip to content

List videos newest first. Scoped to a single repo when `repo` is supplied; otherwise lists videos across every indexed repo. Returns hydrated video views with author info and view counts.

GET
/xrpc/place.stream.media.getVideoList
repo

DID or handle of the repo whose videos to list. Omit to list videos globally across all repos.

string

DID or handle of the repo whose videos to list. Omit to list videos globally across all repos.

limit

Maximum number of videos to return.

integer
default: 25 >= 1 <= 100

Maximum number of videos to return.

cursor

Pagination cursor from a previous response.

string

Pagination cursor from a previous response.

Success

object
videos
required
Array<object>
object
uri
required
string format: uri
cid
required
string format: cid
author
required
object
did
required
string format: did
debug

Debug information for internal development

avatar
string format: uri
handle
required
string format: handle
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
status
object
cid
string format: cid
uri
string format: uri
embed
One of:
object
external
required
object
uri
required
string format: uri
thumb
string format: uri
title
required
string
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
source

The source of an external embed, such as a standard.site publication.

object
uri
required

URI of the source, if available. Example: the https:// URL of a site.standard.publication record.

string format: uri
icon

Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View.

string format: uri
theme

The theme colors of an external source, such as a site.standard.publication. These colors may be used when rendering an embed from that source.

object
accentRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
backgroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
foregroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
accentForegroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
title
required
string
description
string
createdAt

When the external content was created, if available. Example: a publication date, for an article.

string format: date-time
updatedAt

When the external content was updated, if available.

string format: date-time
description
required
string
readingTime

Estimated reading time in minutes, if applicable and available.

integer
associatedRefs

StrongRefs (uri+cid) of the Atmosphere records that backed this view.

Array<object>
object
cid
required
string format: cid
uri
required
string format: uri
associatedProfiles
Array<object> recursive
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
record
required
status
required

The status for the account.

string
isActive

True if the status is not expired, false if it is expired. Only present if expiration was set.

boolean
expiresAt

The date when this status will expire. The application might choose to no longer return the status after expiration.

string format: date-time
isDisabled

True if the user’s go-live access has been disabled by a moderator, false otherwise.

boolean
viewer

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

object
muted
boolean
blocking
string format: uri
blockedBy
boolean
following
string format: uri
followedBy
string format: uri
mutedByList
object
cid
required
string format: cid
uri
required
string format: uri
name
required
string
>= 1 characters <= 64 characters
avatar
string format: uri
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
viewer
object
muted
boolean
blocked
string format: uri
purpose
required
string
indexedAt
string format: date-time
listItemCount
integer
blockingByList
object
cid
required
string format: cid
uri
required
string format: uri
name
required
string
>= 1 characters <= 64 characters
avatar
string format: uri
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
viewer
object
muted
boolean
blocked
string format: uri
purpose
required
string
indexedAt
string format: date-time
listItemCount
integer
knownFollowers

This property is present only in selected cases, as an optimization.

object
count
required
integer
followers
required
Array<object> recursive
activitySubscription

This property is present only in selected cases, as an optimization.

object
post
required
boolean
reply
required
boolean
pronouns
string
createdAt
string format: date-time
associated
object
chat
object
allowIncoming
required
string
allowGroupInvites
string
germ
object
messageMeUrl
required
string format: uri
showButtonTo
required
string
lists
integer
labeler
boolean
feedgens
integer
starterPacks
integer
activitySubscription
object
allowSubscriptions
required
string
displayName
string
<= 640 characters
verification

Represents the verification information about the user this object is attached to.

object
verifications
required

All verifications issued by trusted verifiers on behalf of this user. Verifications by untrusted verifiers are not included.

Array<object>

An individual verification for an associated subject.

object
uri
required

The AT-URI of the verification record.

string format: uri
issuer
required

The user who issued this verification.

string format: did
isValid
required

True if the verification passes validation, otherwise false.

boolean
createdAt
required

Timestamp when the verification was created.

string format: date-time
issuerHandle

The handle of the issuer.

string format: handle
issuerDisplayName

The display name of the issuer.

string
verifiedStatus
required

The user’s status as a verified account.

string
trustedVerifierStatus
required

The user’s status as a trusted verifier.

string
record
required
likeCount
required

Total number of place.stream.like records whose subject is this video. Always present; zero when none, so consumers can render a count unconditionally.

integer
viewCounts
required

Aggregated view counts across every indexed reporter. Always present; zero-valued (count=0, reporters=0) when no place.stream.media.viewCount records have been observed yet, so consumers can render a count unconditionally.

object
count
required

Sum of count across every indexed report.

integer
bytes
required

Sum of bytes transferred across every track row in every indexed report.

integer
durationMs
required

Sum of playback duration (ms) across every track row in every indexed report.

integer
reporters
required

Number of distinct streamplace nodes that have contributed at least one viewCount record for this video.

integer
tracks
Array<object>
object
uri
required
string format: uri
cid
required
string format: cid
author
required
object
did
required
string format: did
debug

Debug information for internal development

avatar
string format: uri
handle
required
string format: handle
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
status
object
cid
string format: cid
uri
string format: uri
embed
One of:
object
external
required
object
uri
required
string format: uri
thumb
string format: uri
title
required
string
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
source

The source of an external embed, such as a standard.site publication.

object
uri
required

URI of the source, if available. Example: the https:// URL of a site.standard.publication record.

string format: uri
icon

Fully-qualified URL where an icon representing the source can be fetched. For example, CDN location provided by the App View.

string format: uri
theme

The theme colors of an external source, such as a site.standard.publication. These colors may be used when rendering an embed from that source.

object
accentRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
backgroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
foregroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
accentForegroundRGB

RGB color definition, inspired by site.standard.theme.color#rgb

object
b
required
integer
<= 255
g
required
integer
<= 255
r
required
integer
<= 255
title
required
string
description
string
createdAt

When the external content was created, if available. Example: a publication date, for an article.

string format: date-time
updatedAt

When the external content was updated, if available.

string format: date-time
description
required
string
readingTime

Estimated reading time in minutes, if applicable and available.

integer
associatedRefs

StrongRefs (uri+cid) of the Atmosphere records that backed this view.

Array<object>
object
cid
required
string format: cid
uri
required
string format: uri
associatedProfiles
Array<object> recursive
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
record
required
status
required

The status for the account.

string
isActive

True if the status is not expired, false if it is expired. Only present if expiration was set.

boolean
expiresAt

The date when this status will expire. The application might choose to no longer return the status after expiration.

string format: date-time
isDisabled

True if the user’s go-live access has been disabled by a moderator, false otherwise.

boolean
viewer

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

object
muted
boolean
blocking
string format: uri
blockedBy
boolean
following
string format: uri
followedBy
string format: uri
mutedByList
object
cid
required
string format: cid
uri
required
string format: uri
name
required
string
>= 1 characters <= 64 characters
avatar
string format: uri
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
viewer
object
muted
boolean
blocked
string format: uri
purpose
required
string
indexedAt
string format: date-time
listItemCount
integer
blockingByList
object
cid
required
string format: cid
uri
required
string format: uri
name
required
string
>= 1 characters <= 64 characters
avatar
string format: uri
labels
Array<object>

Metadata tag on an atproto resource (eg, repo or record).

object
cid

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

string format: cid
cts
required

Timestamp when this label was created.

string format: date-time
exp

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

string format: date-time
neg

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

boolean
sig

Signature of dag-cbor encoded label.

string format: byte
src
required

DID of the actor who created this label.

string format: did
uri
required

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

string format: uri
val
required

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

string
<= 128 characters
ver

The AT Protocol version of the label object.

integer
viewer
object
muted
boolean
blocked
string format: uri
purpose
required
string
indexedAt
string format: date-time
listItemCount
integer
knownFollowers

This property is present only in selected cases, as an optimization.

object
count
required
integer
followers
required
Array<object> recursive
activitySubscription

This property is present only in selected cases, as an optimization.

object
post
required
boolean
reply
required
boolean
pronouns
string
createdAt
string format: date-time
associated
object
chat
object
allowIncoming
required
string
allowGroupInvites
string
germ
object
messageMeUrl
required
string format: uri
showButtonTo
required
string
lists
integer
labeler
boolean
feedgens
integer
starterPacks
integer
activitySubscription
object
allowSubscriptions
required
string
displayName
string
<= 640 characters
verification

Represents the verification information about the user this object is attached to.

object
verifications
required

All verifications issued by trusted verifiers on behalf of this user. Verifications by untrusted verifiers are not included.

Array<object>

An individual verification for an associated subject.

object
uri
required

The AT-URI of the verification record.

string format: uri
issuer
required

The user who issued this verification.

string format: did
isValid
required

True if the verification passes validation, otherwise false.

boolean
createdAt
required

Timestamp when the verification was created.

string format: date-time
issuerHandle

The handle of the issuer.

string format: handle
issuerDisplayName

The display name of the issuer.

string
verifiedStatus
required

The user’s status as a verified account.

string
trustedVerifierStatus
required

The user’s status as a trusted verifier.

string
record
required
cursor

Pagination cursor for the next page, if any.

string

Bad Request

object
error
required
One of:
string
message
required
string