# Focus · Threads API

> Typed Focus mode operations for Threads accounts, generated from the Threads focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## Threads: List Posts

`GET /accounts/{accountId}/threads/posts`

Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `read` · MCP tool: `threads-posts-list` · Zernio: `GET /v1/accounts/{accountId}/posts`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "media_type": "TEXT_POST",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "username": "string",
      "owner_id": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_repost": true,
      "reposted_post_id": "string",
      "alt_text": "string",
      "link_attachment_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "reply_audience": "everyone",
      "is_spoiler_media": true,
      "text_spoilers": [
        {
          "offset": 1,
          "length": 1
        }
      ],
      "text_attachment": {
        "plaintext": "string",
        "link_attachment_url": "https://example.com",
        "text_with_styling_info": [
          {
            "offset": null,
            "length": null,
            "styling_info": []
          }
        ]
      },
      "topic_tag": "string",
      "location_id": "string",
      "poll": {
        "options": [
          {
            "key": null,
            "label": null,
            "votes_percentage": null
          }
        ],
        "total_votes": 1,
        "expires_at": "2026-10-13T09:00:00.000Z"
      },
      "children": [
        "string"
      ],
      "allowlisted_country_codes": [
        "string"
      ],
      "ghost_post_status": "ACTIVE",
      "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Create a Posts item

`POST /accounts/{accountId}/threads/posts`

Publish now (Threads has no native scheduling; schedule through Socialit posts). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-create` · Zernio: `POST /v1/posts`, `POST /v1/posts/{postId}/unpublish`, `POST /v1/posts/sync-external`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `content` (string; ≤ 500 characters): Post text (≤500; emoji count by UTF-8 bytes)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)
- `replyControl` (string; one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only): Who can reply. Alias: reply_control.
- `enableReplyApprovals` (boolean): Hold replies for approval (pending replies). Not with ghost posts.
- `linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
- `poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
  - one of: Option 1 (array of string)
  - one of: Option 2 (object)
    - `poll.options` (array of string; 2–4 items)
    - `poll.option_a` (string)
    - `poll.option_b` (string)
    - `poll.option_c` (string)
    - `poll.option_d` (string)
- `gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
  - `gif.gifId` (string; required)
  - `gif.provider` (string; one of GIPHY)
- `textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
  - `textSpoilers[].offset` (integer; required)
  - `textSpoilers[].length` (integer; required; ≥ 1)
- `spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
- `textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
  - `textAttachment.plaintext` (string; required; ≤ 10000 characters)
  - `textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
  - `textAttachment.styling` (array of object): Non-overlapping style ranges.
    - `textAttachment.styling[].offset` (integer; required)
    - `textAttachment.styling[].length` (integer; required; ≥ 1)
    - `textAttachment.styling[].styles` (array of string; required)
