---
canonical_url: "https://docs.composio.dev/toolkits/threads"
markdown_url: "https://docs.composio.dev/toolkits/threads.md"
product: "platform"
version: null
last_updated: null
---

# Threads

Threads is Meta's social network for publishing posts, managing replies, discovering public content, and analyzing profile and post performance.

- **Category:** social media accounts
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `THREADS`
- **Version:** 00000000_00

## Tools

### Create and Share Post

**Slug:** `THREADS_CREATE_AND_SHARE_POST`

Create and publish a top-level Threads post and cross-share it to the linked Instagram account as a Story. Returns crossreshare_to_ig_status to report whether the Story cross-share succeeded independently of Threads publication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment. |
| `user_id` | string | No | Threads user ID to publish for; use `me` for the connected profile. |
| `alt_text` | string | No | Accessibility description for a single image or video, up to 1,000 characters. |
| `image_url` | string | No | Publicly reachable image URL, required when media_type is IMAGE. |
| `topic_tag` | string | No | Topic tag of 1-50 characters; periods and ampersands are not allowed. |
| `video_url` | string | No | Publicly reachable video URL, required when media_type is VIDEO. |
| `media_type` | string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL") | Yes | Primary post media type. |
| `location_id` | string | No | Location ID from THREADS_SEARCH_LOCATIONS. |
| `poll_options` | array | No | Two to four poll choices of 1-25 characters each; valid only for text posts. |
| `tag_location` | boolean | No | Whether to attach location_id; set true only when location tagging is intended. |
| `is_ghost_post` | boolean | No | Create a text ghost post that expires after 24 hours. |
| `quote_post_id` | string | No | Threads post ID to quote. |
| `text_entities` | array | No | Up to 10 spoiler ranges in the post text, each with a type, offset, and length. |
| `carousel_items` | array | No | Two to twenty image or video items for a CAROUSEL post. |
| `gif_attachment` | object | No | Optional GIPHY attachment for a text post. |
| `link_attachment` | string | No | URL to attach to a text post. |
| `text_attachment` | object | No | Optional long-form text attachment for a text post. |
| `is_spoiler_media` | boolean | No | Blur media as a spoiler until the viewer reveals it. |
| `allowlisted_country_codes` | array | No | Two-letter ISO country codes allowed to view the post. |
| `instagram_story_dark_mode` | boolean | No | Use dark mode for the Instagram Story cross-share. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Post

**Slug:** `THREADS_CREATE_POST`

Create and publish a top-level Threads text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment post, optionally with a location tag.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment. |
| `user_id` | string | No | Threads user ID to publish for; use `me` for the connected profile. |
| `alt_text` | string | No | Accessibility description for a single image or video, up to 1,000 characters. |
| `image_url` | string | No | Publicly reachable image URL, required when media_type is IMAGE. |
| `topic_tag` | string | No | Topic tag of 1-50 characters; periods and ampersands are not allowed. |
| `video_url` | string | No | Publicly reachable video URL, required when media_type is VIDEO. |
| `media_type` | string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL") | Yes | Primary post media type. |
| `location_id` | string | No | Location ID from THREADS_SEARCH_LOCATIONS. |
| `poll_options` | array | No | Two to four poll choices of 1-25 characters each; valid only for text posts. |
| `tag_location` | boolean | No | Whether to attach location_id; set true only when location tagging is intended. |
| `is_ghost_post` | boolean | No | Create a text ghost post that expires after 24 hours. |
| `quote_post_id` | string | No | Threads post ID to quote. |
| `reply_control` | string ("everyone" | "accounts_you_follow" | "mentioned_only" | "parent_post_author_only" | "followers_only") | No | Who may reply to the new post. |
| `text_entities` | array | No | Up to 10 spoiler ranges in the post text, each with a type, offset, and length. |
| `carousel_items` | array | No | Two to twenty image or video items for a CAROUSEL post. |
| `gif_attachment` | object | No | Optional GIPHY attachment for a text post. |
| `link_attachment` | string | No | URL to attach to a text post. |
| `text_attachment` | object | No | Optional long-form text attachment for a text post. |
| `is_spoiler_media` | boolean | No | Blur media as a spoiler until the viewer reveals it. |
| `enable_reply_approvals` | boolean | No | Require approval before replies become visible; unsupported for ghost posts. |
| `allowlisted_country_codes` | array | No | Two-letter ISO country codes allowed to view the post. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Reply

