DEVELOPERS

Loops API Docs

RESOURCE

Video

Represents a video post. Returned by video and feed endpoints. Serialized by VideoResource.

Fields

Field	Type	Description
`id`	string	Unique identifier for the video.
`account`	object	The account that posted the video. A compact subset of the Account resource (see below).
`caption`nullable	string	Caption text. Null when the video has no caption.
`url`	string	Canonical URL of the video.
`shortcode`	string	Short identifier used in the video URL.
`is_owner`	boolean	Whether the authenticated user posted this video.
`is_sensitive`	boolean	Whether the video is marked as sensitive.
`is_local`	boolean	Whether the video is hosted on this instance.
`media`	object	Video media and playback details (see below).
`pinned`	boolean	Whether the video is pinned to the profile.
`likes`	integer	Number of likes.
`shares`	integer	Number of shares.
`comments`	integer	Number of comments.
`bookmarks`	integer	Number of bookmarks.
`has_liked`	boolean	Whether the authenticated user has liked this video.
`has_bookmarked`	boolean	Whether the authenticated user has bookmarked this video.
`is_edited`	boolean	Whether the video has been edited since publishing.
`lang`nullable	string	BCP-47 language code for the caption, or null.
`tags`	array	Hashtags on the video. Empty array when none.
`mentions`	array	Accounts mentioned in the caption. Empty array when none.
`permissions`	object	What the authenticated user may do with this video (see below).
`audio`	object	Audio and sound metadata (see below).
`meta`	object	Content metadata flags (see below).
`created_at`	string	ISO 8601 timestamp of publication.

Example

Video

{
  "id": "107099161459215690",
  "account": {
    "id": "1",
    "name": "dansup",
    "username": "dansup",
    "avatar": "https://loopsusercontent.com/avatars/1/y6i8g7330.jpg"
  },
  "caption": "Wow!",
  "url": "https://loops.video/v/5YvxWOxcRa",
  "shortcode": "5YvxWOxcRa",
  "is_owner": true,
  "is_sensitive": false,
  "is_local": true,
  "media": {
    "thumbnail": "https://loopsusercontent.com/.../SZDoYkIThHJ.jpg",
    "src_url": "https://loopsusercontent.com/videos/1...J.mp4",
    "hls_url": null,
    "alt_text": null,
    "duration": 54,
    "width": 720,
    "height": 1278
  },
  "pinned": true,
  "likes": 327,
  "shares": 23,
  "comments": 50,
  "bookmarks": 6,
  "has_liked": true,
  "has_bookmarked": true,
  "is_edited": true,
  "lang": null,
  "tags": [],
  "mentions": [],
  "permissions": {
    "can_comment": true,
    "can_download": false,
    "can_duet": false,
    "can_stitch": false,
    "can_embed": true
  },
  "audio": {
    "has_audio": true,
    "id": "at:107099161459215690",
    "count": 0,
    "key": "80cf38c3-cd9c-4e75-8e24-a955c79c883b",
    "sound_id": "248936263126653225"
  },
  "meta": {
    "contains_ai": false,
    "contains_ad": false
  },
  "created_at": "2025-01-18T00:15:42+00:00"
}

Some fields are relative to the viewer.is_owner, has_liked, has_bookmarked, and the permissions object reflect the authenticated request, so they change depending on who is asking.

account

A compact form of the Account resource.

Field	Type	Description
`id`	string	Unique identifier for the account.
`name`	string	Display name of the account.
`username`	string	The account handle.
`avatar`	string	URL of the account avatar.

media

Field	Type	Description
`thumbnail`	string	Poster image URL.
`src_url`	string	Direct MP4 source URL.
`hls_url`nullable	string	HLS playlist URL for adaptive streaming. Null when not available.
`alt_text`nullable	string	Accessibility description of the video. Null when not set.
`duration`	integer	Duration in seconds.
`width`	integer	Video width in pixels.
`height`	integer	Video height in pixels.

permissions

Field	Type	Description
`can_comment`	boolean	Whether the user may comment on the video.
`can_download`	boolean	Whether the user may download the video.
`can_duet`	boolean	Whether the user may create a duet.
`can_stitch`	boolean	Whether the user may stitch the video.
`can_embed`	boolean	Whether the video may be embedded.

audio

Field	Type	Description
`has_audio`	boolean	Whether the video has an audio track.
`id`	string	Audio reference. Original audio uses the at:<video-id> form.
`count`	integer	Number of videos using this sound.
`key`	string	Internal audio key (UUID).
`sound_id`	string	Unique identifier of the sound.

Field	Type	Description
`contains_ai`	boolean	Whether the video is flagged as containing AI-generated content.
`contains_ad`	boolean	Whether the video contains a paid promotion or ad.