latestOpenAPI 3.1.02026-08-08243131.9 MB
c5ddcd5c7e72
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
Path parameters
creatorUserUuidstring uuid required
Headers
X-Fanvue-API-Versionstring required
Example:2025-06-26
API version to use for the request
Request body
Response
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).