Skip to main content
GET
List posts

Authorizations

x-api-key
string
header
required

API key for authentication. Get yours from Settings → Integrations

Query Parameters

scope
enum<string>
default:company

Data scope. company (default) returns only the authenticated company's own data. agency returns the union of the parent agency plus every subaccount — use this to pull analytics across all brands.

scope=agency requires an API key belonging to a parent agency account (an account with isAgency=true and no parent). Passing it with a non-agency or subaccount key returns 403.

Available options:
company,
agency
page
integer
default:1
limit
integer
default:25
Required range: x <= 100
program
string[]

Filter by program IDs (multiple allowed)

platform
enum<string>[]

Filter by platforms (multiple allowed)

Available options:
tiktok,
instagram,
youtube
creator
string[]

Filter by creator IDs (multiple allowed)

fromDate
string<date>

Filter posts from this date (YYYY-MM-DD)

toDate
string<date>

Filter posts until this date (YYYY-MM-DD)

Response

200 - application/json

Successfully retrieved posts

data
object[]
page
integer
total
integer