Get fan insights in bulk for a creator (POST batch)

Returns detailed insights for up to 100 fans of the specified creator in a single request, keyed by the input fan UUID.

Per-key errors are reported inside the 200 response body so a single forbidden or missing fan never collapses the whole request.

<Note>Maximum 100 fan UUIDs per request. Failed keys are reported as { "error": "forbidden" | "not_found" | "internal" }.</Note>

post/creators/{creatorUserUuid}/insights/fans/batch

Request

Base URL
https://api.fanvue.com
URL
https://api.fanvue.com/creators/{creatorUserUuid}/insights/fans/batch
Auth
OAuth 2
Authorization code: https://auth.fanvue.com/oauth2/auth
Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator, read:insights, read:fan

creatorUserUuidstring uuid required

X-Fanvue-API-Versionstring required

Example:2025-06-26

API version to use for the request

userUuidsstring[] required

Array of fan UUIDs to fetch insights for (1-100)

Per-key insights or error for each requested fan. Always 200 when the request itself is valid, even if every key fails.

object required

Map of input fan UUID to insights or a per-key error (forbidden, not_found, or internal).