Campaign daily breakdown
Per-day videos posted, views generated, and spend (Base + CPM) across the campaign's cycles. Defaults to the full span the cycles cover, in your brand's timezone.
Summing the days reproduces GET /campaign/summary for the same cycles: videos counts each video once on the day it was posted, views is each video's own day-over-day gain, and spend is the day-over-day increase in that day's cycle pay. spend is null on a day no requested cycle covers, and can be negative on a day a pair's pay was revised down.
When tagIds is supplied, videos/views are scoped to that tag set and spend is null for every day — per-day spend cannot be attributed to a tag (pay is a cycle-level total on the pair). Use GET /campaign/tags for total spend by tag.
groupIds scopes videos/views by the video's creator and also nulls spend, for a different reason: the daily spend series is differenced out of a pre-aggregated brand-wide table with no creator dimension. For a group's total spend, use GET /campaign/summary with the same filter.
AuthorizationBearer <token>Provide your API key as Authorization: Bearer <key>.
cycleIds*stringComma-separated cycle ids to include in the campaign.
from?stringClamp the start of the window (YYYY-MM-DD).
dateto?stringClamp the end of the window (YYYY-MM-DD).
datetagIds?stringComma-separated tag ids. Scopes each day's videos/views to videos carrying at least one of these tags; spend becomes null. Get tag ids from GET /campaign/tags.
groupIds?stringComma-separated creator-group ids. Scopes each day's videos/views to videos whose creator is in at least one of these groups; spend becomes null. Get group ids from GET /groups; __ungrouped__ selects creators in no group.
Daily breakdown.
application/json- response
from?stringdateto?stringdatedays?array<>curl -X GET 'https://example.com/api/v0/campaign/daily?cycleIds=string&tagIds=tag_abc%2Ctag_def&groupIds=grp_abc%2Cgrp_def'{ "from": "2019-08-24", "to": "2019-08-24", "days": [ { "date": "2019-08-24", "videos": 0, "views": 0, "spend": 0 } ]}Campaign spend summary GET
The four core metrics for a campaign: total videos, total views, total spend (Base + CPM), and total remaining budget (prepayment − spend). When `prepayment` is provided, also reports budget usage and whether spend has reached the top-up threshold. Both `tagIds` and `groupIds` scope **every** metric here, spend included — pay lives on the pair, which carries both a tag and a creator. This is the endpoint to use for a group's total spend, since `GET /campaign/daily` cannot break that total down by day.
Campaign spend by tag GET
Per-tag breakdown of a campaign's spend and reach. For each of your brand's tags, returns the videos, views, spend (Base + CPM), and CPM attributable to that tag across the campaign's cycles. Spend is attributed by *pair* tag (pairs carry the payout). A pair with multiple tags counts in each tag's bucket, so per-tag totals can exceed the campaign total. Every brand tag is returned, zero-filled when it has no activity. Use the returned `tagId` values as `tagIds` on `GET /campaign/summary` and `GET /campaign/daily`. `groupIds` narrows the population the breakdown describes — "how did this squad's spend split across tags?". The catalog itself is unaffected: every brand tag still comes back, zero-filled where that group has no activity.