Analytics

Global analytics across every connected account

Aggregates the collected metrics of all your active accounts.

The numbers come from Multi Upload Tool's own store, filled by a nightly collector — they are not read from the platforms at request time. Check lastRefreshedAt before presenting them as live: a number without its reading time looks real time, and the first time it disagrees with the platform's own app it reads as a bug rather than a collection that has not run yet.

A metric a platform does not report is counted as 0, not omitted: YouTube exposes no shares, Bluesky no views, Pinterest no likes.

get/analytics/overview

Request

  • Base URL: https://api.multi-upload-tool.com/api/v1
  • URL: https://api.multi-upload-tool.com/api/v1/analytics/overview
  • Auth: API key in header x-api-key

Query parameters

tagsstring

Comma-separated account tags. Only accounts carrying one of them are aggregated.

source'all' | 'mut' | 'external'

Narrow videos (the post ranking) to mut (published through Multi Upload Tool) or external (posted directly on the platform). all or absent keeps every post. Totals and summary always cover every post.

timezonestring

IANA zone the postingInsights weekday and hour buckets are read in, e.g. Europe/Paris. Defaults to UTC. An hour-of-day ranking read in the wrong zone is silently off by the whole offset, so send the user's own.

Headers

X-Team-IDinteger

Act inside this team. Ignored when the token is already pinned to a team; membership is verified on every request.

Response

Aggregated analytics for the matching accounts.

successunknown

Changes

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