Track Accounts

Bulk update account max videos limits

Updates a tracked account setting for multiple accounts at once, selected by accountIds or by scope (every internal, competitor or tracked account; paused accounts only with includePaused). The new limit is clamped onto each account's platform options — Snapchat supports only Pause, 10, or 30 (its public surface stops at the ~29 most recent Spotlights), so higher or unlimited values are stored as 30 for Snapchat accounts in the selection.

put/accounts/tracked/max-videos/bulk

Request

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

Request body

accountIdsstring[]

The tracked accounts to change (at least one), unless scope is given.

scope'internal' | 'competitors' | 'all'

Targets every tracked account of the organization instead of a list of ids: internal = the organization's own accounts, competitors = competitor accounts, all = both. Paused accounts (limit 0) are left out unless includePaused is true.

includePausedboolean

With scope: also target paused accounts (limit 0), which a limit resumes. Leave it out unless the user asks to resume paused accounts too.

Example request

{
  "accountIds": [
    "orgacc_W97M6KLWV4Yq",
    "orgacc_X98N7LMXW5Zr",
    "orgacc_Y99O8MNYX6As"
  ],
  "newMaxVideos": 100
}

Response

successCountnumber required

failedCountnumber required

totalRequestednumber required

creditsConsumednumber required

failedAccountIdsstring[]

Example response

{
  "successCount": 3,
  "failedCount": 0,
  "totalRequested": 3,
  "creditsConsumed": 150
}

Changes

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