List Posts

Lists organic TikTok posts & dark posts under a TT_USER identity that supports Spark Ads Pull

Lists organic TikTok posts & dark posts under a TT_USER identity that supports Spark Ads Pull. Returns item_id values for creating Spark Ads from existing posts.

App	TikTok Ads
Operation ID	tiktok_ads_list_posts
Type	Action
Connection	tiktok_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select the TikTok Ads account (advertiser) whose posts should be listed.
identity_id	string or SelectItem	Yes	-	TikTok User identity ID to pull posts from. The identity must be TT_USER and can_pull_video must be true.
item_type	string or SelectableOption	No	-	Type of posts to list. Options: VIDEO (default) or CAROUSEL.
limit	integer	No	100	Maximum number of posts to return. Default: 100.

SelectItem

Field	Type	Required	Default	Description
value	string	Yes	-	The value of the selectable item.
label	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns TikTok posts for the selected TT_USER identity, including item_id, text, status, url, poster_url, duration, width, height, format, and auth_info.