OnlyFans API icon

OnlyFans API

Consume the OnlyFans API

Actions147

Fans → List All Fans

AI-generated

Summary

Retrieve a list of fans for a specified OnlyFans account, optionally applying various filters to refine the results.

Inputs

  • Account ID (required) — The unique identifier of the OnlyFans account whose fans are to be listed.
  • Additional Fields — Optional filters to apply when listing fans, including filter string, number of fans to return (limit, between 1 and 50), minimum subscription duration (days), minimum tips amount, minimum total spent amount, offset to skip a number of fans, online status filter (1 for online), and fan type (e.g., active).

Output shape

a list of fan records, each represented as a JSON object

The number of fans returned respects the 'limit' parameter (default 20) and can be paginated with 'offset'. Filters are optional and narrow the results based on subscription duration, tips, total spent, online status, and fan type.

Examples

Example 1: List all fans of a given account with default limits and no additional filters.

Set the Account ID only.

Example 2: List up to 10 active fans who have been subscribed for at least 30 days and spent at least $100.

Set Account ID; in Additional Fields set Limit=10, Minimum Subscription Duration=30, Minimum Total Spent=100, and Type=active.

Discussion