curl --request GET \
--url https://api.fanvue.com/v1/agencies/followers-history \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/agencies/followers-history"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/agencies/followers-history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
"date": "2024-01-15",
"total": 14,
"newFollowersCount": 6
},
{
"creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r9",
"date": "2024-01-14",
"total": 8,
"newFollowersCount": 3
}
],
"nextCursor": "k0FQ1m9yZXN0aWdpb3VzLW9wYXF1ZS1jdXJzb3I",
"total": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}List per-creator-per-day new-follower counts across all agency creators (cursor-paginated)
Returns a single cursor-paginated stream of per-creator-per-day new-follower rows across every creator the authenticated agency manages, sorted by most recent day first.
This endpoint is an analytics time series, not a real-time audience snapshot:
newFollowersCount= number of new follows recorded in the day bucket for the creatortotal(on each row) = cumulative new followers for the creator from the beginning of the requested range (running sum ofnewFollowersCount)
total is therefore cumulative new follows gained within the range, not an absolute or net follower count. For the current follower count, use the account/audience endpoints instead.Page with the opaque nextCursor from the previous response. The result set is bounded by the requested date range, so the envelope’s total is not computed and is always null (distinct from each row’s per-creator total field).
curl --request GET \
--url https://api.fanvue.com/v1/agencies/followers-history \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/agencies/followers-history"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/agencies/followers-history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
"date": "2024-01-15",
"total": 14,
"newFollowersCount": 6
},
{
"creatorUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r9",
"date": "2024-01-14",
"total": 8,
"newFollowersCount": 3
}
],
"nextCursor": "k0FQ1m9yZXN0aWdpb3VzLW9wYXF1ZS1jdXJzb3I",
"total": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}read:agency— Read agency information, including the agency’s team members.read:creator— Access creator profiles, content, and creator-specific information.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Query Parameters
Opaque pagination cursor from a previous response's nextCursor. Omit to fetch the first page.
Number of items to return (1-50, default: 15)
1 <= x <= 50Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset. Range must not exceed 365 days.
Comma-separated list of creator UUIDs to restrict results to a subset of the agency's managed creators (max 50) Comma-separated list of creator UUIDs (max 50)
50Response
Cursor-paginated list of per-creator-per-day new-follower counts across the agency's creators
Array of per-creator-per-day new-follower rows across the agency's creators
Show child attributes
Show child attributes
Opaque cursor for the next page, or null when there are no more results
Total number of items across all pages, or null when no count is computed
Was this page helpful?