**Slug:** `THREADS_CREATE_REPLY`

Create and publish a reply to a Threads post, including a text, image, video, carousel, quote, poll, GIF, or text-attachment reply.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Post or caption text, up to 500 UTF-8 bytes. TEXT posts require this or text_attachment. |
| `user_id` | string | No | Threads user ID to publish for; use `me` for the connected profile. |
| `alt_text` | string | No | Accessibility description for a single image or video, up to 1,000 characters. |
| `image_url` | string | No | Publicly reachable image URL, required when media_type is IMAGE. |
| `topic_tag` | string | No | Topic tag of 1-50 characters; periods and ampersands are not allowed. |
| `video_url` | string | No | Publicly reachable video URL, required when media_type is VIDEO. |
| `media_type` | string ("TEXT" | "IMAGE" | "VIDEO" | "CAROUSEL") | Yes | Primary post media type. |
| `location_id` | string | No | Location ID from THREADS_SEARCH_LOCATIONS. |
| `reply_to_id` | string | Yes | Threads post ID that the new post replies to. |
| `poll_options` | array | No | Two to four poll choices of 1-25 characters each; valid only for text posts. |
| `reply_source` | string ("owned" | "keyword_search" | "mention") | Yes | How the target post was obtained: owned for the connected user's content, keyword_search for search results, or mention for posts mentioning the user. |
| `tag_location` | boolean | No | Whether to attach location_id; set true only when location tagging is intended. |
| `is_ghost_post` | boolean | No | Create a text ghost post that expires after 24 hours. |
| `quote_post_id` | string | No | Threads post ID to quote. |
| `reply_control` | string ("everyone" | "accounts_you_follow" | "mentioned_only" | "parent_post_author_only" | "followers_only") | No | Who may reply to the new post. |
| `text_entities` | array | No | Up to 10 spoiler ranges in the post text, each with a type, offset, and length. |
| `carousel_items` | array | No | Two to twenty image or video items for a CAROUSEL post. |
| `gif_attachment` | object | No | Optional GIPHY attachment for a text post. |
| `link_attachment` | string | No | URL to attach to a text post. |
| `text_attachment` | object | No | Optional long-form text attachment for a text post. |
| `is_spoiler_media` | boolean | No | Blur media as a spoiler until the viewer reveals it. |
| `enable_reply_approvals` | boolean | No | Require approval before replies become visible; unsupported for ghost posts. |
| `allowlisted_country_codes` | array | No | Two-letter ISO country codes allowed to view the post. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Post

**Slug:** `THREADS_DELETE_POST`

Permanently delete a Threads post owned by the connected profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | ID of the owned Threads post to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Location

**Slug:** `THREADS_GET_LOCATION`

Retrieve one Threads location by ID for inspection or post tagging.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | array | No | Location fields to return from id, name, address, city, country, latitude, longitude, and postal code. Omit to use the provider default. |
| `location_id` | string | Yes | Location ID returned by THREADS_SEARCH_LOCATIONS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Profile

**Slug:** `THREADS_GET_MY_PROFILE`

Return the connected or app-scoped Threads user's profile and identity fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | array | No | Profile fields to return from id, username, name, profile picture URL, biography, verification status, geo-gating eligibility, and recently searched keywords. Omit to use the provider default. |
| `user_id` | string | No | App-scoped Threads user ID; use `me` for the connected profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post

**Slug:** `THREADS_GET_POST`

Retrieve one Threads post by ID. Third-party posts may be unavailable until the Meta app has advanced access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | array | No | Post fields to return. Defaults to identity, content, media, relationship, location, poll, spoiler, and attachment fields. The unsupported is_repost field is rejected; use media_type and reposted_post instead. |
| `post_id` | string | Yes | Threads post ID to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post Embed

**Slug:** `THREADS_GET_POST_EMBED`

