Skip to main content
GET
/
rest
/
v1
/
accounts
Get Accounts
curl --request GET \
  --url https://onlyautomator.com/rest/v1/accounts \
  --header 'Authorization: <api-key>' \
  --header 'apikey: <apikey>'
[
  {
    "id": "f7a12b39-1234-5678-abcd-0123456789ab",
    "user_id": "53fd91a2-4321-5678-efgh-0123456789cd",
    "username": "creator_account",
    "name": "Creator Name",
    "of_id": "12345678",
    "status": "connected",
    "last_sync_at": "2023-09-16T10:00:00Z",
    "created_at": "2023-01-15T10:00:00Z",
    "updated_at": "2023-02-20T15:30:00Z",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
    "web_cookies": {
      "sess": "...",
      "auth_id": "..."
    },
    "web_local_storage": {
      "key": "value"
    },
    "web_session_storage": {
      "key": "value"
    },
    "avatar_url": "https://public.onlyfans.com/files/m/mk/mka/.../avatar.jpg",
    "cover_url": "https://public.onlyfans.com/files/h/he/hea/.../header.jpg",
    "display_name": "Creator Display Name",
    "bio": "Welcome to my page!",
    "location": "London, UK",
    "subscribers_count": 1500,
    "current_subscription_price": 9.99,
    "posts_count": 500,
    "photos_count": 350,
    "videos_count": 100,
    "audios_count": 5,
    "medias_count": 455,
    "archived_posts_count": 45,
    "profile_is_private": false,
    "profile_is_verified": true,
    "profile_website": "https://creatorwebsite.com",
    "profile_wishlist": "https://amazon.com/wishlist/...",
    "profile_social_links": {
      "twitter": "...",
      "instagram": "..."
    },
    "proxy_id": "ws_proxy_12345",
    "proxy_address": "1.2.3.4",
    "proxy_port": 8080,
    "proxy_username": "proxy_user",
    "proxy_password": "********",
    "proxy_country_code": "US",
    "proxy_city_name": "New York",
    "proxy_assigned_at": "2023-09-15T14:32:45Z",
    "proxy_mode": "auto",
    "proxy_is_active": true,
    "proxy_region_preference": "DE",
    "proxy_city_preference": "Berlin"
  }
]

​
Get Accounts

Retrieves a list of accounts. Use Supabase query parameters for filtering (e.g., id=eq.value, username=ilike.%pattern%), sorting (order=column.asc), selecting specific columns (select=column1,column2), and pagination (limit=N, offset=N).
Refer to the Supabase PostgREST documentation for detailed filtering options.

​
Example Usage

// Get all accounts for a specific user
const getAllAccountsForUser = async (userId) => {
  const { data, error } = await supabase
    .from('accounts')
    .select('*')
    .eq('user_id', userId);

  if (error) throw error;
  return data;
};

// Get a specific account by ID
const getSpecificAccount = async (accountId) => {
  const { data, error } = await supabase
    .from('accounts')
    .select('*')
    .eq('id', accountId)
    .single(); // Use .single() if you expect only one result

  if (error) throw error;
  return data;
};

Authorizations

​
Authorization
string
header
required

Supabase JWT token, prefix with 'Bearer '. Also requires 'apikey' header.

Headers

​
apikey
string
required

Supabase API Key (anon or service_role)

​
Authorization
string
required

Bearer token for authentication (same as apikey)

Query Parameters

​
select
string

Comma-separated list of fields to select (e.g., id,username,name)

​
order
string

Order results (e.g., created_at.desc)

​
limit
integer

Maximum number of results to return

​
offset
integer

Number of results to skip

Response

List of accounts

​
id
string<uuid>
required
Example:

"f7a12b39-1234-5678-abcd-0123456789ab"

​
user_id
string<uuid>
required

The ID of the user who owns this account.

Example:

"53fd91a2-4321-5678-efgh-0123456789cd"

​
username
string
required

The OnlyFans username associated with this account.

Example:

"creator_account"

​
name
string

The display name (often same as username initially).

