c5ddcd5c7e72
Get fan profiles in bulk
Returns profile data (handle, display name, avatar, nickname) for up to 100 fans in a single request, keyed by the input fan UUID.
This is intended for screens that render many fans at once (avatar + display name) without per-fan round trips — the profile counterpart to POST /insights/fans/batch.
A profile is returned only for fans connected to the creator (by subscription or follow) — the same fans POST /insights/fans/batch returns insights for. Per-key errors are reported inside the 200 response body so a single missing fan never collapses the whole request.
<Note>Maximum 100 fan UUIDs per request. Failed keys are reported as { "error": "not_found" | "internal" }.</Note>
Headers
API version to use for the request
Request body
Response
Per-key profile or error for each requested fan. Always 200 when the request itself is valid, even if every key fails.
Map of input fan UUID to the fan's profile or a per-key error (forbidden, not_found, or internal). Profiles are returned for the same fans /insights/fans/batch returns insights for — fans connected to the creator by subscription or follow.