Return embeddable HTML and oEmbed metadata for a public Threads post.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Permanent URL of the public Threads post to embed. |
| `maxwidth` | integer | No | Maximum embed width in pixels, from 320 through 658. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post Insights

**Slug:** `THREADS_GET_POST_INSIGHTS`

Return selected lifetime engagement metrics for one post owned by the connected Threads profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `metrics` | array | Yes | One or more lifetime post metrics to return. |
| `post_id` | string | Yes | Owned Threads post ID to analyze. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Profile Insights

**Slug:** `THREADS_GET_PROFILE_INSIGHTS`

Return one time-window page of selected profile time-series, totals, link clicks, follower counts, or follower demographics for a Threads profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `since` | integer | No | Start of the insight window as a Unix timestamp. Supply together with until. Unsupported for followers_count and follower_demographics. |
| `until` | integer | No | End of the insight window as a Unix timestamp. Supply together with since. Unsupported for followers_count and follower_demographics. |
| `cursor` | string | No | Opaque continuation cursor from next_cursor in a previous response. Pass it back unchanged with the same metrics to fetch the next time window. |
| `metrics` | array | Yes | Profile metrics to return. Supported values are views, likes, replies, reposts, quotes, clicks, followers_count, and follower_demographics. |
| `user_id` | string | No | App-scoped Threads user ID; use me for the connected profile. |
| `breakdown` | string ("country" | "city" | "age" | "gender") | No | Demographic dimension. Required exactly when follower_demographics is requested; that metric requires at least 100 followers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Publishing Limits

**Slug:** `THREADS_GET_PUBLISHING_LIMITS`

Return current usage and configured quota for Threads posts, replies, deletes, location searches, or all publishing categories.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | No | App-scoped Threads user ID; use `me` for the connected profile. |
| `quota_type` | string ("post" | "reply" | "delete" | "location_search" | "all") | No | Quota category to return. Selecting all requires the permissions for post publishing, replies, deletion, and location search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Ghost Posts

**Slug:** `THREADS_LIST_GHOST_POSTS`

List active and archived ghost posts created by the connected Threads profile, one cursor page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum ghost posts to return in this page. |
| `since` | string | No | Earliest ghost-post time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest ghost-post time as a Unix timestamp or provider-supported date string. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Ghost-post fields to return. Defaults to id, text, timestamp, and ghost_post_status. |
| `user_id` | string | No | App-scoped Threads user ID; use me for the connected profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Mentions

**Slug:** `THREADS_LIST_MY_MENTIONS`

List public Threads posts that mention the connected profile, one cursor page at a time. With development access, Threads may return only mentions made by app testers, so an empty page does not prove that no public mentions exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum mentions to return in this page. |
| `since` | string | No | Earliest mention time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest mention time as a Unix timestamp or provider-supported date string. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Mentioned-post fields to return. Defaults to id, text, timestamp, username, and permalink. |
| `user_id` | string | No | App-scoped Threads user ID; use me for the connected profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Posts

**Slug:** `THREADS_LIST_MY_POSTS`

List posts created by the connected Threads profile, one cursor page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum posts to return in this page. |
| `since` | string | No | Earliest post time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest post time as a Unix timestamp or provider-supported date string. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Post fields to return. Defaults to id, text, timestamp, media_type, and permalink. |
| `user_id` | string | No | App-scoped Threads user ID; use me for the connected profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Replies

**Slug:** `THREADS_LIST_MY_REPLIES`

List replies created by the connected Threads profile, one cursor page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum replies to return in this page. |
| `since` | string | No | Earliest reply time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest reply time as a Unix timestamp or provider-supported date string. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Reply fields to return. Defaults to id, text, timestamp, username, and replied_to. |
| `user_id` | string | No | App-scoped Threads user ID; use me for the connected profile. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pending Replies

**Slug:** `THREADS_LIST_PENDING_REPLIES`

List one page of pending or ignored replies for an owned Threads post. The post must have been created with reply approvals enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Reply fields to return. Defaults to id, text, timestamp, username, and reply_approval_status. |
| `post_id` | string | Yes | Owned Threads post ID that was created with reply approvals enabled. |
| `reverse` | boolean | No | Whether to request reverse chronological/order behavior from Threads. |
| `approval_status` | string ("pending" | "ignored") | No | Restrict results to pending or ignored replies; omit to return both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Post Replies

