> ## 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. # List Smart Link Fans (/api-reference/smart-links/list-smart-link-fans) Query attributed Smart Link fans with aggregate fan metrics and subscriber attribution metadata ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/smart-links/{smart_link_id}/fans openapi: 3.0.3 info: title: OnlyFans API description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: API Keys description: "" - name: Account description: Endpoints for your linked accounts - name: Analytics - Financial description: APIs for retrieving financial analytics data - name: Analytics - Summary description: APIs for retrieving summary analytics data - name: Banking description: Operations related to user banking details, payout methods, legal and tax information, and account country settings. - name: Chargebacks description: "" - name: Chat Messages description: "" - name: Chats description: "" - name: Client Sessions description: "" - name: Connect OnlyFans Account description: "" - name: Data Exports description: APIs for managing data exports - name: Engagement / Messages description: "" - name: Fans description: APIs for managing OnlyFans fans (subscribers) - name: Fans - AI Summary description: APIs for generating and retrieving AI-powered fan profile summaries - name: Following description: APIs for managing OnlyFans followings (people you're subscribed to) - name: Free Trial Links description: APIs for managing Free Trial Links - name: Giphy description: "" - name: Link Tags description: APIs for managing tags on free trial links and tracking links - name: Mass Messaging description: "" - name: Media description: "" - name: Media Vault description: "" - name: Media Vault Lists description: "" - name: Notifications description: Endpoints for managingr account notifications - name: Payouts description: "" - name: Post Comments description: "" - name: Post Labels description: APIs for managing your post labels - name: Posts description: APIs for managing OnlyFans posts - name: Promotions description: "" - name: Public Profiles description: "" - name: Queue description: "" - name: Release Forms description: APIs for managing OnlyFans release forms - name: Saved For Later (Messages) description: "" - name: Saved For Later (Posts) description: "" - name: Settings description: "" - name: Shared Free Trial Links description: APIs for Free Trial Links that other OF creators have shared with this account. Revenue, cost, and spender data are not available for shared links. - name: Shared Tracking Links description: APIs for Tracking Links (campaigns) that other OF creators have shared with this account. Revenue, cost, and spender data are not available for shared campaigns. - name: Smart Link Postbacks description: APIs for managing Smart Link postback destinations - name: Smart Links description: APIs for managing Smart Links (Free Trial Links and Tracking Links with pooled inventory) - name: Statistics description: "" - name: Stored Free Trial Links description: Instant APIs for retrieving stored free trial links from the OnlyFansAPI Cache (free, no credits used) - name: Stored Shared Free Trial Links description: Instant APIs for retrieving stored shared Free Trial Links from the OnlyFansAPI Cache (free, no credits used) - name: Stored Shared Tracking Links description: Instant APIs for retrieving stored shared Tracking Links (campaigns) from the OnlyFansAPI Cache (free, no credits used) - name: Stored Tracking Links description: Instant APIs for retrieving stored tracking links from the OnlyFansAPI Cache (free, no credits used) - name: Stories description: APIs for managing OnlyFans stories - name: Story Highlights description: APIs for managing OnlyFans story highlights - name: Subscription Bundles description: "" - name: Tracking Links description: APIs for managing tracking links - name: Transactions description: APIs for managing OnlyFans transactions - name: User List Collections description: "" - name: Users description: APIs for fetching OnlyFans users - name: Webhooks description: "" paths: /api/smart-links/{smart_link_id}/fans: parameters: - in: path name: smart_link_id description: The ID of the smart link. example: sed required: true schema: type: string get: summary: List Smart Link Fans operationId: listSmartLinkFans description: Query attributed Smart Link fans with aggregate fan metrics and subscriber attribution metadata parameters: - in: query name: limit description: Rows per page. Default `100` example: 100 required: false schema: type: integer description: Rows per page. Default `100` example: 100 - in: query name: offset description: Offset for pagination. Default `0` example: 0 required: false schema: type: integer description: Offset for pagination. Default `0` example: 0 - in: query name: sort description: Optional sort field. Default `-revenue_net` example: -revenue_net required: false schema: type: string description: Optional sort field. Default `-revenue_net` example: -revenue_net enum: - revenue_net - -revenue_net - tips_net - -tips_net - messages_sent_by_fan - -messages_sent_by_fan - converted_at - -converted_at - in: query name: has_messages description: Optional - Filter to fans with or without fan-sent messages example: true required: false schema: type: boolean description: Optional - Filter to fans with or without fan-sent messages example: true - in: query name: min_messages_sent_by_fan description: Optional minimum number of messages sent by fan example: 3 required: false schema: type: integer description: Optional minimum number of messages sent by fan example: 3 - in: query name: min_revenue_net description: Optional minimum net revenue example: 25 required: false schema: type: number description: Optional minimum net revenue example: 25 - in: query name: min_tips_net description: Optional minimum net tips example: 10 required: false schema: type: number description: Optional minimum net tips example: 10 responses: "200": description: Success content: application/json: schema: type: object example: data: summary: fans_total: 3 revenue_net_total: 145 tips_net_total: 45 fans_with_3_plus_messages_total: 1 rows: - fan_id: 101 onlyfans_id: "100000001" username: demo_fan_a name: Demo Fan A avatar_url: https://cdn.example.com/avatar-a.jpg revenue_net: 90 tips_net: 30 messages_sent_by_fan: 4 converted_at: 2026-01-12T12:00:00+00:00 conversion_id: 9001 click_id: 01JTESTCLICK000000000000001 external_click_id: ext-a - fan_id: 102 onlyfans_id: "100000002" username: demo_fan_b name: Demo Fan B avatar_url: https://cdn.example.com/avatar-b.jpg revenue_net: 40 tips_net: 10 messages_sent_by_fan: 2 converted_at: 2026-01-10T10:00:00+00:00 conversion_id: 9002 click_id: 01JTESTCLICK000000000000002 external_click_id: ext-b - fan_id: 103 onlyfans_id: "100000003" username: demo_fan_c name: Demo Fan C avatar_url: null revenue_net: 15 tips_net: 5 messages_sent_by_fan: 0 converted_at: null conversion_id: null click_id: null external_click_id: null filters: limit: 100 offset: 0 sort: -revenue_net has_messages: null min_messages_sent_by_fan: null min_revenue_net: null min_tips_net: null _meta: _credits: used: 0 balance: 999999 note: Free endpoint _cache: is_cached: false note: Cache disabled for this endpoint properties: data: type: object properties: summary: type: object properties: fans_total: type: integer example: 3 revenue_net_total: type: integer example: 145 tips_net_total: type: integer example: 45 fans_with_3_plus_messages_total: type: integer example: 1 rows: type: array example: - fan_id: 101 onlyfans_id: "100000001" username: demo_fan_a name: Demo Fan A avatar_url: https://cdn.example.com/avatar-a.jpg revenue_net: 90 tips_net: 30 messages_sent_by_fan: 4 converted_at: 2026-01-12T12:00:00+00:00 conversion_id: 9001 click_id: 01JTESTCLICK000000000000001 external_click_id: ext-a - fan_id: 102 onlyfans_id: "100000002" username: demo_fan_b name: Demo Fan B avatar_url: https://cdn.example.com/avatar-b.jpg revenue_net: 40 tips_net: 10 messages_sent_by_fan: 2 converted_at: 2026-01-10T10:00:00+00:00 conversion_id: 9002 click_id: 01JTESTCLICK000000000000002 external_click_id: ext-b - fan_id: 103 onlyfans_id: "100000003" username: demo_fan_c name: Demo Fan C avatar_url: null revenue_net: 15 tips_net: 5 messages_sent_by_fan: 0 converted_at: null conversion_id: null click_id: null external_click_id: null items: type: object properties: fan_id: type: integer example: 101 onlyfans_id: type: string example: "100000001" username: type: string example: demo_fan_a name: type: string example: Demo Fan A avatar_url: type: string example: https://cdn.example.com/avatar-a.jpg revenue_net: type: integer example: 90 tips_net: type: integer example: 30 messages_sent_by_fan: type: integer example: 4 converted_at: type: string example: 2026-01-12T12:00:00+00:00 conversion_id: type: integer example: 9001 click_id: type: string example: 01JTESTCLICK000000000000001 external_click_id: type: string example: ext-a filters: type: object properties: limit: type: integer example: 100 offset: type: integer example: 0 sort: type: string example: -revenue_net has_messages: type: string example: null nullable: true min_messages_sent_by_fan: type: string example: null nullable: true min_revenue_net: type: string example: null nullable: true min_tips_net: type: string example: null nullable: true _meta: type: object properties: _credits: type: object properties: used: type: integer example: 0 balance: type: integer example: 999999 note: type: string example: Free endpoint _cache: type: object properties: is_cached: type: boolean example: false note: type: string example: Cache disabled for this endpoint tags: - Smart Links components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````