Skip to main content

threads_channel

threads_channel.account_stats

Threads account stats

Effects: read

Get the connected Meta Threads account's profile (username, name, avatar) and account-level insights (followers, views, likes, replies, reposts, quotes).

Arguments

No arguments.

threads_channel.hide_reply

Hide a Threads reply

Effects: write

Hide a reply on a Meta Threads post owned by the connected account. Also hides every nested reply beneath it.

Arguments

ArgumentTypeRequiredDescription
reply_idstringyesThe Threads reply id to hide.

threads_channel.list_posts

List Threads posts

Effects: read

List posts published by the connected Meta Threads account. Returns id, text, permalink, media_type and timestamp. Paginate with the returned after cursor.

Arguments

ArgumentTypeRequiredDescription
afterstringnoPagination cursor from a previous call's after.
limitintegernoPage size, 1-100. Default 25.
sincestringnoISO date (YYYY-MM-DD) lower bound.
untilstringnoISO date (YYYY-MM-DD) upper bound.

threads_channel.post_insights

Threads post insights

Effects: read

Get engagement metrics for one Meta Threads post: views, likes, replies, reposts and quotes.

Arguments

ArgumentTypeRequiredDescription
post_idstringyesThe Threads post id (from threads_channel.list_posts).

threads_channel.publish_post

Publish post to Threads

Effects: write

Publish a post to the connected Meta Threads account. Supports TEXT, IMAGE, VIDEO and CAROUSEL (2-20 items). Text is limited to 500 characters and 5 links. Media must be given as a PUBLIC URL — Threads has no file upload endpoint. Returns the published post id and permalink.

Arguments

ArgumentTypeRequiredDescription
alt_textstringnoAccessibility text for a single IMAGE or VIDEO post.
carousel_itemsarraynoCAROUSEL only: 2-20 items, each {media_type: IMAGE|VIDEO, image_url|video_url, alt_text?}. Order is the render order.
image_urlstringnoPublic URL of the image (JPEG/PNG, max 8MB). IMAGE only.
media_typestringyesTEXT, IMAGE, VIDEO or CAROUSEL. (one of TEXT, IMAGE, VIDEO, CAROUSEL)
reply_controlstringnoWho may reply to this post. OMIT to leave it at the account's default (everyone). (one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only)
reply_to_idstringnoPublish as a reply to this Threads post/reply id.
textstringnoPost text. Required for TEXT, optional caption otherwise. Max 500 characters and 5 links.
video_urlstringnoPublic URL of the video (MOV/MP4, max 1GB / 5 min). VIDEO only.

threads_channel.unhide_reply

Unhide a Threads reply

Effects: write

Unhide a previously hidden reply on a Meta Threads post owned by the connected account. Also unhides its nested replies.

Arguments

ArgumentTypeRequiredDescription
reply_idstringyesThe Threads reply id to unhide.