- `topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `ghostPost` (boolean): Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
- `quotePostId` (string): Quote this Threads post id (also post.quoteExternalId).
- `replyToId` (string): Publish as a reply to this post id (also post.replyToExternalId).
- `allowlistedCountryCodes` (array of string): Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
- `locationId` (string): Location tag id from location search (threads_location_tagging).
- `crossShareToInstagram` (boolean): Also share to the linked Instagram account as a Story (threads_share_to_instagram).
- `crossShareToInstagramDarkMode` (boolean): Dark-mode Instagram Story.
- `autoPublishText` (boolean): Publish TEXT posts in one call (auto_publish_text).
- `thread` (array of object): Follow-up posts chained after the root (each replies to the previous one).
  - `thread[].content` (string; ≤ 500 characters)
  - `thread[].media` (array of object; ≤ 20 items)
    - `thread[].media[].url` (string (uri); required)
    - `thread[].media[].type` (string; one of image, video, gif)
    - `thread[].media[].mimeType` (string)
    - `thread[].media[].altText` (string; ≤ 1000 characters)
  - `thread[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `thread[].mediaItems[].url` (string (uri); required)
    - `thread[].mediaItems[].type` (string; one of image, video, gif)
    - `thread[].mediaItems[].mimeType` (string)
    - `thread[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `thread[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `thread[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `thread[].poll.options` (array of string; 2–4 items)
      - `thread[].poll.option_a` (string)
      - `thread[].poll.option_b` (string)
      - `thread[].poll.option_c` (string)
      - `thread[].poll.option_d` (string)
  - `thread[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `thread[].gif.gifId` (string; required)
    - `thread[].gif.provider` (string; one of GIPHY)
  - `thread[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `thread[].textSpoilers[].offset` (integer; required)
    - `thread[].textSpoilers[].length` (integer; required; ≥ 1)
  - `thread[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `thread[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `thread[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `thread[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `thread[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `thread[].textAttachment.styling[].offset` (integer; required)
      - `thread[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `thread[].textAttachment.styling[].styles` (array of string; required)
  - `thread[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `threadItems` (array of object): Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
  - `threadItems[].content` (string; ≤ 500 characters)
  - `threadItems[].media` (array of object; ≤ 20 items)
    - `threadItems[].media[].url` (string (uri); required)
    - `threadItems[].media[].type` (string; one of image, video, gif)
    - `threadItems[].media[].mimeType` (string)
    - `threadItems[].media[].altText` (string; ≤ 1000 characters)
  - `threadItems[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `threadItems[].mediaItems[].url` (string (uri); required)
    - `threadItems[].mediaItems[].type` (string; one of image, video, gif)
    - `threadItems[].mediaItems[].mimeType` (string)
    - `threadItems[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `threadItems[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `threadItems[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `threadItems[].poll.options` (array of string; 2–4 items)
      - `threadItems[].poll.option_a` (string)
      - `threadItems[].poll.option_b` (string)
      - `threadItems[].poll.option_c` (string)
      - `threadItems[].poll.option_d` (string)
  - `threadItems[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `threadItems[].gif.gifId` (string; required)
    - `threadItems[].gif.provider` (string; one of GIPHY)
  - `threadItems[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `threadItems[].textSpoilers[].offset` (integer; required)
    - `threadItems[].textSpoilers[].length` (integer; required; ≥ 1)
  - `threadItems[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `threadItems[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `threadItems[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `threadItems[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `threadItems[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `threadItems[].textAttachment.styling[].offset` (integer; required)
      - `threadItems[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `threadItems[].textAttachment.styling[].styles` (array of string; required)
  - `threadItems[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `firstComment` (string; ≤ 500 characters): Self-reply posted under the root post (counts toward 250/24 h).
- `altText` (string; ≤ 1000 characters): Fallback alt text for single-media posts.
- `checkQuota` (boolean): Check threads_publishing_limit before publishing (fails fast at 250/24 h).

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ],
    "replyControl": "everyone",
    "enableReplyApprovals": true,
    "linkAttachment": "https://example.com"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "media_type": "TEXT_POST",
  "media_product_type": "string",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "username": "string",
  "owner_id": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "is_quote_post": true,
  "quoted_post_id": "string",
  "is_repost": true,
  "reposted_post_id": "string",
  "alt_text": "string",
  "link_attachment_url": "https://example.com",
  "gif_url": "https://example.com",
  "has_replies": true,
  "reply_audience": "everyone",
  "is_spoiler_media": true,
  "text_spoilers": [
    {
      "offset": 1,
      "length": 1
    }
  ],
  "text_attachment": {
    "plaintext": "string",
    "link_attachment_url": "https://example.com",
    "text_with_styling_info": [
      {
        "offset": 1,
        "length": 1,
        "styling_info": [
          "string"
        ]
      }
    ]
  },
  "topic_tag": "string",
  "location_id": "string",
  "poll": {
    "options": [
      {
        "key": "string",
        "label": "string",
        "votes_percentage": 1.5
      }
    ],
    "total_votes": 1,
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "children": [
    "string"
  ],
  "allowlisted_country_codes": [
    "string"
  ],
  "ghost_post_status": "ACTIVE",
  "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Threads: Get a Posts item

`GET /accounts/{accountId}/threads/posts/{itemId}`

Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `read` · MCP tool: `threads-posts-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "text": "string",
  "media_type": "TEXT_POST",
  "media_product_type": "string",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "username": "string",
  "owner_id": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "is_quote_post": true,
  "quoted_post_id": "string",
  "is_repost": true,
  "reposted_post_id": "string",
  "alt_text": "string",
  "link_attachment_url": "https://example.com",
  "gif_url": "https://example.com",
  "has_replies": true,
  "reply_audience": "everyone",
  "is_spoiler_media": true,
  "text_spoilers": [
    {
      "offset": 1,
      "length": 1
    }
  ],
  "text_attachment": {
    "plaintext": "string",
    "link_attachment_url": "https://example.com",
    "text_with_styling_info": [
      {
        "offset": 1,
        "length": 1,
        "styling_info": [
          "string"
        ]
      }
    ]
  },
  "topic_tag": "string",
  "location_id": "string",
  "poll": {
    "options": [
      {
        "key": "string",
        "label": "string",
        "votes_percentage": 1.5
      }
    ],
    "total_votes": 1,
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "children": [
    "string"
  ],
  "allowlisted_country_codes": [
    "string"
  ],
  "ghost_post_status": "ACTIVE",
  "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Threads: Delete a Posts item

`DELETE /accounts/{accountId}/threads/posts/{itemId}`

Delete the post (100 deletes / 24 h). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Threads: Quote (Posts)

`POST /accounts/{accountId}/threads/posts/{itemId}/quote`

Quote. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-quote`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `content` (string; ≤ 500 characters): Post text (≤500; emoji count by UTF-8 bytes)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)
- `replyControl` (string; one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only): Who can reply. Alias: reply_control.
- `enableReplyApprovals` (boolean): Hold replies for approval (pending replies). Not with ghost posts.
- `linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
- `poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
  - one of: Option 1 (array of string)
  - one of: Option 2 (object)
    - `poll.options` (array of string; 2–4 items)
    - `poll.option_a` (string)
    - `poll.option_b` (string)
    - `poll.option_c` (string)
    - `poll.option_d` (string)
- `gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
  - `gif.gifId` (string; required)
  - `gif.provider` (string; one of GIPHY)
- `textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
  - `textSpoilers[].offset` (integer; required)
  - `textSpoilers[].length` (integer; required; ≥ 1)
- `spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
- `textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
  - `textAttachment.plaintext` (string; required; ≤ 10000 characters)
  - `textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
  - `textAttachment.styling` (array of object): Non-overlapping style ranges.
    - `textAttachment.styling[].offset` (integer; required)
    - `textAttachment.styling[].length` (integer; required; ≥ 1)
    - `textAttachment.styling[].styles` (array of string; required)
- `topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `ghostPost` (boolean): Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
- `quotePostId` (string): Quote this Threads post id (also post.quoteExternalId).
- `replyToId` (string): Publish as a reply to this post id (also post.replyToExternalId).
- `allowlistedCountryCodes` (array of string): Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
- `locationId` (string): Location tag id from location search (threads_location_tagging).
- `crossShareToInstagram` (boolean): Also share to the linked Instagram account as a Story (threads_share_to_instagram).
- `crossShareToInstagramDarkMode` (boolean): Dark-mode Instagram Story.
- `autoPublishText` (boolean): Publish TEXT posts in one call (auto_publish_text).
- `thread` (array of object): Follow-up posts chained after the root (each replies to the previous one).
  - `thread[].content` (string; ≤ 500 characters)
  - `thread[].media` (array of object; ≤ 20 items)
    - `thread[].media[].url` (string (uri); required)
    - `thread[].media[].type` (string; one of image, video, gif)
    - `thread[].media[].mimeType` (string)
    - `thread[].media[].altText` (string; ≤ 1000 characters)
  - `thread[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `thread[].mediaItems[].url` (string (uri); required)
    - `thread[].mediaItems[].type` (string; one of image, video, gif)
    - `thread[].mediaItems[].mimeType` (string)
    - `thread[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `thread[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `thread[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `thread[].poll.options` (array of string; 2–4 items)
      - `thread[].poll.option_a` (string)
      - `thread[].poll.option_b` (string)
      - `thread[].poll.option_c` (string)
      - `thread[].poll.option_d` (string)
  - `thread[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `thread[].gif.gifId` (string; required)
    - `thread[].gif.provider` (string; one of GIPHY)
  - `thread[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `thread[].textSpoilers[].offset` (integer; required)
    - `thread[].textSpoilers[].length` (integer; required; ≥ 1)
  - `thread[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `thread[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `thread[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `thread[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `thread[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `thread[].textAttachment.styling[].offset` (integer; required)
      - `thread[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `thread[].textAttachment.styling[].styles` (array of string; required)
  - `thread[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `threadItems` (array of object): Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
  - `threadItems[].content` (string; ≤ 500 characters)
  - `threadItems[].media` (array of object; ≤ 20 items)
    - `threadItems[].media[].url` (string (uri); required)
    - `threadItems[].media[].type` (string; one of image, video, gif)
    - `threadItems[].media[].mimeType` (string)
    - `threadItems[].media[].altText` (string; ≤ 1000 characters)
  - `threadItems[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `threadItems[].mediaItems[].url` (string (uri); required)
    - `threadItems[].mediaItems[].type` (string; one of image, video, gif)
    - `threadItems[].mediaItems[].mimeType` (string)
    - `threadItems[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `threadItems[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `threadItems[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `threadItems[].poll.options` (array of string; 2–4 items)
      - `threadItems[].poll.option_a` (string)
      - `threadItems[].poll.option_b` (string)
      - `threadItems[].poll.option_c` (string)
      - `threadItems[].poll.option_d` (string)
  - `threadItems[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `threadItems[].gif.gifId` (string; required)
    - `threadItems[].gif.provider` (string; one of GIPHY)
  - `threadItems[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `threadItems[].textSpoilers[].offset` (integer; required)
    - `threadItems[].textSpoilers[].length` (integer; required; ≥ 1)
  - `threadItems[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `threadItems[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `threadItems[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `threadItems[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `threadItems[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `threadItems[].textAttachment.styling[].offset` (integer; required)
      - `threadItems[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `threadItems[].textAttachment.styling[].styles` (array of string; required)
  - `threadItems[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `firstComment` (string; ≤ 500 characters): Self-reply posted under the root post (counts toward 250/24 h).
- `altText` (string; ≤ 1000 characters): Fallback alt text for single-media posts.
- `checkQuota` (boolean): Check threads_publishing_limit before publishing (fails fast at 250/24 h).

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID/quote" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ],
    "replyControl": "everyone",
    "enableReplyApprovals": true,
    "linkAttachment": "https://example.com"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Reply (Posts)

`POST /accounts/{accountId}/threads/posts/{itemId}/reply`

Reply. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Repost (Posts)

`POST /accounts/{accountId}/threads/posts/{itemId}/repost`

Repost. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-repost`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Insights (Posts)

`POST /accounts/{accountId}/threads/posts/{itemId}/insights`

Lifetime views, likes, replies, reposts, quotes and shares. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic, threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-insights`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID/insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Validate draft (Posts)

`POST /accounts/{accountId}/threads/posts/validate`

Pre-flight checks (length, links, media, option combinations) without publishing. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-validate`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `content` (string; ≤ 500 characters): Post text (≤500; emoji count by UTF-8 bytes)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)
- `replyControl` (string; one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only): Who can reply. Alias: reply_control.
- `enableReplyApprovals` (boolean): Hold replies for approval (pending replies). Not with ghost posts.
- `linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
- `poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
  - one of: Option 1 (array of string)
  - one of: Option 2 (object)
    - `poll.options` (array of string; 2–4 items)
    - `poll.option_a` (string)
    - `poll.option_b` (string)
    - `poll.option_c` (string)
    - `poll.option_d` (string)
- `gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
  - `gif.gifId` (string; required)
  - `gif.provider` (string; one of GIPHY)
- `textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
  - `textSpoilers[].offset` (integer; required)
  - `textSpoilers[].length` (integer; required; ≥ 1)
- `spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
- `textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
  - `textAttachment.plaintext` (string; required; ≤ 10000 characters)
  - `textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
  - `textAttachment.styling` (array of object): Non-overlapping style ranges.
    - `textAttachment.styling[].offset` (integer; required)
    - `textAttachment.styling[].length` (integer; required; ≥ 1)
    - `textAttachment.styling[].styles` (array of string; required)
- `topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `ghostPost` (boolean): Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.
- `quotePostId` (string): Quote this Threads post id (also post.quoteExternalId).
- `replyToId` (string): Publish as a reply to this post id (also post.replyToExternalId).
- `allowlistedCountryCodes` (array of string): Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).
- `locationId` (string): Location tag id from location search (threads_location_tagging).
- `crossShareToInstagram` (boolean): Also share to the linked Instagram account as a Story (threads_share_to_instagram).
- `crossShareToInstagramDarkMode` (boolean): Dark-mode Instagram Story.
- `autoPublishText` (boolean): Publish TEXT posts in one call (auto_publish_text).
- `thread` (array of object): Follow-up posts chained after the root (each replies to the previous one).
  - `thread[].content` (string; ≤ 500 characters)
  - `thread[].media` (array of object; ≤ 20 items)
    - `thread[].media[].url` (string (uri); required)
    - `thread[].media[].type` (string; one of image, video, gif)
    - `thread[].media[].mimeType` (string)
    - `thread[].media[].altText` (string; ≤ 1000 characters)
  - `thread[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `thread[].mediaItems[].url` (string (uri); required)
    - `thread[].mediaItems[].type` (string; one of image, video, gif)
    - `thread[].mediaItems[].mimeType` (string)
    - `thread[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `thread[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `thread[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `thread[].poll.options` (array of string; 2–4 items)
      - `thread[].poll.option_a` (string)
      - `thread[].poll.option_b` (string)
      - `thread[].poll.option_c` (string)
      - `thread[].poll.option_d` (string)
  - `thread[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `thread[].gif.gifId` (string; required)
    - `thread[].gif.provider` (string; one of GIPHY)
  - `thread[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `thread[].textSpoilers[].offset` (integer; required)
    - `thread[].textSpoilers[].length` (integer; required; ≥ 1)
  - `thread[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `thread[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `thread[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `thread[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `thread[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `thread[].textAttachment.styling[].offset` (integer; required)
      - `thread[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `thread[].textAttachment.styling[].styles` (array of string; required)
  - `thread[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `threadItems` (array of object): Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.
  - `threadItems[].content` (string; ≤ 500 characters)
  - `threadItems[].media` (array of object; ≤ 20 items)
    - `threadItems[].media[].url` (string (uri); required)
    - `threadItems[].media[].type` (string; one of image, video, gif)
    - `threadItems[].media[].mimeType` (string)
    - `threadItems[].media[].altText` (string; ≤ 1000 characters)
  - `threadItems[].mediaItems` (array of object; ≤ 20 items): Zernio alias of media.
    - `threadItems[].mediaItems[].url` (string (uri); required)
    - `threadItems[].mediaItems[].type` (string; one of image, video, gif)
    - `threadItems[].mediaItems[].mimeType` (string)
    - `threadItems[].mediaItems[].altText` (string; ≤ 1000 characters)
  - `threadItems[].linkAttachment` (string (uri)): Link preview card (TEXT posts only). Alias: link_attachment.
  - `threadItems[].poll` (array of string | object): Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.
    - one of: Option 1 (array of string)
    - one of: Option 2 (object)
      - `threadItems[].poll.options` (array of string; 2–4 items)
      - `threadItems[].poll.option_a` (string)
      - `threadItems[].poll.option_b` (string)
      - `threadItems[].poll.option_c` (string)
      - `threadItems[].poll.option_d` (string)
  - `threadItems[].gif` (object): GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).
    - `threadItems[].gif.gifId` (string; required)
    - `threadItems[].gif.provider` (string; one of GIPHY)
  - `threadItems[].textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
    - `threadItems[].textSpoilers[].offset` (integer; required)
    - `threadItems[].textSpoilers[].length` (integer; required; ≥ 1)
  - `threadItems[].spoilerMedia` (boolean): Blur the image/video/carousel as a spoiler (is_spoiler_media).
  - `threadItems[].textAttachment` (object): Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.
    - `threadItems[].textAttachment.plaintext` (string; required; ≤ 10000 characters)
    - `threadItems[].textAttachment.linkAttachmentUrl` (string (uri)): Not allowed when linkAttachment is set.
    - `threadItems[].textAttachment.styling` (array of object): Non-overlapping style ranges.
      - `threadItems[].textAttachment.styling[].offset` (integer; required)
      - `threadItems[].textAttachment.styling[].length` (integer; required; ≥ 1)
      - `threadItems[].textAttachment.styling[].styles` (array of string; required)
  - `threadItems[].topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.
- `firstComment` (string; ≤ 500 characters): Self-reply posted under the root post (counts toward 250/24 h).
- `altText` (string; ≤ 1000 characters): Fallback alt text for single-media posts.
- `checkQuota` (boolean): Check threads_publishing_limit before publishing (fails fast at 250/24 h).

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/validate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ],
    "replyControl": "everyone",
    "enableReplyApprovals": true,
    "linkAttachment": "https://example.com"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Container status (Posts)

`POST /accounts/{accountId}/threads/posts/container-status`

IN_PROGRESS / FINISHED / PUBLISHED / ERROR / EXPIRED with error_message. Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-container-status`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `container_id` (string; required)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/container-status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "container_id": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Web intent link (Posts)

`POST /accounts/{accountId}/threads/posts/web-intent`

threads.net composer link prefilled with text (no API call). Your Threads posts: text, images, videos, carousels, polls, GIFs, quotes and reposts. Compose with every option, quote, reply, repost or delete. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-discover-posts/retrieve-posts.md Generic route: /v1/accounts/{accountId}/focus/posts.

Access: `write` · MCP tool: `threads-posts-web-intent`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string)
- `url` (string (uri))
- `reply_control` (string)
- `topic_tag` (string)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/web-intent" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "url": "https://example.com",
    "reply_control": "string",
    "topic_tag": "string"
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Ghost posts

`GET /accounts/{accountId}/threads/ghost-posts`

Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.

Access: `read` · MCP tool: `threads-ghost-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/ghost-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "media_type": "TEXT_POST",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "username": "string",
      "owner_id": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_repost": true,
      "reposted_post_id": "string",
      "alt_text": "string",
      "link_attachment_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "reply_audience": "everyone",
      "is_spoiler_media": true,
      "text_spoilers": [
        {
          "offset": 1,
          "length": 1
        }
      ],
      "text_attachment": {
        "plaintext": "string",
        "link_attachment_url": "https://example.com",
        "text_with_styling_info": [
          {
            "offset": null,
            "length": null,
            "styling_info": []
          }
        ]
      },
      "topic_tag": "string",
      "location_id": "string",
      "poll": {
        "options": [
          {
            "key": null,
            "label": null,
            "votes_percentage": null
          }
        ],
        "total_votes": 1,
        "expires_at": "2026-10-13T09:00:00.000Z"
      },
      "children": [
        "string"
      ],
      "allowlisted_country_codes": [
        "string"
      ],
      "ghost_post_status": "ACTIVE",
      "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Create a Ghost posts item

`POST /accounts/{accountId}/threads/ghost-posts`

Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.

Access: `write` · MCP tool: `threads-ghost-posts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `content` (string; required; ≤ 500 characters)
- `textSpoilers` (array of object; ≤ 10 items): Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].
  - `textSpoilers[].offset` (integer; required)
  - `textSpoilers[].length` (integer; required; ≥ 1)
- `replyControl` (string; one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only): Who can reply. Alias: reply_control.
- `topicTag` (string; 1–50 characters, pattern ^[^.&]+$): One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/ghost-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "textSpoilers": [
      {
        "offset": 0,
        "length": 1
      }
    ],
    "replyControl": "everyone",
    "topicTag": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "media_type": "TEXT_POST",
  "media_product_type": "string",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "username": "string",
  "owner_id": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "is_quote_post": true,
  "quoted_post_id": "string",
  "is_repost": true,
  "reposted_post_id": "string",
  "alt_text": "string",
  "link_attachment_url": "https://example.com",
  "gif_url": "https://example.com",
  "has_replies": true,
  "reply_audience": "everyone",
  "is_spoiler_media": true,
  "text_spoilers": [
    {
      "offset": 1,
      "length": 1
    }
  ],
  "text_attachment": {
    "plaintext": "string",
    "link_attachment_url": "https://example.com",
    "text_with_styling_info": [
      {
        "offset": 1,
        "length": 1,
        "styling_info": [
          "string"
        ]
      }
    ]
  },
  "topic_tag": "string",
  "location_id": "string",
  "poll": {
    "options": [
      {
        "key": "string",
        "label": "string",
        "votes_percentage": 1.5
      }
    ],
    "total_votes": 1,
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "children": [
    "string"
  ],
  "allowlisted_country_codes": [
    "string"
  ],
  "ghost_post_status": "ACTIVE",
  "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Threads: Delete a Ghost posts item

`DELETE /accounts/{accountId}/threads/ghost-posts/{itemId}`

Text posts that auto-archive after 24 hours (ACTIVE / ARCHIVED). Text spoilers only, cannot be replies. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/create-posts/ghost-posts.md Generic route: /v1/accounts/{accountId}/focus/ghost-posts.

Access: `write` · MCP tool: `threads-ghost-posts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/ghost-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Threads: List Reposts

`GET /accounts/{accountId}/threads/reposts`

Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: `read` · MCP tool: `threads-reposts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "media_type": "TEXT_POST",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "username": "string",
      "owner_id": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_repost": true,
      "reposted_post_id": "string",
      "alt_text": "string",
      "link_attachment_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "reply_audience": "everyone",
      "is_spoiler_media": true,
      "text_spoilers": [
        {
          "offset": 1,
          "length": 1
        }
      ],
      "text_attachment": {
        "plaintext": "string",
        "link_attachment_url": "https://example.com",
        "text_with_styling_info": [
          {
            "offset": null,
            "length": null,
            "styling_info": []
          }
        ]
      },
      "topic_tag": "string",
      "location_id": "string",
      "poll": {
        "options": [
          {
            "key": null,
            "label": null,
            "votes_percentage": null
          }
        ],
        "total_votes": 1,
        "expires_at": "2026-10-13T09:00:00.000Z"
      },
      "children": [
        "string"
      ],
      "allowlisted_country_codes": [
        "string"
      ],
      "ghost_post_status": "ACTIVE",
      "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Create a Reposts item

`POST /accounts/{accountId}/threads/reposts`

Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_content_publish. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: `write` · MCP tool: `threads-reposts-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `post_id` (string; required): Threads media id to repost

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string"
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "media_type": "TEXT_POST",
  "media_product_type": "string",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "permalink": "https://example.com",
  "shortcode": "string",
  "username": "string",
  "owner_id": "string",
  "timestamp": "2026-10-13T09:00:00.000Z",
  "is_quote_post": true,
  "quoted_post_id": "string",
  "is_repost": true,
  "reposted_post_id": "string",
  "alt_text": "string",
  "link_attachment_url": "https://example.com",
  "gif_url": "https://example.com",
  "has_replies": true,
  "reply_audience": "everyone",
  "is_spoiler_media": true,
  "text_spoilers": [
    {
      "offset": 1,
      "length": 1
    }
  ],
  "text_attachment": {
    "plaintext": "string",
    "link_attachment_url": "https://example.com",
    "text_with_styling_info": [
      {
        "offset": 1,
        "length": 1,
        "styling_info": [
          "string"
        ]
      }
    ]
  },
  "topic_tag": "string",
  "location_id": "string",
  "poll": {
    "options": [
      {
        "key": "string",
        "label": "string",
        "votes_percentage": 1.5
      }
    ],
    "total_votes": 1,
    "expires_at": "2026-10-13T09:00:00.000Z"
  },
  "children": [
    "string"
  ],
  "allowlisted_country_codes": [
    "string"
  ],
  "ghost_post_status": "ACTIVE",
  "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
}
```

## Threads: Delete a Reposts item

`DELETE /accounts/{accountId}/threads/reposts/{itemId}`

Posts you reposted (REPOST_FACADE). Repost any post by id, or undo a repost. Requires scopes: threads_basic, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/posts/reposts.md Generic route: /v1/accounts/{accountId}/focus/reposts.

Access: `write` · MCP tool: `threads-reposts-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/reposts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Threads: List Locations

`GET /accounts/{accountId}/threads/locations`

Search places to tag on posts (500 searches / 24 h). Use the id as locationId when composing. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: /v1/accounts/{accountId}/focus/locations.

Access: `read` · MCP tool: `threads-locations-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string): Place name
- `latitude` (number)
- `longitude` (number)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "address": "string",
      "city": "string",
      "country": "US",
      "latitude": 1.5,
      "longitude": 1.5,
      "postal_code": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Get a Locations item

`GET /accounts/{accountId}/threads/locations/{itemId}`

Search places to tag on posts (500 searches / 24 h). Use the id as locationId when composing. Requires scopes: threads_location_tagging. Network docs: https://developers.facebook.com/documentation/threads/create-posts/location-tagging.md Generic route: /v1/accounts/{accountId}/focus/locations.

Access: `read` · MCP tool: `threads-locations-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "address": "string",
  "city": "string",
  "country": "US",
  "latitude": 1.5,
  "longitude": 1.5,
  "postal_code": "string"
}
```

## Threads: List Posts with replies

`GET /accounts/{accountId}/threads/commented-posts`

Your recent posts that have replies — the entry point to moderation. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/commented-posts.

Access: `read` · MCP tool: `threads-commented-posts-list` · Zernio: `GET /v1/inbox/comments`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/commented-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "permalink": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z",
      "media_type": "string",
      "thumbnail_url": "https://example.com",
      "has_replies": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: List Replies

`GET /accounts/{accountId}/threads/replies`

Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `read` · MCP tool: `threads-replies-list` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string; required): Threads post id
- `reverse` (boolean): Newest first
- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_avatar_url": "https://example.com",
      "author_verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "parent_id": "string",
      "root_id": "string",
      "root_owner_id": "string",
      "is_reply": true,
      "is_own": true,
      "hide_status": "NOT_HUSHED",
      "hidden": true,
      "reply_audience": "string",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "topic_tag": "string",
      "approval_status": "pending"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Create a Replies item

`POST /accounts/{accountId}/threads/replies`

Reply to a post or reply (reply_to_id). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `threads-replies-create` · Zernio: `POST /v1/inbox/comments/{postId}`, `POST /v1/inbox/comments/{postId}/{commentId}/hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `reply_to_id` (string; required)
- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reply_to_id": "string",
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 201:

```json
{
  "id": "string",
  "text": "string",
  "author": "string",
  "author_username": "string",
  "author_avatar_url": "https://example.com",
  "author_verified": true,
  "created_at": "2026-10-13T09:00:00.000Z",
  "like_count": 1,
  "permalink": "https://example.com",
  "media_type": "string",
  "media_url": "https://example.com",
  "thumbnail_url": "https://example.com",
  "gif_url": "https://example.com",
  "has_replies": true,
  "parent_id": "string",
  "root_id": "string",
  "root_owner_id": "string",
  "is_reply": true,
  "is_own": true,
  "hide_status": "NOT_HUSHED",
  "hidden": true,
  "reply_audience": "string",
  "is_quote_post": true,
  "quoted_post_id": "string",
  "topic_tag": "string",
  "approval_status": "pending"
}
```

## Threads: Delete a Replies item

`DELETE /accounts/{accountId}/threads/replies/{itemId}`

Delete one of your own replies. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_delete. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `threads-replies-delete` · Zernio: `DELETE /v1/inbox/comments/{postId}`, `DELETE /v1/inbox/comments/{postId}/{commentId}/hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Threads: Reply (Replies)

`POST /accounts/{accountId}/threads/replies/{itemId}/reply`

Reply. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `threads-replies-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Hide (Replies)

`POST /accounts/{accountId}/threads/replies/{itemId}/hide`

Hide a top-level reply (nested replies are hidden with it). Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `threads-replies-hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Unhide (Replies)

`POST /accounts/{accountId}/threads/replies/{itemId}/unhide`

Unhide. Top-level replies on a post. Reply, hide/unhide, or delete your own replies (others can only be hidden). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/replies.

Access: `write` · MCP tool: `threads-replies-unhide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Conversation

`GET /accounts/{accountId}/threads/conversation`

The full, flattened conversation of a post (top-level and nested replies). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.

Access: `read` · MCP tool: `threads-conversation-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string; required): Threads post id
- `reverse` (boolean): Newest first
- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/conversation?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_avatar_url": "https://example.com",
      "author_verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "parent_id": "string",
      "root_id": "string",
      "root_owner_id": "string",
      "is_reply": true,
      "is_own": true,
      "hide_status": "NOT_HUSHED",
      "hidden": true,
      "reply_audience": "string",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "topic_tag": "string",
      "approval_status": "pending"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Reply (Conversation)

`POST /accounts/{accountId}/threads/conversation/{itemId}/reply`

Reply. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.

Access: `write` · MCP tool: `threads-conversation-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/conversation/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Hide (Conversation)

`POST /accounts/{accountId}/threads/conversation/{itemId}/hide`

Hide a top-level reply (nested replies are hidden with it). The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.

Access: `write` · MCP tool: `threads-conversation-hide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/conversation/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Unhide (Conversation)

`POST /accounts/{accountId}/threads/conversation/{itemId}/unhide`

Unhide. The full, flattened conversation of a post (top-level and nested replies). Requires scopes: threads_read_replies, threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/retrieve-and-manage-replies/replies-and-conversations.md Generic route: /v1/accounts/{accountId}/focus/conversation.

Access: `write` · MCP tool: `threads-conversation-unhide`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/conversation/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Reply approvals

`GET /accounts/{accountId}/threads/pending-replies`

Replies held for approval on posts published with reply approvals. Approve or ignore them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.

Access: `read` · MCP tool: `threads-pending-replies-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `post_id` (string; required)
- `approval_status` (string; one of pending, ignored)
- `reverse` (boolean)
- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/pending-replies?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_avatar_url": "https://example.com",
      "author_verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "parent_id": "string",
      "root_id": "string",
      "root_owner_id": "string",
      "is_reply": true,
      "is_own": true,
      "hide_status": "NOT_HUSHED",
      "hidden": true,
      "reply_audience": "string",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "topic_tag": "string",
      "approval_status": "pending"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Approve (Reply approvals)

`POST /accounts/{accountId}/threads/pending-replies/{itemId}/approve`

Approve. Replies held for approval on posts published with reply approvals. Approve or ignore them. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.

Access: `write` · MCP tool: `threads-pending-replies-approve`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/pending-replies/ITEM_ID/approve" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: Ignore (Reply approvals)

`POST /accounts/{accountId}/threads/pending-replies/{itemId}/ignore`

Ignore. Replies held for approval on posts published with reply approvals. Approve or ignore them. Destructive. Requires scopes: threads_manage_replies. Network docs: https://developers.facebook.com/documentation/threads/reply-management.md Generic route: /v1/accounts/{accountId}/focus/pending-replies.

Access: `write` · MCP tool: `threads-pending-replies-ignore`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/pending-replies/ITEM_ID/ignore" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Mentions

`GET /accounts/{accountId}/threads/mentions`

Public posts that @mention you, including quote posts. Reply from here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `read` · MCP tool: `threads-mentions-list` · Zernio: `GET /v1/inbox/mentions`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "mention",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "post_id": "string",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "alt_text": "string",
      "has_replies": true,
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Reply (Mentions)

`POST /accounts/{accountId}/threads/mentions/{itemId}/reply`

Reply. Public posts that @mention you, including quote posts. Reply from here. Requires scopes: threads_manage_mentions. Network docs: https://developers.facebook.com/documentation/threads/threads-mentions.md Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: `write` · MCP tool: `threads-mentions-reply` · Zernio: `POST /v1/inbox/mentions/reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Quotes

`GET /accounts/{accountId}/threads/quote-mentions`

Quote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_mentions. Generic route: /v1/accounts/{accountId}/focus/quote-mentions.

Access: `read` · MCP tool: `threads-quote-mentions-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/quote-mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "kind": "mention",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "post_id": "string",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "alt_text": "string",
      "has_replies": true,
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_reply": true,
      "parent_id": "string",
      "root_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Reply (Quotes)

`POST /accounts/{accountId}/threads/quote-mentions/{itemId}/reply`

Reply. Quote posts that mention you (from the mentions feed). Per-post quote and repost counts are under Insights › Engagement. Requires scopes: threads_manage_mentions. Generic route: /v1/accounts/{accountId}/focus/quote-mentions.

Access: `write` · MCP tool: `threads-quote-mentions-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/quote-mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List My replies

`GET /accounts/{accountId}/threads/my-replies`

Replies you published anywhere on Threads. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_read_replies. Generic route: /v1/accounts/{accountId}/focus/my-replies.

Access: `read` · MCP tool: `threads-my-replies-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/my-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "author": "string",
      "author_username": "string",
      "author_avatar_url": "https://example.com",
      "author_verified": true,
      "created_at": "2026-10-13T09:00:00.000Z",
      "like_count": 1,
      "permalink": "https://example.com",
      "media_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "parent_id": "string",
      "root_id": "string",
      "root_owner_id": "string",
      "is_reply": true,
      "is_own": true,
      "hide_status": "NOT_HUSHED",
      "hidden": true,
      "reply_audience": "string",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "topic_tag": "string",
      "approval_status": "pending"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Delete a My replies item

`DELETE /accounts/{accountId}/threads/my-replies/{itemId}`

Replies you published anywhere on Threads. Requires scopes: threads_read_replies, threads_delete. Generic route: /v1/accounts/{accountId}/focus/my-replies.

Access: `write` · MCP tool: `threads-my-replies-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/my-replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## Threads: List Listening

`GET /accounts/{accountId}/threads/keyword-search`

Search public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: /v1/accounts/{accountId}/focus/keyword-search.

Access: `read` · MCP tool: `threads-keyword-search-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `q` (string; required): Keyword, or topic tag when search_mode=TAG
- `search_type` (string; one of TOP, RECENT)
- `search_mode` (string; one of KEYWORD, TAG)
- `media_type` (string; one of TEXT, IMAGE, VIDEO)
- `author_username` (string): Exact username (without @)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)
- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/keyword-search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "media_type": "TEXT_POST",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "username": "string",
      "owner_id": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_repost": true,
      "reposted_post_id": "string",
      "alt_text": "string",
      "link_attachment_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "reply_audience": "everyone",
      "is_spoiler_media": true,
      "text_spoilers": [
        {
          "offset": 1,
          "length": 1
        }
      ],
      "text_attachment": {
        "plaintext": "string",
        "link_attachment_url": "https://example.com",
        "text_with_styling_info": [
          {
            "offset": null,
            "length": null,
            "styling_info": []
          }
        ]
      },
      "topic_tag": "string",
      "location_id": "string",
      "poll": {
        "options": [
          {
            "key": null,
            "label": null,
            "votes_percentage": null
          }
        ],
        "total_votes": 1,
        "expires_at": "2026-10-13T09:00:00.000Z"
      },
      "children": [
        "string"
      ],
      "allowlisted_country_codes": [
        "string"
      ],
      "ghost_post_status": "ACTIVE",
      "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Reply (Listening)

`POST /accounts/{accountId}/threads/keyword-search/{itemId}/reply`

Reply to a public post found by search (allowed with threads_keyword_search). Search public posts by keyword or topic tag (TOP or RECENT) and reply to them. 2200 queries / user / 24 h; without Advanced Access only your own posts are searched. Requires scopes: threads_keyword_search. Network docs: https://developers.facebook.com/documentation/threads/keyword-search.md Generic route: /v1/accounts/{accountId}/focus/keyword-search.

Access: `write` · MCP tool: `threads-keyword-search-reply`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `text` (string; required; ≤ 500 characters)
- `media` (array of object; ≤ 20 items)
  - `media[].url` (string (uri))
  - `media[].media_id` (string): Socialit media id (resolved to a public URL)
  - `media[].type` (string; one of image, video, gif)
  - `media[].altText` (string; ≤ 1000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/keyword-search/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      {
        "url": "https://example.com",
        "media_id": "string"
      }
    ]
  }'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## Threads: List Recent searches

`GET /accounts/{accountId}/threads/recent-searches`

Keywords you searched recently (shared with the Threads app). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_keyword_search. Generic route: /v1/accounts/{accountId}/focus/recent-searches.

Access: `read` · MCP tool: `threads-recent-searches-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/recent-searches" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "query": "string",
      "searched_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: List Benchmarks

`GET /accounts/{accountId}/threads/benchmarks`

Compare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/benchmarks.

Access: `read` · MCP tool: `threads-benchmarks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `usernames` (string; required): Comma-separated usernames

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/benchmarks?usernames=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "username": "string",
      "name": "string",
      "avatar_url": "https://example.com",
      "biography": "string",
      "is_verified": true,
      "follower_count": 1,
      "views_count_7d": 1,
      "likes_count_7d": 1,
      "replies_count_7d": 1,
      "reposts_count_7d": 1,
      "quotes_count_7d": 1,
      "profile_url": "https://example.com",
      "error": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Get a Benchmarks item

`GET /accounts/{accountId}/threads/benchmarks/{itemId}`

Compare public profiles (≥100 followers): followers and 7-day views, likes, replies, reposts, quotes. 1000 lookups / 24 h; Standard Access only allows @meta, @threads, @instagram, @facebook. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/benchmarks.

Access: `read` · MCP tool: `threads-benchmarks-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/benchmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "username": "string",
  "name": "string",
  "avatar_url": "https://example.com",
  "biography": "string",
  "is_verified": true,
  "follower_count": 1,
  "views_count_7d": 1,
  "likes_count_7d": 1,
  "replies_count_7d": 1,
  "reposts_count_7d": 1,
  "quotes_count_7d": 1,
  "profile_url": "https://example.com",
  "error": "string"
}
```

## Threads: List Profile posts

`GET /accounts/{accountId}/threads/profile-posts`

Public posts of another profile (competitor content). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_profile_discovery. Network docs: https://developers.facebook.com/documentation/threads/threads-profiles.md Generic route: /v1/accounts/{accountId}/focus/profile-posts.

Access: `read` · MCP tool: `threads-profile-posts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `username` (string; required)
- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)
- `limit` (integer; 1–100)
- `cursor` (string): Pagination cursor (next_cursor of the previous page)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/profile-posts?username=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "media_type": "TEXT_POST",
      "media_product_type": "string",
      "media_url": "https://example.com",
      "thumbnail_url": "https://example.com",
      "permalink": "https://example.com",
      "shortcode": "string",
      "username": "string",
      "owner_id": "string",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "is_quote_post": true,
      "quoted_post_id": "string",
      "is_repost": true,
      "reposted_post_id": "string",
      "alt_text": "string",
      "link_attachment_url": "https://example.com",
      "gif_url": "https://example.com",
      "has_replies": true,
      "reply_audience": "everyone",
      "is_spoiler_media": true,
      "text_spoilers": [
        {
          "offset": 1,
          "length": 1
        }
      ],
      "text_attachment": {
        "plaintext": "string",
        "link_attachment_url": "https://example.com",
        "text_with_styling_info": [
          {
            "offset": null,
            "length": null,
            "styling_info": []
          }
        ]
      },
      "topic_tag": "string",
      "location_id": "string",
      "poll": {
        "options": [
          {
            "key": null,
            "label": null,
            "votes_percentage": null
          }
        ],
        "total_votes": 1,
        "expires_at": "2026-10-13T09:00:00.000Z"
      },
      "children": [
        "string"
      ],
      "allowlisted_country_codes": [
        "string"
      ],
      "ghost_post_status": "ACTIVE",
      "ghost_post_expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Get Overview

`GET /accounts/{accountId}/threads/account-insights`

Profile views per day plus likes, replies, reposts, quotes and link clicks, with the current follower count. Data from 2024-06-01. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/account-insights.

Access: `read` · MCP tool: `threads-account-insights-get` · Zernio: `GET /v1/accounts/follower-stats`, `GET /v1/analytics/daily-metrics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)
- `daily` (boolean): Per-day interactions (one request per day; default for ≤31 days)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/account-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "views": 1.5,
        "profile_views": 1.5,
        "likes": 1.5,
        "comments": 1.5,
        "shares": 1.5,
        "quotes": 1.5
      }
    }
  ],
  "totals": {
    "views": 1.5,
    "profile_views": 1.5,
    "likes": 1.5,
    "comments": 1.5,
    "shares": 1.5,
    "quotes": 1.5,
    "clicks": 1.5,
    "followers": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5
  }
}
```

## Threads: List Post performance

`GET /accounts/{accountId}/threads/post-insights`

Lifetime views, likes, replies, reposts, quotes and shares of your recent posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/post-insights.

Access: `read` · MCP tool: `threads-post-insights-list` · Zernio: `GET /v1/analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)
- `limit` (integer; 1–100)
- `sort_by` (string; one of views, likes, replies, reposts, quotes, shares, engagements)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "permalink": "https://example.com",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "media_type": "string",
      "thumbnail_url": "https://example.com",
      "topic_tag": "string",
      "views": 1.5,
      "likes": 1.5,
      "replies": 1.5,
      "reposts": 1.5,
      "quotes": 1.5,
      "shares": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: List Quotes & reposts

`GET /accounts/{accountId}/threads/quotes-reposts`

How often each of your posts was quoted and reposted (Threads does not list who reposted). Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/quotes-reposts.

Access: `read` · MCP tool: `threads-quotes-reposts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)
- `limit` (integer; 1–100)
- `sort_by` (string; one of views, likes, replies, reposts, quotes, shares, engagements)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/quotes-reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "permalink": "https://example.com",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "media_type": "string",
      "thumbnail_url": "https://example.com",
      "topic_tag": "string",
      "views": 1.5,
      "likes": 1.5,
      "replies": 1.5,
      "reposts": 1.5,
      "quotes": 1.5,
      "shares": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Get Audience

`GET /accounts/{accountId}/threads/demographics`

Follower split by country, city, age and gender (needs ≥100 followers). Requires scopes: threads_manage_insights. Network docs: https://developers.facebook.com/documentation/threads/insights.md Generic route: /v1/accounts/{accountId}/focus/demographics.

Access: `read` · MCP tool: `threads-demographics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `breakdown` (string; one of country, city, age, gender): Only this breakdown (one request)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "countries": [
    {
      "key": "string",
      "value": 1.5
    }
  ],
  "cities": [
    {
      "key": "string",
      "value": 1.5
    }
  ],
  "ages": [
    {
      "key": "string",
      "value": 1.5
    }
  ],
  "genders": [
    {
      "key": "string",
      "value": 1.5
    }
  ],
  "age_gender": [
    {
      "age": "string",
      "gender": "string",
      "value": 1.5
    }
  ],
  "unavailable": [
    {
      "breakdown": "string",
      "error": "string"
    }
  ]
}
```

## Threads: List Link clicks

`GET /accounts/{accountId}/threads/link-clicks`

Clicks per link in your posts for the period. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_manage_insights. Generic route: /v1/accounts/{accountId}/focus/link-clicks.

Access: `read` · MCP tool: `threads-link-clicks-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date-time)): Start (ISO date/time or unix seconds)
- `until` (string (date-time)): End (ISO date/time or unix seconds)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/link-clicks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "link_url": "https://example.com",
      "clicks": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: List Poll results

`GET /accounts/{accountId}/threads/polls`

Your recent polls with vote percentages, total votes and expiry. Cursor pagination: pass next_cursor back as cursor. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: `read` · MCP tool: `threads-polls-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "text": "string",
      "permalink": "https://example.com",
      "timestamp": "2026-10-13T09:00:00.000Z",
      "options": [
        {
          "key": "string",
          "label": "string",
          "votes_percentage": 1.5
        }
      ],
      "total_votes": 1,
      "expires_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Threads: Get Publishing limits

`GET /accounts/{accountId}/threads/publishing-limit`

Rolling 24 h usage: 250 posts, 1000 replies, 100 deletes, 500 location searches. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/troubleshooting.md Generic route: /v1/accounts/{accountId}/focus/publishing-limit.

Access: `read` · MCP tool: `threads-publishing-limit-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/publishing-limit" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "posts": {
    "used": 1,
    "total": 1,
    "remaining": 1,
    "window_seconds": 1
  },
  "replies": {
    "used": 1,
    "total": 1,
    "remaining": 1,
    "window_seconds": 1
  },
  "deletes": {
    "used": 1,
    "total": 1,
    "remaining": 1,
    "window_seconds": 1
  },
  "location_searches": {
    "used": 1,
    "total": 1,
    "remaining": 1,
    "window_seconds": 1
  }
}
```

## Threads: Get Profile

`GET /accounts/{accountId}/threads/profile`

Your Threads profile. Threads has no API to edit name, bio or picture; links are parsed from the bio. Requires scopes: threads_basic. Network docs: https://developers.facebook.com/documentation/threads/reference/user.md Generic route: /v1/accounts/{accountId}/focus/profile.

Access: `read` · MCP tool: `threads-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "name": "string",
  "biography": "string",
  "bio_links": [
    "string"
  ],
  "avatar_url": "https://example.com",
  "is_verified": true,
  "profile_url": "https://example.com",
  "is_eligible_for_geo_gating": true
}
```

## Threads: Get Publishing defaults

`GET /accounts/{accountId}/threads/publishing-defaults`

Defaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/publishing-defaults.

Access: `read` · MCP tool: `threads-publishing-defaults-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/publishing-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "replyControl": "everyone",
  "enableReplyApprovals": false,
  "topicTag": "string",
  "allowlistedCountryCodes": [
    "string"
  ],
  "crossShareToInstagram": false,
  "crossShareToInstagramDarkMode": false,
  "autoPublishText": false,
  "checkQuota": false
}
```

## Threads: Update Publishing defaults

`PATCH /accounts/{accountId}/threads/publishing-defaults`

Returns metadata to persist on the social account. Defaults applied to every Threads post from this account (per-post options win): cross-share to Instagram Story, who can reply, reply approvals, topic tag, country allowlist. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/publishing-defaults.

Access: `write` · MCP tool: `threads-publishing-defaults-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `replyControl` (string | null; one of everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only)
- `enableReplyApprovals` (boolean)
- `topicTag` (string | null; ≤ 50 characters)
- `allowlistedCountryCodes` (array of string | null)
- `crossShareToInstagram` (boolean): Also share new posts to the linked Instagram Story
- `crossShareToInstagramDarkMode` (boolean)
- `autoPublishText` (boolean)
- `checkQuota` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/publishing-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "replyControl": "everyone",
    "enableReplyApprovals": false,
    "topicTag": "string",
    "allowlistedCountryCodes": [
      "string"
    ],
    "crossShareToInstagram": false
  }'
```

Response 200:

```json
{
  "replyControl": "everyone",
  "enableReplyApprovals": false,
  "topicTag": "string",
  "allowlistedCountryCodes": [
    "string"
  ],
  "crossShareToInstagram": false,
  "crossShareToInstagramDarkMode": false,
  "autoPublishText": false,
  "checkQuota": false
}
```

## Threads: Get Connection

`GET /accounts/{accountId}/threads/connection`

Token validity, expiry and granted permissions vs. the full Threads permission set. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/connection.

Access: `read` · MCP tool: `threads-connection-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/connection" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "is_valid": true,
  "user_id": "string",
  "expires_at": "2026-10-13T09:00:00.000Z",
  "data_access_expires_at": "2026-10-13T09:00:00.000Z",
  "scopes": [
    "string"
  ],
  "missing_core": [
    "string"
  ],
  "missing_focus": [
    "string"
  ]
}
```

## Threads: Run permission checks (Connection)

`POST /accounts/{accountId}/threads/connection/permission-checks`

One API call per granted permission for Meta App Review (publishes and deletes a throwaway post). Token validity, expiry and granted permissions vs. the full Threads permission set. Destructive. Requires scopes: threads_basic. Generic route: /v1/accounts/{accountId}/focus/connection.

Access: `write` · MCP tool: `threads-connection-permission-checks`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/connection/permission-checks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

Response 200:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-threads/