**Slug:** `THREADS_LIST_POST_REPLIES`

Return either immediate replies or the flattened full conversation for a Threads post, one cursor page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `view` | string ("immediate" | "conversation") | No | Use immediate for top-level replies only, or conversation for a flattened list including nested replies. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Reply fields to return. Defaults to id, text, timestamp, username, and replied-to metadata. |
| `post_id` | string | Yes | Root Threads post ID whose replies to list. |
| `reverse` | boolean | No | Whether to request reverse chronological/order behavior from Threads. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Profile Posts

**Slug:** `THREADS_LIST_PUBLIC_PROFILE_POSTS`

List one cursor page of posts from a qualifying public Threads profile by exact username. Standard or unreviewed app access is restricted to selected official Meta accounts, and returned post IDs may not support direct retrieval until the app has advanced access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum posts to return in this page. |
| `since` | string | No | Earliest post time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest post time as a Unix timestamp or provider-supported date string. |
| `cursor` | string | No | Opaque continuation cursor from a previous response. Omit for the first page and pass it back unchanged to continue. |
| `fields` | array | No | Post fields to return. Defaults to id, text, timestamp, username, and permalink. The owner field is unavailable for public-profile posts. |
| `username` | string | Yes | Exact public Threads username without @. The profile generally needs at least 100 followers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Lookup Public Profile

**Slug:** `THREADS_LOOKUP_PUBLIC_PROFILE`

Look up a qualifying public Threads profile by exact username. Profiles generally need at least 100 followers, and standard or unreviewed app access is restricted to selected official Meta accounts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `username` | string | Yes | Exact public Threads username without @. The profile generally needs at least 100 followers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Repost Post

**Slug:** `THREADS_REPOST_POST`

Repost an existing Threads post to the connected profile; this creates a visible post.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Threads post ID to repost. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Review Pending Reply

**Slug:** `THREADS_REVIEW_PENDING_REPLY`

Approve or ignore one pending reply; an ignored reply can later be approved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `decision` | string ("approve" | "ignore") | Yes | Moderation decision. Approve makes the reply visible; ignore keeps it hidden. |
| `reply_id` | string | Yes | Pending or ignored Threads reply ID to review. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Locations

**Slug:** `THREADS_SEARCH_LOCATIONS`

Search Threads locations by text, coordinates, or both. Returns the provider-ranked unpaginated result set.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Location name, address, or other text to search for. |
| `fields` | array | No | Location fields to return from id, name, address, city, country, latitude, longitude, and postal code. |
| `latitude` | number | No | Latitude for coordinate search; requires longitude. |
| `longitude` | number | No | Longitude for coordinate search; requires latitude. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Posts

**Slug:** `THREADS_SEARCH_POSTS`

Search one page of Threads posts by keyword or topic tag. Broader public results require Meta advanced access, so an empty page may reflect app-review limits rather than no public matches.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum posts to return in this page. |
| `query` | string | Yes | Keyword or topic-tag text to search for. |
| `since` | string | No | Earliest result time as a Unix timestamp or provider-supported date string. |
| `until` | string | No | Latest result time as a Unix timestamp or provider-supported date string. |
| `fields` | array | No | Post fields to return. Defaults to id, text, timestamp, username, permalink, and media_type. |
| `media_type` | string ("TEXT" | "IMAGE" | "VIDEO") | No | Restrict results to one media type. |
| `search_mode` | string ("KEYWORD" | "TAG") | No | Interpret query as ordinary keywords or as a topic tag. |
| `search_type` | string ("TOP" | "RECENT") | No | Rank results by top relevance or recency. |
| `author_username` | string | No | Restrict results to this exact Threads username, without @. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Reply Visibility

**Slug:** `THREADS_SET_REPLY_VISIBILITY`

Hide or unhide a top-level reply and its nested replies on a post managed by the connected profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reply_id` | string | Yes | Top-level Threads reply ID to update. |
| `visibility` | string ("hidden" | "visible") | Yes | Desired reply visibility. Threads also applies the change to nested replies. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |