List posts
Retrieve social media posts with comprehensive filtering options.
Posts can be filtered by program, platform, creator, date range, and more. Results include engagement metrics (views, likes, comments, etc.)
Agency accounts can pass scope=agency to list posts across the parent
agency and every subaccount in one call.
Authorizations
API key for authentication. Get yours from Settings → Integrations
Query Parameters
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.
company, agency x <= 100Filter by program IDs (multiple allowed)
Filter by platforms (multiple allowed)
tiktok, instagram, youtube Filter by creator IDs (multiple allowed)
Filter posts from this date (YYYY-MM-DD)
Filter posts until this date (YYYY-MM-DD)