GET
/
rest
/
v1
/
accounts
Get Accounts
curl --request GET \
  --url https://onlyautomator.com/rest/v1/accounts \
  --header 'Authorization: <authorization>' \
  --header 'apikey: <api-key>'
[
  {
    "id": "f7a12b39-1234-5678-abcd-0123456789ab",
    "user_id": "53fd91a2-4321-5678-efgh-0123456789cd",
    "username": "creator_account",
    "name": "Creator Name",
    "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"
    },
    "proxy_id": "ws_proxy_12345",
    "proxy_address": "1.2.3.4",
    "proxy_port": 8080,
    "proxy_username": "proxy_user",
    "proxy_country_code": "US",
    "proxy_assigned_at": "2023-09-15T14:32:45Z",
    "proxy_mode": "auto",
    "proxy_is_active": true,
    "proxy_region_preference": "DE"
  }
]

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

apikey
string
header
required

Supabase API Key (anon or service_role)

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"

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 | null

Browser cookies captured from the extension.

Example:
{ "sess": "...", "auth_id": "..." }
web_local_storage
object | null

Browser localStorage captured from the extension.

Example:
{ "key": "value" }
web_session_storage
object | null

Browser sessionStorage captured from the extension.

Example:
{ "key": "value" }
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_country_code
string | null

ISO country code of the proxy.

Example:

"US"

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 proxy configuration is active.

Example:

true

proxy_region_preference
string | null

User's preferred country code for auto-assignment.

Example:

"DE"