Skip to content

List accounts

Returns connected social accounts. Only includes accounts within the plan limit by default. Follower data requires analytics add-on. Supports optional server-side pagination via page/limit params. When omitted, returns all accounts (backward-compatible).

GET /v1/accounts

Returns connected social accounts. Only includes accounts within the plan limit by default. Follower data requires analytics add-on. Supports optional server-side pagination via page/limit params. When omitted, returns all accounts (backward-compatible).

Parameters

  • profileId (query, string) — Filter accounts by profile ID

  • platform (query, string) — Filter accounts by platform (e.g. "instagram", "twitter").

  • includeOverLimit (query, boolean) — When true, includes accounts from over-limit profiles.

  • page (query, integer) — Page number (1-based). When provided with limit, enables server-side pagination. Omit for all accounts.

  • limit (query, integer) — Page size. Required alongside page for pagination.

Responses

200 — Accounts (with optional pagination)

  • accounts (array) required
  • hasAnalyticsAccess (boolean) required — Whether user has analytics add-on access
  • pagination ($ref) — Only present when page/limit params are provided

401