Skip to main content
GET
/
account-videos
List account-discovered videos
curl --request GET \
  --url https://api.creatoraudit.com/v2/account-videos \
  --header 'Authorization: Bearer <token>'
{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "errors": [
    {}
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer
default:50

Page size (1–200).

Required range: 1 <= x <= 200
​
cursor
string | null

Opaque pagination.next_cursor from the previous page.

​
sort
string
default:-create_time

Legacy signed sort string (e.g. -create_time). Prefer order_by + order_direction. Allowed keys: create_time, view_count, like_count, play_count.

​
order_by
enum<string> | null

Field to sort by. Overrides sort.

Available options:
create_time,
view_count,
like_count,
play_count
​
order_direction
enum<string> | null

Sort direction (default desc). Used with order_by.

Available options:
asc,
desc
​
platform
enum<string> | null

Filter by platform: instagram or tiktok.

Available options:
instagram,
tiktok
​
account_id
string<uuid> | null

Restrict to a single tracked account. Returns 404 if that account is not tracked by your organization.

​
q
string | null

Case-insensitive substring match against the post/video caption.

Maximum string length: 128
​
include_total
boolean
default:false

When true, the response includes pagination.total_count. Adds one extra COUNT(*) query — leave off for cheap paging.

Response

Successful Response