Video Analytics

Get daily posting activity data

Retrieves daily post counts for the last ~1 year (53 weeks ending last Saturday). Ignores the dateRange filter so the full posting history stays visible; respects platform/account/content-type/project/tag filters.

get/videos/activity

Request

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

Query parameters

platformsstring[] nullable

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

[
  "facebook",
  "instagram"
]
accountsstring[] nullable

Organization account IDs

[
  "orgacc_1A2B3C4D5E6F"
]
viewMode'internal' | 'competitors' | 'all'
daysnumber

Number of days to look back for activity data (1-365 days)

contentTypesstring[] nullable

Content types (video, slideshow)

[
  "video"
]
projectsstring[] nullable

Organization project IDs

Deprecated. Use tag filters (tags / tagGroups) instead — a project's virtual project tag id (orgproj_…) works as a tag id. See the migration guide.

[
  "orgproj_1A2B3C4D5E6F"
]
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"
    ]
  }
]

Response

OK

datestring required

Date in ISO format (YYYY-MM-DD)

countnumber required

Number of videos posted on this date

Example response

[
  {
    "date": "2025-12-15",
    "count": 3
  },
  {
    "date": "2025-12-16",
    "count": 5
  },
  {
    "date": "2025-12-17",
    "count": 2
  },
  {
    "date": "2025-12-18",
    "count": 0
  }
]

Changes

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