Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits57 endpointsMCP toolset focus_threads

Posts

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: readZernio: GET /v1/accounts/{accountId}/posts

Try it with MCPAsk your agent to call threads-posts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/postsPOST /v1/posts/{postId}/unpublishPOST /v1/posts/sync-external

Try it with MCPAsk your agent to call threads-posts-create (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

Text, image, video or carousel (2–20) post with any Threads option.

contentstring

Post text (≤500; emoji count by UTF-8 bytes)

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

replyControlstring

Who can reply. Alias: reply_control.

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsboolean

Hold replies for approval (pending replies). Not with ghost posts.

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

ghostPostboolean

Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.

quotePostIdstring

Quote this Threads post id (also post.quoteExternalId).

replyToIdstring

Publish as a reply to this post id (also post.replyToExternalId).

allowlistedCountryCodesarray of string

Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).

locationIdstring

Location tag id from location search (threads_location_tagging).

crossShareToInstagramboolean

Also share to the linked Instagram account as a Story (threads_share_to_instagram).

crossShareToInstagramDarkModeboolean

Dark-mode Instagram Story.

autoPublishTextboolean

Publish TEXT posts in one call (auto_publish_text).

threadarray of object

Follow-up posts chained after the root (each replies to the previous one).

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

threadItemsarray of object

Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

firstCommentstring

Self-reply posted under the root post (counts toward 250/24 h).

≤ 500 characters

altTextstring

Fallback alt text for single-media posts.

≤ 1000 characters

checkQuotaboolean

Check threads_publishing_limit before publishing (fails fast at 250/24 h).

Returns object

idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts
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

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

