Fanvue APIInstall

Summary

Fetches a paginated list of subscribers for a specified creator on Fanvue. Supports date-range filtering (daily aggregated, timezone-aware), cursor-based pagination, and configurable page size.

Inputs

• X-Fanvue-API-Version (required) — API version to use for the request (default: 2025-06-26). Sent as header X-Fanvue-API-Version.
• creatorUserUuid (required) — UUID of the creator whose subscribers are fetched.
• startDate — Start date as ISO 8601 datetime string with optional timezone offset. Data is aggregated daily with timezone-aware boundaries; time component is ignored for daily aggregation.
• endDate — End date as ISO 8601 datetime string. Non-inclusive - data before this date is included. Daily aggregation with timezone-aware boundaries; time component is ignored.
• cursor — Cursor for pagination - if given, pass nextCursor to get the next page.
• size — Number of items to return per page (1-50, default: 20).

Output shape

Returns a list of subscriber objects for the specified creator, paginated according to size and cursor parameters, with date-range filtering applied if provided.

Date filtering uses timezone-aware daily aggregation; the time component of startDate/endDate is ignored for aggregation boundaries.

Examples

Example 1: Basic subscriber fetch

X-Fanvue-API-Version: 2025-06-26, creatorUserUuid: uuid-1234, size: 20

Links

• n8n community nodes installation guide