Posts

List posts

Posts from every account in a profile, newest first.

GEThttps://app.tryadeli.com/api/v1/posts
AuthorizationBearer <API key>How keys work

Lists posts from the Instagram accounts, Facebook Pages, TikTok accounts, YouTube channels, and Bluesky accounts in one profile, newest first. Passing platform=whatsapp returns 422 unsupported_platform. Uses the aggregate response contract, and follows each provider's pagination internally. TikTok is read 20 posts per request and rate-limited per account, so its listing stops at the 60 most recent posts. YouTube reads cost quota shared by every Adeli customer, so its listing is the 50 most recent videos per channel. X bills every post it returns (X API pricing), so X is listed only when you ask for it with platform=x or an X accountId, and then only the 10 most recent posts. Bluesky lists the 10 most recent top-level posts per account, without replies or reposts; reposts are reported as shares.

Query parameters

platform"instagram" | "facebook" | "tiktok" | "youtube" | "x"
Optional. Narrow to one provider. X is listed only when asked for.
accountIduuid
Narrow to one connected account.
profileIduuid
Required unless you pass accountId, which names its profile. If you pass both, they must agree.

TikTok posts add shares, views, and reach to engagement, and their media[].url is TikTok's embeddable player. For watch time and retention, pass the providerId to TikTok post insights.

YouTube videos add views to engagement; caption is the video's title and media[].url its watch page. Pass the providerId to YouTube video insights for watch time.

X posts add shares (reposts) and views (impressions) to engagement; comments counts replies, and caption is the post's text.

Errors — 401 unauthorized, 400 invalid_request, 422 unsupported_platform, 404 profile_not_found, 404 account_not_found, 502 provider_error.