​
Get Fan Details

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: Due to the requirement for a live user session, this endpoint cannot be successfully tested directly using the ‘Send’ button in this documentation with a static token.To test:
  1. Call this endpoint from your web application after logging in.
  2. Use curl or a similar tool with a valid, current user JWT obtained from your browser’s session after logging in.
Retrieving JWT Token for Testing: To test endpoints requiring a user session with tools like curl, you need the JWT access token stored by Supabase Auth in your browser.
  1. Log in to your application normally in your browser.
  2. Open Developer Tools (usually F12).
  3. Go to the Application tab (it might be called Storage in Firefox).
  4. Under the Storage section, find Cookies and select your application’s domain (e.g., http://localhost:3000 or https://onlyautomator.com).
  5. Look for a cookie named similar to sb-access-token (the exact name might vary slightly based on Supabase configuration).
  6. Copy the entire value of this cookie. This is your Bearer token.
  7. Use this copied value in the Authorization: Bearer <your_copied_token> header for your curl or other API tool requests.
Note: This token has a limited lifetime and you’ll need to copy a fresh one after it expires.

​
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. The actual structure depends on the RESPONSE helper.
​
message
string
A descriptive message about the result (e.g., “Success”).
​
data
object
The fan data object from the fans table. Note: The exact fields depend on the fans table schema.

​
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.