Get a Brand's Daily Sponsorship Activity Over Time
Returns a brand’s daily sponsorship activity over the requested pastDayRange, as one time series per platform:
youtubeActivitytracks the brand’s sponsored YouTube videos and the views they gained.instagramActivitydescribes the creators who posted sponsored content for the brand on Instagram.
Neither series includes activity from the brand’s own accounts or combines both platforms. For cross-platform totals, use /sponsor/summary. Each series is sorted by date in ascending order.
Billing is based on the number of days returned (coverage.daysReturned), not on pastDayRange.
- 1–7 days cost 3 credits.
- 8–30 days cost 3.5 credits.
- 31–90 days cost 4 credits.
- 91–180 days cost 4.5 credits.
- 181–400 days cost 5 credits.
- A brand with no history returns empty arrays and isn’t charged.
For details, see API Credit Usage.
daysReturned is at most pastDayRange. The range includes today, and today’s snapshot is added once a day, so a call made before it’s recorded returns at most pastDayRange - 1 days. Days without a snapshot lower it further.
A brandId that isn’t in CreatorDB returns a 404 error. This endpoint has no fields parameter and always returns the whole response. Sending fields, or any other unknown parameter, returns a 400 error (VALIDATION_ERROR) and isn’t charged.
Query Parameters
Number of days of history to return, counting back from today (UTC), today included. A whole number from 1 to 400, without leading zeros. Other values return a 400 error, for example pastDayRange must be between 1 and 400 days. You're billed on the days actually returned, which can be fewer.
^(0|[1-9]\d*)$Response
Brand historical sponsorship data returned successfully.
Sponsor History API response. Contains sponsor history in data, along with credit usage, trace info, and error details.