Try it with MCPAsk your agent to call threads-posts-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/posts/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-posts-delete (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/threads/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-quote (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

Text, image, video or carousel (2–20) post with any Threads option.

contentstring

Post text (≤500; emoji count by UTF-8 bytes)

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

replyControlstring

Who can reply. Alias: reply_control.

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsboolean

Hold replies for approval (pending replies). Not with ghost posts.

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

ghostPostboolean

Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.

quotePostIdstring

Quote this Threads post id (also post.quoteExternalId).

replyToIdstring

Publish as a reply to this post id (also post.replyToExternalId).

allowlistedCountryCodesarray of string

Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).

locationIdstring

Location tag id from location search (threads_location_tagging).

crossShareToInstagramboolean

Also share to the linked Instagram account as a Story (threads_share_to_instagram).

crossShareToInstagramDarkModeboolean

Dark-mode Instagram Story.

autoPublishTextboolean

Publish TEXT posts in one call (auto_publish_text).

threadarray of object

Follow-up posts chained after the root (each replies to the previous one).

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

threadItemsarray of object

Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

firstCommentstring

Self-reply posted under the root post (counts toward 250/24 h).

≤ 500 characters

altTextstring

Fallback alt text for single-media posts.

≤ 1000 characters

checkQuotaboolean

Check threads_publishing_limit before publishing (fails fast at 250/24 h).

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/{itemId}/quote
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-repost (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/{itemId}/repost
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-insights (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/{itemId}/insights
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-validate (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

Text, image, video or carousel (2–20) post with any Threads option.

contentstring

Post text (≤500; emoji count by UTF-8 bytes)

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

replyControlstring

Who can reply. Alias: reply_control.

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsboolean

Hold replies for approval (pending replies). Not with ghost posts.

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

ghostPostboolean

Ghost post: TEXT only, auto-archived after 24 h, not a reply, text spoilers only.

quotePostIdstring

Quote this Threads post id (also post.quoteExternalId).

replyToIdstring

Publish as a reply to this post id (also post.replyToExternalId).

allowlistedCountryCodesarray of string

Geo-gating: only profiles in these ISO 3166-1 alpha-2 countries see the post (eligible profiles only).

locationIdstring

Location tag id from location search (threads_location_tagging).

crossShareToInstagramboolean

Also share to the linked Instagram account as a Story (threads_share_to_instagram).

crossShareToInstagramDarkModeboolean

Dark-mode Instagram Story.

autoPublishTextboolean

Publish TEXT posts in one call (auto_publish_text).

threadarray of object

Follow-up posts chained after the root (each replies to the previous one).

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

threadItemsarray of object

Zernio semantics: the full thread, [0] is the root; when set, the post content/media are not published.

Show 10 item attributes
contentstring

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

mediaItemsarray of object

Zernio alias of media.

≤ 20 items

Show 4 item attributes
urlstring (uri)required
typestring

imagevideogif

mimeTypestring
altTextstring

≤ 1000 characters

linkAttachmentstring (uri)

Link preview card (TEXT posts only). Alias: link_attachment.

pollarray of string | object

Poll on a TEXT post: 2–4 options, 1–25 chars each. Array, { options: [...] } or { option_a … option_d }.

One of 2 shapes

Option 1 array of string

Option 2 object

optionsarray of string

2–4 items

option_astring
option_bstring
option_cstring
option_dstring
gifobject

GIF attachment (TEXT posts only). GIPHY only (Tenor sunset 2026-03-31).

Show 2 child attributes
gifIdstringrequired
providerstringdefault: "GIPHY"

GIPHY

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

spoilerMediaboolean

Blur the image/video/carousel as a spoiler (is_spoiler_media).

textAttachmentobject

Long-form text attachment (TEXT posts only, not with polls). ≤10,000 chars.

Show 3 child attributes
plaintextstringrequired

≤ 10000 characters

linkAttachmentUrlstring (uri)

Not allowed when linkAttachment is set.

stylingarray of object

Non-overlapping style ranges.

Show 3 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

stylesarray of stringrequired
topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

firstCommentstring

Self-reply posted under the root post (counts toward 250/24 h).

≤ 500 characters

altTextstring

Fallback alt text for single-media posts.

≤ 1000 characters

checkQuotaboolean

Check threads_publishing_limit before publishing (fails fast at 250/24 h).

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/validate
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-container-status (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

container_idstringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/container-status
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-posts-web-intent (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstring
urlstring (uri)
reply_controlstring
topic_tagstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/posts/web-intent
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

Ghost posts

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

Try it with MCPAsk your agent to call threads-ghost-posts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/ghost-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/ghost-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-ghost-posts-create (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

contentstringrequired

≤ 500 characters

textSpoilersarray of object

Text ranges hidden as spoilers (≤10). Maps to text_entities[{entity_type: SPOILER}].

≤ 10 items

Show 2 item attributes
offsetintegerrequired
lengthintegerrequired

≥ 1

replyControlstring

Who can reply. Alias: reply_control.

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

topicTagstring

One topic tag per post (no "." or "&"; a leading "#" is stripped). Alias: topic_tag.

1–50 characters · pattern ^[^.&]+$

Returns object

idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/ghost-posts
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

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

Try it with MCPAsk your agent to call threads-ghost-posts-delete (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/threads/ghost-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/ghost-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reposts

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

Try it with MCPAsk your agent to call threads-reposts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/reposts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-reposts-create (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

post_idstringrequired

Threads media id to repost

Returns object

idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/reposts
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

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

Try it with MCPAsk your agent to call threads-reposts-delete (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/threads/reposts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/reposts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Locations

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

Try it with MCPAsk your agent to call threads-locations-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstring

Place name

latitudenumber
longitudenumber

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
namestring
addressstring | null
citystring | null
countrystring | null
latitudenumber | null
longitudenumber | null
postal_codestring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/locations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/locations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-locations-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestring
addressstring | null
citystring | null
countrystring | null
latitudenumber | null
longitudenumber | null
postal_codestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/locations/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/locations/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Commented posts

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: readZernio: GET /v1/inbox/comments

Try it with MCPAsk your agent to call threads-commented-posts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
textstring | null
permalinkstring (uri) | null
created_atstring (date-time)
media_typestring | null
thumbnail_urlstring (uri) | null
has_repliesboolean
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/commented-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/commented-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Replies

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: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call threads-replies-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstringrequired

Threads post id

reversebooleandefault: true

Newest first

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstringread-only
textstring | null
authorstring | null
author_usernamestring | null
author_avatar_urlstring (uri) | null
author_verifiedboolean | null
created_atstring (date-time)
like_countinteger

Always 0: Threads exposes no reply like counts

permalinkstring (uri) | null
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
has_repliesboolean
parent_idstring | null
root_idstring | null
root_owner_idstring | null
is_replyboolean
is_ownboolean
hide_statusstring | null

NOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED

hiddenboolean
reply_audiencestring | null
is_quote_postboolean
quoted_post_idstring | null
topic_tagstring | null
approval_statusstring | null

pendingignoredapproved

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hide

Try it with MCPAsk your agent to call threads-replies-create (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

reply_to_idstringrequired
textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

idstringread-only
textstring | null
authorstring | null
author_usernamestring | null
author_avatar_urlstring (uri) | null
author_verifiedboolean | null
created_atstring (date-time)
like_countinteger

Always 0: Threads exposes no reply like counts

permalinkstring (uri) | null
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
has_repliesboolean
parent_idstring | null
root_idstring | null
root_owner_idstring | null
is_replyboolean
is_ownboolean
hide_statusstring | null

NOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED

hiddenboolean
reply_audiencestring | null
is_quote_postboolean
quoted_post_idstring | null
topic_tagstring | null
approval_statusstring | null

pendingignoredapproved

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/replies
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

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: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hide

Try it with MCPAsk your agent to call threads-replies-delete (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/threads/replies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-replies-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/replies/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-replies-hide (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/replies/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-replies-unhide (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/replies/{itemId}/unhide
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

Conversation

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

Try it with MCPAsk your agent to call threads-conversation-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstringrequired

Threads post id

reversebooleandefault: true

Newest first

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstringread-only
textstring | null
authorstring | null
author_usernamestring | null
author_avatar_urlstring (uri) | null
author_verifiedboolean | null
created_atstring (date-time)
like_countinteger

Always 0: Threads exposes no reply like counts

permalinkstring (uri) | null
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
has_repliesboolean
parent_idstring | null
root_idstring | null
root_owner_idstring | null
is_replyboolean
is_ownboolean
hide_statusstring | null

NOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED

hiddenboolean
reply_audiencestring | null
is_quote_postboolean
quoted_post_idstring | null
topic_tagstring | null
approval_statusstring | null

pendingignoredapproved

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/conversation
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/conversation?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-conversation-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/conversation/{itemId}/reply
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-conversation-hide (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/conversation/{itemId}/hide
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

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-conversation-unhide (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/conversation/{itemId}/unhide
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

Pending replies

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

Try it with MCPAsk your agent to call threads-pending-replies-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

post_idstringrequired
approval_statusstringdefault: "pending"

pendingignored

reversebooleandefault: true
limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstringread-only
textstring | null
authorstring | null
author_usernamestring | null
author_avatar_urlstring (uri) | null
author_verifiedboolean | null
created_atstring (date-time)
like_countinteger

Always 0: Threads exposes no reply like counts

permalinkstring (uri) | null
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
has_repliesboolean
parent_idstring | null
root_idstring | null
root_owner_idstring | null
is_replyboolean
is_ownboolean
hide_statusstring | null

NOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED

hiddenboolean
reply_audiencestring | null
is_quote_postboolean
quoted_post_idstring | null
topic_tagstring | null
approval_statusstring | null

pendingignoredapproved

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/pending-replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/pending-replies?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-pending-replies-approve (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/pending-replies/{itemId}/approve
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

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

Try it with MCPAsk your agent to call threads-pending-replies-ignore (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/pending-replies/{itemId}/ignore
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

Mentions

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: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call threads-mentions-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
kindstring

mentionreplyquote

textstring | null
authorstring | null
author_usernamestring | null
created_atstring (date-time)
like_countinteger
permalinkstring (uri) | null
post_idstring
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
alt_textstring | null
has_repliesboolean
is_quote_postboolean
quoted_post_idstring | null
is_replyboolean
parent_idstring | null
root_idstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call threads-mentions-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/mentions/{itemId}/reply
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

Quote mentions

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

Try it with MCPAsk your agent to call threads-quote-mentions-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
kindstring

mentionreplyquote

textstring | null
authorstring | null
author_usernamestring | null
created_atstring (date-time)
like_countinteger
permalinkstring (uri) | null
post_idstring
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
alt_textstring | null
has_repliesboolean
is_quote_postboolean
quoted_post_idstring | null
is_replyboolean
parent_idstring | null
root_idstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/quote-mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/quote-mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-quote-mentions-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/quote-mentions/{itemId}/reply
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

My replies

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

Try it with MCPAsk your agent to call threads-my-replies-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 26 item attributes
idstringread-only
textstring | null
authorstring | null
author_usernamestring | null
author_avatar_urlstring (uri) | null
author_verifiedboolean | null
created_atstring (date-time)
like_countinteger

Always 0: Threads exposes no reply like counts

permalinkstring (uri) | null
media_typestring | null
media_urlstring (uri) | null
thumbnail_urlstring (uri) | null
gif_urlstring (uri) | null
has_repliesboolean
parent_idstring | null
root_idstring | null
root_owner_idstring | null
is_replyboolean
is_ownboolean
hide_statusstring | null

NOT_HUSHEDUNHUSHEDHIDDENCOVEREDBLOCKEDRESTRICTED

hiddenboolean
reply_audiencestring | null
is_quote_postboolean
quoted_post_idstring | null
topic_tagstring | null
approval_statusstring | null

pendingignoredapproved

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/my-replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/my-replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-my-replies-delete (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/threads/my-replies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/my-replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-keyword-search-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired

Keyword, or topic tag when search_mode=TAG

search_typestringdefault: "TOP"

TOPRECENT

search_modestringdefault: "KEYWORD"

KEYWORDTAG

media_typestring

TEXTIMAGEVIDEO

author_usernamestring

Exact username (without @)

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/keyword-search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/keyword-search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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: writeIdempotency-Key

Try it with MCPAsk your agent to call threads-keyword-search-reply (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

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.

≤ 255 characters

Body object

textstringrequired

≤ 500 characters

mediaarray of object

≤ 20 items

Show 4 item attributes
urlstring (uri)
media_idstring

Socialit media id (resolved to a public URL)

typestring

imagevideogif

altTextstring

≤ 1000 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/keyword-search/{itemId}/reply
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

Recent searches

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

Try it with MCPAsk your agent to call threads-recent-searches-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
querystring
searched_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/recent-searches
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/recent-searches" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Benchmarks

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

Try it with MCPAsk your agent to call threads-benchmarks-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

usernamesstringrequired

Comma-separated usernames

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
usernamestring
namestring | null
avatar_urlstring (uri) | null
biographystring | null
is_verifiedboolean
follower_countinteger | null
views_count_7dinteger | null
likes_count_7dinteger | null
replies_count_7dinteger | null
reposts_count_7dinteger | null
quotes_count_7dinteger | null
profile_urlstring (uri) | null
errorstring | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/benchmarks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/benchmarks?usernames=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-benchmarks-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

usernamestring
namestring | null
avatar_urlstring (uri) | null
biographystring | null
is_verifiedboolean
follower_countinteger | null
views_count_7dinteger | null
likes_count_7dinteger | null
replies_count_7dinteger | null
reposts_count_7dinteger | null
quotes_count_7dinteger | null
profile_urlstring (uri) | null
errorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/benchmarks/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/benchmarks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Profile posts

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

Try it with MCPAsk your agent to call threads-profile-posts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

usernamestringrequired
sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

limitintegerdefault: 25

1–100

cursorstring

Pagination cursor (next_cursor of the previous page)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 30 item attributes
idstringread-only
textstring | null

≤ 500 characters

media_typestringread-only

TEXT_POSTIMAGEVIDEOCAROUSEL_ALBUMAUDIOREPOST_FACADE

media_product_typestring | nullread-only
media_urlstring (uri) | nullread-only
thumbnail_urlstring (uri) | nullread-only
permalinkstring (uri) | nullread-only
shortcodestring | nullread-only
usernamestring | nullread-only
owner_idstring | nullread-only
timestampstring (date-time)read-only
is_quote_postbooleanread-only
quoted_post_idstring | nullread-only
is_repostbooleanread-only
reposted_post_idstring | nullread-only
alt_textstring | null

≤ 1000 characters

link_attachment_urlstring (uri) | null
gif_urlstring (uri) | nullread-only
has_repliesbooleanread-only
reply_audiencestring | nullread-only

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

is_spoiler_mediaboolean
text_spoilersarray of object
Show 2 item attributes
offsetinteger
lengthinteger
text_attachmentobject | null
Show 3 child attributes
plaintextstring

≤ 10000 characters

link_attachment_urlstring (uri) | null
text_with_styling_infoarray of object
Show 3 item attributes
offsetinteger
lengthinteger
styling_infoarray of string
topic_tagstring | null

≤ 50 characters

location_idstring | null
pollobject | null
Show 3 child attributes
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
childrenarray of stringread-only
allowlisted_country_codesarray of string | null
ghost_post_statusstring | nullread-only

ACTIVEARCHIVED

ghost_post_expires_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/profile-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/profile-posts?username=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Account insights

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: readZernio: GET /v1/accounts/follower-statsGET /v1/analytics/daily-metrics

Try it with MCPAsk your agent to call threads-account-insights-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

dailyboolean

Per-day interactions (one request per day; default for ≤31 days)

Returns object

seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 10 child attributes
viewsnumber
profile_viewsnumber
likesnumber
commentsnumber

Replies

sharesnumber

Reposts (+ shares on posts)

quotesnumber
clicksnumber

Link clicks

followersnumber
engagementsnumber
engagement_ratenumber
totalsobject
Show 10 child attributes
viewsnumber
profile_viewsnumber
likesnumber
commentsnumber

Replies

sharesnumber

Reposts (+ shares on posts)

quotesnumber
clicksnumber

Link clicks

followersnumber
engagementsnumber
engagement_ratenumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/account-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/account-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post insights

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: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call threads-post-insights-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

limitintegerdefault: 25

1–100

sort_bystringdefault: "views"

viewslikesrepliesrepostsquotessharesengagements

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
textstring | null
permalinkstring (uri) | null
timestampstring (date-time)
media_typestring | null
thumbnail_urlstring (uri) | null
topic_tagstring | null
viewsnumber
likesnumber
repliesnumber
repostsnumber
quotesnumber
sharesnumber
engagementsnumber
engagement_ratenumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/post-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/post-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Quotes reposts

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

Try it with MCPAsk your agent to call threads-quotes-reposts-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

limitintegerdefault: 25

1–100

sort_bystringdefault: "quotes"

viewslikesrepliesrepostsquotessharesengagements

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
textstring | null
permalinkstring (uri) | null
timestampstring (date-time)
media_typestring | null
thumbnail_urlstring (uri) | null
topic_tagstring | null
viewsnumber
likesnumber
repliesnumber
repostsnumber
quotesnumber
sharesnumber
engagementsnumber
engagement_ratenumber | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/quotes-reposts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/quotes-reposts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Demographics

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

Try it with MCPAsk your agent to call threads-demographics-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

breakdownstring

Only this breakdown (one request)

countrycityagegender

Returns object

countriesarray of object
Show 2 item attributes
keystring
valuenumber
citiesarray of object
Show 2 item attributes
keystring
valuenumber
agesarray of object
Show 2 item attributes
keystring
valuenumber
gendersarray of object
Show 2 item attributes
keystring
valuenumber
age_genderarray of object
Show 3 item attributes
agestring
genderstring | null
valuenumber
unavailablearray of object
Show 2 item attributes
breakdownstring
errorstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/demographics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/demographics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
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

Try it with MCPAsk your agent to call threads-link-clicks-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

sincestring (date-time)

Start (ISO date/time or unix seconds)

untilstring (date-time)

End (ISO date/time or unix seconds)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
link_urlstring (uri)
clicksinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/link-clicks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/link-clicks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Polls

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

Try it with MCPAsk your agent to call threads-polls-list (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

limitintegerdefault: 50

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
textstring | null
permalinkstring (uri) | null
timestampstring (date-time)
optionsarray of object
Show 3 item attributes
keystring
labelstring
votes_percentagenumber | null
total_votesinteger | null
expires_atstring (date-time) | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/polls
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Publishing limit

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

Try it with MCPAsk your agent to call threads-publishing-limit-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

postsobject
Show 4 child attributes
usedinteger
totalinteger
remaininginteger
window_secondsinteger
repliesobject
Show 4 child attributes
usedinteger
totalinteger
remaininginteger
window_secondsinteger
deletesobject
Show 4 child attributes
usedinteger
totalinteger
remaininginteger
window_secondsinteger
location_searchesobject
Show 4 child attributes
usedinteger
totalinteger
remaininginteger
window_secondsinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/publishing-limit
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/publishing-limit" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Profile

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

Try it with MCPAsk your agent to call threads-profile-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
usernamestringread-only
namestring | nullread-only
biographystring | nullread-only
bio_linksarray of stringread-only
avatar_urlstring (uri) | nullread-only
is_verifiedbooleanread-only
profile_urlstring (uri) | nullread-only
is_eligible_for_geo_gatingboolean | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Publishing defaults

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

Try it with MCPAsk your agent to call threads-publishing-defaults-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

replyControlstring | null

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsbooleandefault: false
topicTagstring | null

≤ 50 characters

allowlistedCountryCodesarray of string | null
crossShareToInstagrambooleandefault: false

Also share new posts to the linked Instagram Story

crossShareToInstagramDarkModebooleandefault: false
autoPublishTextbooleandefault: false
checkQuotabooleandefault: false

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/publishing-defaults
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/publishing-defaults" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-publishing-defaults-update (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

replyControlstring | null

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsbooleandefault: false
topicTagstring | null

≤ 50 characters

allowlistedCountryCodesarray of string | null
crossShareToInstagrambooleandefault: false

Also share new posts to the linked Instagram Story

crossShareToInstagramDarkModebooleandefault: false
autoPublishTextbooleandefault: false
checkQuotabooleandefault: false

Returns object

replyControlstring | null

everyoneaccounts_you_followmentioned_onlyparent_post_author_onlyfollowers_only

enableReplyApprovalsbooleandefault: false
topicTagstring | null

≤ 50 characters

allowlistedCountryCodesarray of string | null
crossShareToInstagrambooleandefault: false

Also share new posts to the linked Instagram Story

crossShareToInstagramDarkModebooleandefault: false
autoPublishTextbooleandefault: false
checkQuotabooleandefault: false

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/threads/publishing-defaults
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

Connection

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

Try it with MCPAsk your agent to call threads-connection-get (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

is_validboolean | null
user_idstring | null
expires_atstring (date-time) | null
data_access_expires_atstring (date-time) | null
scopesarray of string
missing_corearray of string
missing_focusarray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/threads/connection
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/threads/connection" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

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

Try it with MCPAsk your agent to call threads-connection-permission-checks (toolset focus_threads)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/threads/connection/permission-checks
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