Skip to main content
GET
/
api
/
v2
/
get-profile
Get Profile
curl --request GET \
  --url https://onlyautomator.com/api/v2/get-profile \
  --header 'Authorization: Bearer <token>' \
  --header 'username: <username>'
{
  "status": "success",
  "data": {
    "id": "prof_8d2a34bc-5678-9012-ijkl-456789abcdef",
    "onlyFansId": "4798234",
    "username": "creator_username",
    "displayName": "Creator Name",
    "avatarUrl": "https://example.com/avatar.jpg",
    "coverUrl": "https://example.com/cover.jpg",
    "about": "Professional content creator sharing exclusive content with fans.",
    "location": "Los Angeles, CA",
    "subscribersCount": 1250,
    "subscriptionPrice": 9.99,
    "statistics": {
      "postsCount": 325,
      "photosCount": 245,
      "videosCount": 80,
      "ppvSentCount": 142,
      "ppvRevenueTotal": 4562.5
    }
  }
}
Retrieves detailed profile information for the user’s connected OnlyFans account, including personalized statistics and metrics.

​
Endpoint

GET /api/v2/get-profile

​
Authentication

This endpoint requires authentication using a valid JWT token representing a valid user session managed by Supabase Auth (cookies).Include the token in the Authorization header as a Bearer token:
Authorization: Bearer <your_jwt_token>
The JWT token is obtained when connecting the account through the extension, or automatically handled by the browser session.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 Headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer YOUR_JWT_TOKEN
​
Content-Type
string
required
Must be set to application/json
​
username
string
required
OnlyFans username associated with the account

​
Response

​
status
string
Status of the request (success or error)
​
data
object
Profile information object
​
data.id
string
Unique identifier for the profile
​
data.onlyFansId
string
OnlyFans identifier
​
data.username
string
OnlyFans username
​
data.displayName
string
Display name shown on OnlyFans
​
data.avatarUrl
string
URL to the profile avatar image
​
data.coverUrl
string
URL to the profile cover image
​
data.about
string
Profile bio/about section
​
data.location
string
Location displayed on the profile
​
data.subscribersCount
number
Number of current subscribers
​
data.subscriptionPrice
number
Subscription price in USD
​
data.statistics
object
Account performance statistics
​
data.statistics.postsCount
number
Total number of posts
​
data.statistics.photosCount
number
Number of photo posts
​
data.statistics.videosCount
number
Number of video posts
​
data.statistics.ppvSentCount
number
Number of PPV messages sent
​
data.statistics.ppvRevenueTotal
number
Total revenue from PPV messages

​
200 Success

{
  "status": "success",
  "data": {
    "id": "prof_8d2a34bc-5678-9012-ijkl-456789abcdef",
    "onlyFansId": "4798234",
    "username": "creator_username",
    "displayName": "Creator Name",
    "avatarUrl": "https://example.com/avatar.jpg",
    "coverUrl": "https://example.com/cover.jpg",
    "about": "Professional content creator sharing exclusive content with fans.",
    "location": "Los Angeles, CA",
    "subscribersCount": 1250,
    "subscriptionPrice": 9.99,
    "statistics": {
      "postsCount": 325,
      "photosCount": 245,
      "videosCount": 80,
      "ppvSentCount": 142,
      "ppvRevenueTotal": 4562.50
    }
  }
}

​
401 Unauthorized

{
  "status": "error",
  "error": {
    "code": "authentication_required",
    "message": "Authentication is required to access this resource"
  }
}

​
403 Forbidden

{
  "status": "error",
  "error": {
    "code": "permission_denied",
    "message": "Your token does not have permission to access this resource"
  }
}

​
404 Not Found

{
  "status": "error",
  "error": {
    "code": "resource_not_found",
    "message": "Profile not found for the specified username"
  }
}

​
Error Codes

Error CodeDescription
authentication_requiredNo valid authentication token provided
permission_deniedToken lacks required permissions
resource_not_foundProfile not found for the specified username
invalid_usernameThe provided username is invalid
service_unavailableThe profile service is temporarily unavailable

​
Notes

  1. This endpoint provides more detailed profile information than the /get-account endpoint
  2. The data includes analytics that are not directly available through the OnlyFans interface
  3. Revenue statistics are calculated based on the data collected by OnlyAutomator
  4. This information is used by the extension to display analytics in the CRM panel

Authorizations

​
Authorization
string
header
required

Standard user JWT token for authentication.

Headers

​
Authorization
string
required

Bearer token for authentication (JWT)

​
username
string
required

OnlyFans username associated with the account

Response

Profile information retrieved successfully

​
status
string
Example:

"success"

​
data
object