Get the agency's five highest-spending fans
Returns at most five rows: the fans who spent the most across the agency's creators over the requested date range, best first. Not paginated — ranking is done in the database by earningsView so that the five rows returned are the five highest by the figure you are showing.
A fan can spend across several of the agency's creators, so gross/net are their combined spend and topCreator is the creator they spent the most on in the range, by the same earnings view. Amounts are USD cents from the daily warehouse export. <Info>Requires: Agency admin access</Info>
Query parameters
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset.
Comma-separated list of creator UUIDs (max 50)
Comma-separated list of creator UUIDs to restrict results to a subset of the agency's managed creators (max 50). Every uuid must belong to the agency: one that does not fails the whole request with 403 rather than being ignored.
Which earnings figure to rank by. Both figures are returned on every row regardless.
Which earnings figure to rank by. Both figures are returned on every row regardless.
Headers
API version to use for the request
Response
The agency's five highest-spending fans