Track Individual Videos

List all tracked videos

Retrieves paginated organization tracked videos with user details and analytics data.

get/videos/tracked

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/videos/tracked
  • Auth: API key in header x-api-key

Query parameters

pagenumber

Page number (1-based index)

Example:1
perPagenumber

Number of items per page (1-100)

Example:10
sortColstring

Sort column

Example:createdAt
sortDir'asc' | 'desc'

Sort direction

Example:asc
platformsstring[] nullable

Social media platforms (facebook, instagram, tiktok, youtube, snapchat)

[
  "facebook",
  "instagram"
]
searchstring
tagsstring[] nullable

Tag IDs. Custom and project tags must all match (intersection); country tags and continent:<CODE> values combine into one geographic group satisfied by any of them. none:<category> values (custom/project/country/continent) match entities WITHOUT any tag of the category. Ignored when tagGroups is provided.

[
  "orgtag_1A2B3C4D5E6F"
]
mode'any' | 'all' required

How the group's tags combine: any = OR, all = intersection.

idsstring[] required

Tag IDs, including continent:<CODE> and none:<category> values.

[
  {
    "mode": "all",
    "ids": [
      "orgtag_1A2B3C4D5E6F"
    ]
  },
  {
    "mode": "any",
    "ids": [
      "systag_1A2B3C4D5E6F",
      "continent:EU"
    ]
  }
]
viewMode'internal' | 'competitors' | 'all'

Response

OK

pageCountnumber required

Total number of pages

totalRowsnumber required

Total number of rows

Example response

{
  "data": [
    {
      "id": "orgvid_91rBGUI9L6Db",
      "platform": "youtube",
      "platformVideoId": "7w4uZc7xCzU",
      "orgAccountId": "orgacc_W97M6KLWV4Yq",
      "lastErrorAt": null,
      "lastErrorCode": null,
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2025-12-20T08:00:00.000Z",
      "actorType": "user",
      "userId": "user_PxyfnFj5JUx5",
      "orgId": "org_GbuDqv3RjdSW",
      "username": "viral_creator",
      "caption": "How we hit 1M views in a week",
      "thumbnailUrl": "https://example.com/thumbnail.jpg",
      "contentType": "video",
      "analyticsLatestLoadAt": "2025-12-20T08:00:00Z",
      "orgAccountMaxVideos": 100,
      "user": {
        "id": "user_PxyfnFj5JUx5",
        "name": "John Doe",
        "image": "https://example.com/avatar.jpg",
        "firstName": "John",
        "lastName": "Doe",
        "role": "member"
      }
    },
    {
      "id": "orgvid_Fiudsi4oSByx",
      "platform": "facebook",
      "platformVideoId": "1487463749406225",
      "orgAccountId": "orgacc_pbWejFdiFqQK",
      "lastErrorAt": "2025-12-18T14:30:00.000Z",
      "lastErrorCode": "NOT_FOUND",
      "createdAt": "2025-02-01T14:30:00.000Z",
      "updatedAt": "2025-12-18T14:30:00.000Z",
      "actorType": "user",
      "userId": "user_9uzTzeSobgkd",
      "orgId": "org_QgqAir1Eydfc",
      "username": "mrtechnicaldifficult",
      "caption": null,
      "thumbnailUrl": null,
      "contentType": null,
      "analyticsLatestLoadAt": null,
      "orgAccountMaxVideos": 50,
      "user": {
        "id": "user_9uzTzeSobgkd",
        "name": "Jane Smith",
        "image": null,
        "firstName": "Jane",
        "lastName": "Smith",
        "role": "admin"
      }
    }
  ],
  "pageCount": 8,
  "totalRows": 156
}

Changes

No recorded changes to this operation across all 1 revision of this API.