Skip to navigation

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

FieldDetails
igUsernameInstagram handle. A leading @ is ignored.
taggedOptional. true returns posts the account is tagged in. Omit it for the account’s own posts. Cannot be combined with postType=reels.
postTypeOptional, Instagram only. posts (default) or reels. Cannot be combined with tagged.
includeTranscriptOptional. true transcribes each video and returns transcript. Omit it or send false to skip transcription. The call takes longer.
limitOptional. Default 20, max 120.
sortByIgnored. Posts are always most recent.

tiktokUsername

FieldDetails
tiktokUsernameTikTok handle. A leading @ is ignored.
includeTranscriptOptional. true transcribes each video and returns transcript. Omit it or send false to skip transcription. The call takes longer.
sortByOptional. most_recent (default) or popular.
limitOptional. Default 20, max 120.

facebookAdLibraryId

FieldDetails
facebookAdLibraryIdFacebook Ad Library page id.
includeTranscriptOptional. true transcribes each video and returns transcript. Omit it or send false to skip transcription. The call takes longer.
sortByOptional. most_recent (default) or most_impressions.
limitOptional. Default 20, max 120.

Authentication

AuthorizationBearer

An API key from Settings → API, prefixed sg_live_.

Query parameters

igUsernamestringOptional1-100 characters

Instagram handle. Exactly one of igUsername, tiktokUsername, or facebookAdLibraryId. A leading @ is ignored. sortBy is ignored.

tiktokUsernamestringOptional1-100 characters

TikTok handle. Exactly one identifier. sortBy is optional: most_recent (default) or popular. A leading @ is ignored. Do not send tagged.

facebookAdLibraryIdstringOptional1-100 characters

Facebook Ad Library page id. Exactly one identifier. sortBy is optional: most_recent (default) or most_impressions. Do not send tagged.

taggedenumOptional

Only with igUsername. true returns posts the account is tagged in. Omit for the account’s own posts.

Allowed values:
postTypeenumOptional

Only with igUsername. posts (default) or reels. Cannot be combined with tagged. Rejected for other identifiers.

Allowed values:
includeTranscriptenumOptional
true transcribes each video and returns transcript. Omit or false to skip transcription.
Allowed values:
sortByenumOptional

Optional. With tiktokUsername: most_recent (default) or popular. With facebookAdLibraryId: most_recent (default) or most_impressions. Ignored with igUsername.

Allowed values:
limitintegerOptional1-120Defaults to 20
Maximum posts to return. Default 20, max 120.

Response

Posts for the account.
countinteger
medialist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
405
Method Not Allowed Error
429
Too Many Requests Error
500
Internal Server Error