Account Analytics

Export accounts to CSV

Exports accounts data as CSV with presigned download URL. Includes profile data, analytics metrics, tracking metadata, and computed performance indicators. Respects all filtering options (search, platforms, tags, legacy projects, date ranges). Returns secure download URL valid for 5 minutes.

post/accounts/export

Request

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

Request body

searchstring

Account username on the platform

platformsstring[] nullable

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

accountsstring[] nullable

Organization account IDs

projectsstring[] nullable

Organization project IDs

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.

tagsMatch'rules' | 'videos'

How the tag filter targets rows: rules (default) matches entity-level tag rules only; videos matches rows with at least one video satisfying the whole filter.

contentTypesstring[] nullable

Content types (video, slideshow)

viewMode'internal' | 'competitors' | 'all'

Example request

{
  "search": "viral_creator",
  "platforms": [
    "tiktok",
    "instagram"
  ],
  "accounts": null,
  "tags": null,
  "dateRange": {
    "from": "2025-01-01",
    "to": "2025-01-31"
  },
  "contentTypes": [
    "video"
  ]
}

Response

OK

downloadUrlstring uri required

Presigned download URL for the CSV export file

expiresAtstring date-time required

Expiration timestamp for the download URL (typically 5 minutes)

rowCountnumber required

Total number of data rows included in the export file

fileNamestring required

Generated filename for the export (includes timestamp)

Example response

{
  "downloadUrl": "https://storage.cloudflare.com/exports/video-daily-gains-2025-12-20-143052.csv?signature=abc123",
  "expiresAt": "2025-12-20T14:35:52.000Z",
  "rowCount": 15420,
  "fileName": "video-daily-gains-2025-12-20-143052.csv"
}

Changes

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