Get an account's posts
Return one account’s posts, fetched live. The account does not need to be indexed.
A call usually takes 10–30 seconds and starts indexing the rest of the brand’s posts.
Use POST /media first when you already have an account id. See the Finding media guide.
Limited to 120 requests per minute per user.
Costs $0.0010 per creative returned, charged against your plan’s monthly credits. The count field is what you were charged for.
The call bills a minimum of one row even when nothing matches. In that
case count is 0 but you are charged for one row.
Send exactly one identifier. The fields you can send depend on which one you pick.
igUsername
tiktokUsername
facebookAdLibraryId
Authentication
An API key from Settings → API, prefixed sg_live_.
Query parameters
Instagram handle. Exactly one of igUsername, tiktokUsername, or facebookAdLibraryId. A leading @ is ignored. sortBy is ignored.
TikTok handle. Exactly one identifier. sortBy is optional: most_recent (default) or popular. A leading @ is ignored. Do not send tagged.
Facebook Ad Library page id. Exactly one identifier. sortBy is optional: most_recent (default) or most_impressions. Do not send tagged.
Only with igUsername. true returns posts the account is tagged in. Omit for the account’s own posts.
Only with igUsername. posts (default) or reels. Cannot be combined with tagged. Rejected for other identifiers.
Optional. With tiktokUsername: most_recent (default) or popular. With facebookAdLibraryId: most_recent (default) or most_impressions. Ignored with igUsername.