Example:

"Creator Name"

​
of_id
string | null

The OnlyFans specific ID for this account.

Example:

"12345678"

​
status
string | null

Current status of the account connection/sync.

Example:

"connected"

​
last_sync_at
string<date-time> | null

Timestamp of the last successful data synchronization.

Example:

"2023-09-16T10:00:00Z"

​
created_at
string<date-time>
Example:

"2023-01-15T10:00:00Z"

​
updated_at
string<date-time>
Example:

"2023-02-20T15:30:00Z"

​
user_agent
string | null

User agent string captured from the extension.

Example:

"Mozilla/5.0 (Windows NT 10.0; Win64; x64)..."

​
web_cookies
object

Browser cookies captured from the extension.

Example:
{ "sess": "...", "auth_id": "..." }
​
web_local_storage
object

Browser localStorage captured from the extension.

Example:
{ "key": "value" }
​
web_session_storage
object

Browser sessionStorage captured from the extension.

Example:
{ "key": "value" }
​
avatar_url
string | null

URL of the account's avatar image.

Example:

"https://public.onlyfans.com/files/m/mk/mka/.../avatar.jpg"

​
cover_url
string | null

URL of the account's cover/header image.

Example:

"https://public.onlyfans.com/files/h/he/hea/.../header.jpg"

​
display_name
string | null

Display name shown on the OnlyFans profile.

Example:

"Creator Display Name"

​
bio
string | null

Bio/about text from the OnlyFans profile.

Example:

"Welcome to my page!"

​
location
string | null

Location listed on the OnlyFans profile.

Example:

"London, UK"

​
subscribers_count
integer | null

Number of current subscribers.

Example:

1500

​
current_subscription_price
number<float> | null

The current price of the subscription.

Example:

9.99

​
posts_count
integer | null

Total number of posts made.

Example:

500

​
photos_count
integer | null

Number of photo posts.

Example:

350

​
videos_count
integer | null

Number of video posts.

Example:

100

​
audios_count
integer | null

Number of audio posts.

Example:

5

​
medias_count
integer | null

Total number of media items (photos+videos+audios).

Example:

455

​
archived_posts_count
integer | null

Number of archived posts.

Example:

45

​
profile_is_private
boolean | null

Whether the OnlyFans profile is private.

Example:

false

​
profile_is_verified
boolean | null

Whether the OnlyFans profile is verified.

Example:

true

​
profile_website
string | null

Website URL listed on the profile.

Example:

"https://creatorwebsite.com"

​
profile_wishlist
string | null

Wishlist URL listed on the profile.

Example:

"https://amazon.com/wishlist/..."

​
profile_social_links
object

Social media links listed on the profile.

Example:
{ "twitter": "...", "instagram": "..." }
​
proxy_id
string | null

Unique identifier from the proxy provider (e.g., Webshare ID).

Example:

"ws_proxy_12345"

​
proxy_address
string | null

IP address or hostname of the assigned proxy.

Example:

"1.2.3.4"

​
proxy_port
integer | null

Port number of the assigned proxy.

Example:

8080

​
proxy_username
string | null

Username for proxy authentication.

Example:

"proxy_user"

​
proxy_password
string | null

Encrypted password for proxy authentication (handle with care).

Example:

"********"

​
proxy_country_code
string | null

ISO country code of the proxy.

Example:

"US"

​
proxy_city_name
string | null

City name of the proxy.

Example:

"New York"

​
proxy_assigned_at
string<date-time> | null

Timestamp when the proxy was assigned.

Example:

"2023-09-15T14:32:45Z"

​
proxy_mode
enum<string> | null
default:none

Proxy configuration mode.

Available options:
auto,
manual,
none
Example:

"auto"

​
proxy_is_active
boolean | null
default:true

Whether the assigned proxy configuration is active.

Example:

true

​
proxy_region_preference
string | null

User's preferred country code for auto-assignment.

Example:

"DE"

​
proxy_city_preference
string | null

User's preferred city for auto-assignment.

Example:

"Berlin"