Skip to main content
GET
/
accounts
List tracked accounts
curl --request GET \
  --url https://api.creatoraudit.com/v2/accounts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "username": "<string>",
      "type": "account",
      "name": "<string>",
      "description": "<string>",
      "profile_pic_url": "<string>",
      "profile_pic_url_original": "<string>",
      "is_verified": false,
      "is_active": true,
      "is_unavailable": false,
      "link_in_bio": "<string>",
      "creator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "creator_name": "<string>",
      "category": "<string>",
      "metadata": {},
      "added_at": "2023-11-07T05:31:56Z",
      "first_scrape_time": "2023-11-07T05:31:56Z",
      "last_scrape_time": "2023-11-07T05:31:56Z",
      "scrape_interval_hours": 24,
      "follower_count": 0,
      "following_count": 0,
      "profile_post_count": 0,
      "total_post_count": 0,
      "view_count": 0,
      "like_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "play_count": 0,
      "saved_count": 123,
      "fb_play_count": 123,
      "ig_play_count": 123,
      "fb_like_count": 123,
      "max_recent_posts_per_account": 123,
      "post_lookback_days": 123,
      "effective_max_recent_posts_per_account": 123,
      "effective_post_lookback_days": 123
    }
  ],
  "pagination": {
    "has_next": true,
    "limit": 123,
    "next_cursor": "<string>",
    "total_count": 123
  },
  "filters": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Page size (1–200).

Required range: 1 <= x <= 200
cursor
string | null

Opaque pagination.next_cursor from the previous page.

sort
string
default:-added_at

Legacy signed sort string (e.g. -added_at). Prefer order_by + order_direction, which are validated as enums. Allowed keys: added_at, username, last_scrape_time, follower_count, view_count, like_count, play_count.

order_by
enum<string> | null

Field to sort by. Overrides sort.

Available options:
added_at,
username,
last_scrape_time,
follower_count,
view_count,
like_count,
play_count
order_direction
enum<string> | null

Sort direction (default desc). Used with order_by.

Available options:
asc,
desc
platform
enum<string> | null

Filter by platform: instagram or tiktok.

Available options:
instagram,
tiktok
is_active
boolean | null

Filter by tracking state (active vs paused).

creator_id
string<uuid> | null

Only accounts linked to this creator.

category
string | null

Filter by the account's category label.

q
string | null

Case-insensitive substring match against the account's username or display name.

Maximum string length: 128
include_total
boolean
default:false

When true, the response includes pagination.total_count. Adds one extra COUNT(*) query — leave off for cheap paging.

Response

Successful Response

data
AccountResponse · object[]
required
pagination
object
required
filters
object