Skip to main content
GET
/
api
/
fan
/
get
Get Fan Details
curl --request GET \
  --url https://onlyautomator.com/api/fan/get \
  --header 'Authorization: <authorization>'
{
  "status": "Success",
  "message": "Success",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "of_id": "<string>",
    "username": "<string>",
    "name": "<string>",
    "category": [
      "<string>"
    ],
    "preference": [
      "<string>"
    ],
    "note": "<string>",
    "extra_info": {},
    "avatar_url": "<string>",
    "last_active": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}
Fetches the full profile information for a specific fan (fans table entry) linked to a creator’s account.

​
Authentication

This endpoint requires authentication via bearer token representing a valid user session managed by Supabase Auth (cookies).Testing Note: Requires a valid fan ID and user session.
Retrieving JWT Token: (Refer to other endpoints for instructions)

​
Request

​
username
string
required
The username of the creator’s account associated with the fan.
​
of_id
string
required
The OnlyFans ID (of_id) of the fan to retrieve.
​
Authorization
string
required
Bearer token for authentication. Format: Bearer YOUR_JWT_TOKEN

​
Response

​
status
string
Indicates the result status (e.g., “Success”). Often implicitly 200 OK.
​
message
string
A descriptive message about the result (e.g., “Success”).
​
data
object
The fan data object from the fans table.

​
Error Codes

Status CodeDescriptionExample Message
400Missing username or of_id query parameters.”Username and of_id are required”
401Invalid or missing authentication token.”Unauthorized”
404Creator account associated with username not found.”Account not found”
404Fan with the specified of_id not found for the account.”Fan not found”
500Internal server error during processing.”Internal server error”

​
Code Examples

// Using fetch
const getFanDetails = async (username, ofId, apiToken) => {
  const url = new URL(`https://onlyautomator.com/api/fan/get`);
  url.searchParams.append('username', username);
  url.searchParams.append('of_id', ofId);

  const response = await fetch(url.toString(), {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${apiToken}`
    }
  });

  if (!response.ok) {
     const errorData = await response.json();
     throw new Error(`API Error (${response.status}): ${errorData.error || errorData.message || 'Unknown error'}`);
  }
  return await response.json();
};

// Example usage
getFanDetails('creator_username', 'fan_of_id_123', 'your_api_token')
  .then(data => console.log('Fan details:', data))
  .catch(error => console.error('Error fetching fan details:', error));

​
Notes

  • This endpoint requires both the fan’s OnlyFans ID (of_id) and the username of the creator account they are associated with.
  • It retrieves the fan’s complete record from the fans table.

Headers

​
Authorization
string
required

Bearer token for authentication (JWT)

Query Parameters

​
username
string
required

The username of the creator's account associated with the fan.

​
of_id
string
required

The OnlyFans ID (of_id) of the fan to retrieve.

Response

Fan details retrieved successfully.

​
status
string
Example:

"Success"

​
message
string
Example:

"Success"

​
data
object