> ## Documentation Index > Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Subscriber Trend (/api-reference/fanvue/insights/get-subscriber-trend) Get the creator's subscriber events bucketed over time, so growth and churn can be charted. Proxies Fanvue's `GET /v1/insights/subscribers`. This is an analytics time series, not a current audience count: `total` is the cumulative net change since the start of the requested range, not the number of subscribers the creator has. Use List Smart Lists for a live audience. `newSubscribersCount` counts subscription starts rather than distinct people, so a returning fan is counted again. It also includes free trials, starts later refunded or charged back, and fans later banned or deleted, which is why it usually runs higher than the "New" figure on the creator's own Insights dashboard. Buckets are always UTC calendar days. The offsets on `startDate` and `endDate` pick the window, but they do not move the bucket boundaries, and there is no timezone parameter here. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml get /api/fanvue/{fanvueAccount}/insights/subscribers openapi: 3.0.3 info: title: Fanvue API Documentation description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: Account description: Endpoints for your connected Fanvue accounts - name: Chat Messages description: Endpoints for the messages inside a Fanvue chat. - name: Chats description: Endpoints for a Fanvue creator's inbox. A chat is identified by the fan's user UUID. - name: Fans description: "Endpoints for the fans of a Fanvue creator: subscribers, followers, smart lists and per-fan insights." - name: Fanvue Account description: Endpoints for the connected Fanvue creator itself. - name: Insights description: "Revenue and growth reporting for a Fanvue creator: per-transaction earnings, the aggregated earnings summary, the subscriber trend and top spenders." - name: Profiles description: Public Fanvue creator profiles, readable without connecting the creator. paths: /api/fanvue/{fanvueAccount}/insights/subscribers: parameters: - in: path name: fanvueAccount description: The Fanvue Account ID example: fanvue_acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: Get Subscriber Trend operationId: getSubscriberTrend description: >- Get the creator's subscriber events bucketed over time, so growth and churn can be charted. Proxies Fanvue's `GET /v1/insights/subscribers`. This is an analytics time series, not a current audience count: `total` is the cumulative net change since the start of the requested range, not the number of subscribers the creator has. Use List Smart Lists for a live audience. `newSubscribersCount` counts subscription starts rather than distinct people, so a returning fan is counted again. It also includes free trials, starts later refunded or charged back, and fans later banned or deleted, which is why it usually runs higher than the "New" figure on the creator's own Insights dashboard. Buckets are always UTC calendar days. The offsets on `startDate` and `endDate` pick the window, but they do not move the bucket boundaries, and there is no timezone parameter here. parameters: - in: query name: cursor description: Opaque pagination cursor from a previous response's `nextCursor`. example: eyJ2IjoxfQ required: false schema: type: string description: Opaque pagination cursor from a previous response's `nextCursor`. example: eyJ2IjoxfQ - in: query name: size description: Number of buckets to return (1 - 50). Default = 20 example: 20 required: false schema: type: integer description: Number of buckets to return (1 - 50). Default = 20 example: 20 - in: query name: startDate description: Only include events on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z required: false schema: type: string description: Only include events on or after this ISO 8601 datetime. example: 2026-01-01T00:00:00Z - in: query name: endDate description: Only include events before this ISO 8601 datetime (non-inclusive). example: 2026-02-01T00:00:00Z required: false schema: type: string description: Only include events before this ISO 8601 datetime (non-inclusive). example: 2026-02-01T00:00:00Z responses: "200": description: Success content: application/json: schema: type: object example: data: data: - date: 2026-01-15T00:00:00.000Z total: 56 newSubscribersCount: 45 cancelledSubscribersCount: 12 - date: 2026-01-14T00:00:00.000Z total: 23 newSubscribersCount: 38 cancelledSubscribersCount: 15 nextCursor: eyJ2IjoyfQ _meta: _credits: used: 1 balance: 10055811 note: Always _cache: is_cached: false note: Cache disabled for this endpoint _rate_limits: limit_minute: 5000 limit_day: null remaining_minute: 4999 remaining_day: null notice: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. properties: data: type: object properties: data: type: array example: - date: 2026-01-15T00:00:00.000Z total: 56 newSubscribersCount: 45 cancelledSubscribersCount: 12 - date: 2026-01-14T00:00:00.000Z total: 23 newSubscribersCount: 38 cancelledSubscribersCount: 15 items: type: object properties: date: type: string example: 2026-01-15T00:00:00.000Z total: type: integer example: 56 newSubscribersCount: type: integer example: 45 cancelledSubscribersCount: type: integer example: 12 nextCursor: type: string example: eyJ2IjoyfQ _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 10055811 note: type: string example: Always _cache: type: object properties: is_cached: type: boolean example: false note: type: string example: Cache disabled for this endpoint _rate_limits: type: object properties: limit_minute: type: integer example: 5000 limit_day: type: string example: null nullable: true remaining_minute: type: integer example: 4999 remaining_day: type: string example: null nullable: true notice: type: string example: We have decided to remove our daily rate limits. Please remove any references to these in your integrations. tags: - Insights components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````