Skip to content
Docs

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

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits177 endpointsMCP toolset focus_x

Bookmarks

X: List Bookmarks

GET/accounts/{accountId}/x/bookmarks

GET /2/users/:id/bookmarks (or a folder). Your bookmarks, optionally inside a folder: a curation library for reposts and inspiration. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmarks.

Access: read

Try it with MCPAsk your agent to call x-bookmarks-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

folder_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/bookmarks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Following

X: List Following

GET/accounts/{accountId}/x/following

GET /2/users/:id/following. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/following.

Access: read

Try it with MCPAsk your agent to call x-following-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–1000

user_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/following
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Follow (Following)

POST/accounts/{accountId}/x/following/{itemId}/follow

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-follow (toolset focus_x)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}/x/following/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unfollow (Following)

POST/accounts/{accountId}/x/following/{itemId}/unfollow

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-unfollow (toolset focus_x)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}/x/following/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Mute (Following)

POST/accounts/{accountId}/x/following/{itemId}/mute

Mute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-mute (toolset focus_x)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}/x/following/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unmute (Following)

POST/accounts/{accountId}/x/following/{itemId}/unmute

Unmute. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-unmute (toolset focus_x)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}/x/following/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block (Following)

POST/accounts/{accountId}/x/following/{itemId}/block

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: write

Try it with MCPAsk your agent to call x-following-block (toolset focus_x)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}/x/following/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock (Following)

POST/accounts/{accountId}/x/following/{itemId}/unblock

Enterprise-only on X. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-unblock (toolset focus_x)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}/x/following/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block DMs (Following)

POST/accounts/{accountId}/x/following/{itemId}/block-dms

Block DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-block-dms (toolset focus_x)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}/x/following/{itemId}/block-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/block-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock DMs (Following)

POST/accounts/{accountId}/x/following/{itemId}/unblock-dms

Unblock DMs. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-unblock-dms (toolset focus_x)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}/x/following/{itemId}/unblock-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/unblock-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Send DM (Following)

POST/accounts/{accountId}/x/following/{itemId}/send-dm

Send DM. Accounts you follow. Follow/unfollow are Enterprise-only on X since 2026-04-20. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/following.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-following-send-dm (toolset focus_x)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

≤ 10000 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}/x/following/{itemId}/send-dm
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/ITEM_ID/send-dm" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Posts

X: List Posts

GET/accounts/{accountId}/x/posts

Your timeline (GET /2/users/:id/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: readZernio: GET /v1/accounts/{accountId}/postsGET /v1/twitter/tweet

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

excludestring

repliesretweetsreplies,retweets

start_timestring (date-time)
end_timestring (date-time)
since_idstring
until_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Posts item

POST/accounts/{accountId}/x/posts

Publish a post (POST /2/tweets). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-KeyZernio: POST /v1/postsPOST /v1/posts/{postId}/editPOST /v1/posts/{postId}/unpublishPOST /v1/twitter/retweetPOST /v1/twitter/bookmarkPOST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call x-posts-create (toolset focus_x)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

textstringrequired
mediaarray of string | object

Up to 4 images, or 1 GIF, or 1 video

≤ 4 items

One of 2 shapes

Option 1 string

Option 2 object

mediastring
alt_textstring

≤ 1000 characters

reply_settingsstring

followingmentionedUserssubscribersverified

reply_to_post_idstring

Reply to this post (id or URL)

quote_post_idstring

Quote this post (Enterprise-only)

community_idstring
for_super_followers_onlyboolean
paid_partnershipboolean
made_with_aiboolean
sensitive_mediaobject
Show 3 child attributes
adult_contentboolean
graphic_violenceboolean
otherboolean
geo_countriesarray of string

≤ 25 items

place_idstring
tagged_user_idsarray of string

≤ 10 items

long_videoboolean
first_commentstring
auto_threadboolean

Split long text into a thread

Returns object

idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "reply_settings": "following",
    "reply_to_post_id": "string",
    "quote_post_id": "string"
  }'
Response · 201

X: Get a Posts item

GET/accounts/{accountId}/x/posts/{itemId}

Post lookup (GET /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: read

Try it with MCPAsk your agent to call x-posts-get (toolset focus_x)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

idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

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

X: Update a Posts item

PATCH/accounts/{accountId}/x/posts/{itemId}

Edit a post (X Premium; returns a new post id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: write

Try it with MCPAsk your agent to call x-posts-update (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

textstringrequired
mediaarray of string

≤ 4 items

Returns object

idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/x/posts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Delete a Posts item

DELETE/accounts/{accountId}/x/posts/{itemId}

Delete a post (DELETE /2/tweets/:id). Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeZernio: DELETE /v1/twitter/retweetDELETE /v1/twitter/bookmarkDELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call x-posts-delete (toolset focus_x)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}/x/posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Reply (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/reply

Reply. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-reply (toolset focus_x)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

≤ 25000 characters

mediaarray of string

≤ 4 items

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}/x/posts/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Repost (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/repost

Repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-repost (toolset focus_x)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}/x/posts/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Undo repost (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/undo-repost

Undo repost. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-undo-repost (toolset focus_x)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}/x/posts/{itemId}/undo-repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/undo-repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Like (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/like

Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-like (toolset focus_x)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}/x/posts/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unlike (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/unlike

Enterprise-only on X. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-unlike (toolset focus_x)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}/x/posts/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Bookmark (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/bookmark

Bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-bookmark (toolset focus_x)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

folder_idstring

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}/x/posts/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_id": "string"
  }'
Response · 200

X: Remove bookmark (Posts)

POST/accounts/{accountId}/x/posts/{itemId}/remove-bookmark

Remove bookmark. Your posts: publish, edit (X Premium, 30 min), delete, repost, bookmark and reply. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/create-post Generic route: /v1/accounts/{accountId}/focus/posts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-posts-remove-bookmark (toolset focus_x)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}/x/posts/{itemId}/remove-bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/posts/ITEM_ID/remove-bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Threads

X: Get a Threads item

GET/accounts/{accountId}/x/threads/{itemId}

Your posts in the conversation rooted at :id (recent search). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/threads.

Access: read

Try it with MCPAsk your agent to call x-threads-get (toolset focus_x)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
urlstring (uri)read-only
itemsarray of object
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only
thread_idsarray 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}/x/threads/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/threads/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Threads item

POST/accounts/{accountId}/x/threads

Publish a thread (chained POST /2/tweets). Publish multi-post threads and read back your own threads. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/threads.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call x-threads-create (toolset focus_x)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

itemsarray of objectrequired

≥ 1 items

Show 2 item attributes
textstringrequired
mediaarray of string

≤ 4 items

reply_settingsstring

followingmentionedUserssubscribersverified

first_commentstring

Returns object

idstringread-only
urlstring (uri)read-only
itemsarray of object
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only
thread_idsarray of string

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/threads
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/threads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "text": "string",
        "media": [
          "string"
        ]
      }
    ],
    "reply_settings": "following",
    "first_comment": "string"
  }'
Response · 201

Polls

X: List Polls

GET/accounts/{accountId}/x/polls

Your recent posts that carry a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: read

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringread-only
textstring
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/polls
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Polls item

POST/accounts/{accountId}/x/polls

Publish a poll. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call x-polls-create (toolset focus_x)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

textstringrequired
optionsarray of stringrequired

2–4 items

duration_minutesintegerrequireddefault: 1440

5–10080

reply_settingsstring

followingmentionedUserssubscribersverified

Returns object

idstringread-only
textstring
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/polls
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/polls" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "options": [
      "string"
    ],
    "duration_minutes": 1440,
    "reply_settings": "following"
  }'
Response · 201

X: Get a Polls item

GET/accounts/{accountId}/x/polls/{itemId}

Poll results for a post. Create polls (2-4 options, 5 min to 7 days) and follow their results. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/polls.

Access: read

Try it with MCPAsk your agent to call x-polls-get (toolset focus_x)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
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

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

Articles

X: Create a Articles item

POST/accounts/{accountId}/x/articles

Create an Article draft and optionally publish it. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.

Access: writeIdempotency-KeyZernio: POST /v1/posts

Try it with MCPAsk your agent to call x-articles-create (toolset focus_x)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

titlestringrequired

≥ 1 characters

textstring

Body; "# ", "## ", "> ", "- ", "1. " prefixes become headings, quotes and lists

content_stateobject

DraftJS content_state (snake_case); overrides text

Show 2 child attributes
blocksarray of object
entitiesarray of object
modestringdefault: "publish"

publishdraft

coverstring

Cover image (JPG, PNG or WebP)

cover_alt_textstring

≤ 1000 characters

Returns object

idstringread-only
article_idstringread-only
titlestring
modestring

publishdraft

urlstring (uri) | 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}/x/articles
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/articles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "text": "string",
    "content_state": {
      "blocks": [
        {}
      ],
      "entities": [
        {}
      ]
    },
    "mode": "publish",
    "cover": "string"
  }'
Response · 201

X: Publish draft (Articles)

POST/accounts/{accountId}/x/articles/{itemId}/publish

POST /2/articles/:id/publish. Long-form X Articles: save a draft on X or publish (the account must be eligible for Articles). Requires scopes: tweet.write. Network docs: https://docs.x.com/x-api/articles/introduction Generic route: /v1/accounts/{accountId}/focus/articles.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-articles-publish (toolset focus_x)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}/x/articles/{itemId}/publish
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/articles/ITEM_ID/publish" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Media

X: List Media

GET/accounts/{accountId}/x/media

Look up media by key (GET /2/media). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: read

Try it with MCPAsk your agent to call x-media-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

media_keysstringrequired

Comma-separated media keys

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
media_keystringread-only
media_idstring | nullread-only
typestringread-only
urlstring (uri) | nullread-only
preview_image_urlstring (uri) | nullread-only
widthinteger | null
heightinteger | null
duration_msinteger | null
alt_textstring | null

≤ 1000 characters

view_countinteger | 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}/x/media
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media?media_keys=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Media item

POST/accounts/{accountId}/x/media

Upload media (simple for images, chunked for GIF/video). Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-media-create (toolset focus_x)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

mediastringrequired
categorystringdefault: "tweet_image"

tweet_imagetweet_giftweet_videoamplify_videodm_imagedm_gifdm_video

alt_textstring

≤ 1000 characters

Returns object

media_keystringread-only
media_idstring | nullread-only
typestringread-only
urlstring (uri) | nullread-only
preview_image_urlstring (uri) | nullread-only
widthinteger | null
heightinteger | null
duration_msinteger | null
alt_textstring | null

≤ 1000 characters

view_countinteger | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/media
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media": "string",
    "category": "tweet_image",
    "alt_text": "string"
  }'
Response · 201

X: Get a Media item

GET/accounts/{accountId}/x/media/{itemId}

GET /2/media/:media_key. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: read

Try it with MCPAsk your agent to call x-media-get (toolset focus_x)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

media_keystringread-only
media_idstring | nullread-only
typestringread-only
urlstring (uri) | nullread-only
preview_image_urlstring (uri) | nullread-only
widthinteger | null
heightinteger | null
duration_msinteger | null
alt_textstring | null

≤ 1000 characters

view_countinteger | null

Responses

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

X: Alt text and flags (Media)

POST/accounts/{accountId}/x/media/{itemId}/set-metadata

Alt text and flags. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-media-set-metadata (toolset focus_x)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

alt_textstring

≤ 1000 characters

sensitive_mediaobject
Show 3 child attributes
adult_contentboolean
graphic_violenceboolean
otherboolean
geo_countriesarray of string
allow_downloadboolean

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}/x/media/{itemId}/set-metadata
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/set-metadata" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "alt_text": "string",
    "sensitive_media": {
      "adult_content": true,
      "graphic_violence": true
    },
    "geo_countries": [
      "string"
    ],
    "allow_download": true
  }'
Response · 200

X: Add subtitles (Media)

POST/accounts/{accountId}/x/media/{itemId}/add-subtitles

Add subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-media-add-subtitles (toolset focus_x)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

filestringrequired

SRT or VTT file

languagestringrequired

≥ 2 characters

display_namestring
amplifyboolean

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}/x/media/{itemId}/add-subtitles
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/add-subtitles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "string",
    "language": "en",
    "display_name": "string",
    "amplify": true
  }'
Response · 200

X: Delete subtitles (Media)

POST/accounts/{accountId}/x/media/{itemId}/delete-subtitles

Delete subtitles. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Destructive. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: write

Try it with MCPAsk your agent to call x-media-delete-subtitles (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

languagestringrequired

≥ 2 characters

amplifyboolean

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}/x/media/{itemId}/delete-subtitles
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/delete-subtitles" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "amplify": true
  }'
Response · 200

X: Processing status (Media)

POST/accounts/{accountId}/x/media/{itemId}/status

Processing status. Upload images, GIFs and video to X, set alt text and sensitive flags, manage subtitles. Requires scopes: tweet.read, media.write. Network docs: https://docs.x.com/x-api/media/introduction Generic route: /v1/accounts/{accountId}/focus/media.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-media-status (toolset focus_x)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}/x/media/{itemId}/status
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media/ITEM_ID/status" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Replies

X: List Replies

GET/accounts/{accountId}/x/replies

Replies to one post (post_id) or to all your recent posts. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: readZernio: GET /v1/inbox/commentsGET /v1/inbox/comments/{postId}

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

post_idstring

Root post id or URL

archiveboolean

Full-archive search (older than 7 days)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 32 item attributes
idstringread-only
textstring
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only
authorstringread-only
parent_idstring | nullread-only
hiddenboolean | 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}/x/replies
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Replies item

POST/accounts/{accountId}/x/replies

Reply to a post or reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}POST /v1/inbox/comments/{postId}/{commentId}/hidePOST /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call x-replies-create (toolset focus_x)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
mediaarray of string

≤ 4 items

Returns object

idstringread-only
textstring
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only
authorstringread-only
parent_idstring | nullread-only
hiddenboolean | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/replies
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "reply_to_id": "string",
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 201

X: Delete a Replies item

DELETE/accounts/{accountId}/x/replies/{itemId}

Delete one of your replies. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeZernio: DELETE /v1/inbox/comments/{postId}DELETE /v1/inbox/comments/{postId}/{commentId}/hideDELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call x-replies-delete (toolset focus_x)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}/x/replies/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Reply (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/reply

Reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-reply (toolset focus_x)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
mediaarray of string

≤ 4 items

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}/x/replies/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Like (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/like

Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-like (toolset focus_x)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}/x/replies/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unlike (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/unlike

Enterprise-only on X. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-unlike (toolset focus_x)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}/x/replies/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Repost (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/repost

Repost. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-repost (toolset focus_x)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}/x/replies/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Bookmark (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/bookmark

Bookmark. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-bookmark (toolset focus_x)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}/x/replies/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Hide reply (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/hide

Hide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-hide (toolset focus_x)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}/x/replies/{itemId}/hide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unhide reply (Replies)

POST/accounts/{accountId}/x/replies/{itemId}/unhide

Unhide reply. Replies to your posts (last 7 days): reply, hide/unhide, like, delete your own. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/replies.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-replies-unhide (toolset focus_x)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}/x/replies/{itemId}/unhide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/replies/ITEM_ID/unhide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Mentions

X: List Mentions

GET/accounts/{accountId}/x/mentions

GET /2/users/:id/mentions. Posts that mention you. Replying is allowed on self-serve because you were summoned. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: readZernio: GET /v1/inbox/mentions

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

since_idstring
start_timestring (date-time)
end_timestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 32 item attributes
idstringread-only
textstring
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only
authorstringread-only
parent_idstring | nullread-only
hiddenboolean | 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}/x/mentions
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Reply (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/reply

Reply. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call x-mentions-reply (toolset focus_x)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
mediaarray of string

≤ 4 items

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}/x/mentions/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Like (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/like

Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mentions-like (toolset focus_x)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}/x/mentions/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unlike (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/unlike

Enterprise-only on X. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mentions-unlike (toolset focus_x)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}/x/mentions/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Repost (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/repost

Repost. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mentions-repost (toolset focus_x)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}/x/mentions/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Bookmark (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/bookmark

Bookmark. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mentions-bookmark (toolset focus_x)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}/x/mentions/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Hide reply (Mentions)

POST/accounts/{accountId}/x/mentions/{itemId}/hide

Only for replies in your conversations. Posts that mention you. Replying is allowed on self-serve because you were summoned. Requires scopes: tweet.read, users.read, tweet.moderate.write. Generic route: /v1/accounts/{accountId}/focus/mentions.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mentions-hide (toolset focus_x)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}/x/mentions/{itemId}/hide
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mentions/ITEM_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Quotes

X: List Quotes

GET/accounts/{accountId}/x/quotes

GET /2/tweets/:id/quote_tweets. Quote posts of one of your posts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: read

Try it with MCPAsk your agent to call x-quotes-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

post_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/quotes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Reply (Quotes)

POST/accounts/{accountId}/x/quotes/{itemId}/reply

Reply. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-quotes-reply (toolset focus_x)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
mediaarray of string

≤ 4 items

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}/x/quotes/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Like (Quotes)

POST/accounts/{accountId}/x/quotes/{itemId}/like

Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-quotes-like (toolset focus_x)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}/x/quotes/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unlike (Quotes)

POST/accounts/{accountId}/x/quotes/{itemId}/unlike

Enterprise-only on X. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, like.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-quotes-unlike (toolset focus_x)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}/x/quotes/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Repost (Quotes)

POST/accounts/{accountId}/x/quotes/{itemId}/repost

Repost. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, tweet.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-quotes-repost (toolset focus_x)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}/x/quotes/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Bookmark (Quotes)

POST/accounts/{accountId}/x/quotes/{itemId}/bookmark

Bookmark. Quote posts of one of your posts. Requires scopes: tweet.read, users.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/quotes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-quotes-bookmark (toolset focus_x)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}/x/quotes/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/quotes/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Reposts of me

X: List Reposts of me

GET/accounts/{accountId}/x/reposts-of-me

GET /2/users/reposts_of_me. Your posts that other accounts reposted. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, timeline.read. Generic route: /v1/accounts/{accountId}/focus/reposts-of-me.

Access: read

Try it with MCPAsk your agent to call x-reposts-of-me-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/reposts-of-me
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/reposts-of-me" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Liking users

X: List Liked by

GET/accounts/{accountId}/x/liking-users

GET /2/tweets/:id/liking_users. Accounts that liked a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liking-users.

Access: read

Try it with MCPAsk your agent to call x-liking-users-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

post_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/liking-users
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liking-users?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reposted by

X: List Reposted by

GET/accounts/{accountId}/x/reposted-by

GET /2/tweets/:id/retweeted_by. Accounts that reposted a post. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/reposted-by.

Access: read

Try it with MCPAsk your agent to call x-reposted-by-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

post_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/reposted-by
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/reposted-by?post_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Liked posts

X: List Likes

GET/accounts/{accountId}/x/liked-posts

GET /2/users/:id/liked_tweets. Posts you liked. Liking and unliking are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read, like.read. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: read

Try it with MCPAsk your agent to call x-liked-posts-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/liked-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liked-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Likes item

POST/accounts/{accountId}/x/liked-posts

Like a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call x-liked-posts-create (toolset focus_x)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

Returns object

idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/liked-posts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liked-posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "post_id": "string"
  }'
Response · 201

X: Delete a Likes item

DELETE/accounts/{accountId}/x/liked-posts/{itemId}

Unlike a post (Enterprise-only). Posts you liked. Liking and unliking are Enterprise-only on X. Requires scopes: tweet.read, users.read, like.read, like.write. Generic route: /v1/accounts/{accountId}/focus/liked-posts.

Access: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call x-liked-posts-delete (toolset focus_x)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}/x/liked-posts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/liked-posts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bookmark folders

X: List Bookmark folders

GET/accounts/{accountId}/x/bookmark-folders

GET /2/users/:id/bookmarks/folders. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, bookmark.read. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.

Access: read

Try it with MCPAsk your agent to call x-bookmark-folders-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
idstringread-only
namestringrequired

1–25 characters

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}/x/bookmark-folders
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmark-folders" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Bookmark folders item

POST/accounts/{accountId}/x/bookmark-folders

POST /2/users/:id/bookmarks/folders. Requires scopes: users.read, bookmark.read, bookmark.write. Generic route: /v1/accounts/{accountId}/focus/bookmark-folders.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-bookmark-folders-create (toolset focus_x)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

namestringrequired

1–25 characters

Returns object

idstringread-only
namestringrequired

1–25 characters

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/bookmark-folders
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmark-folders" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 201

Home timeline

X: List Home timeline

GET/accounts/{accountId}/x/home-timeline

GET /2/users/:id/timelines/reverse_chronological. Posts from accounts you follow, newest first. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: read

Try it with MCPAsk your agent to call x-home-timeline-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

excludestring

repliesretweetsreplies,retweets

start_timestring (date-time)
end_timestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/home-timeline
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Reply (Home timeline)

POST/accounts/{accountId}/x/home-timeline/{itemId}/reply

Reply. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-home-timeline-reply (toolset focus_x)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
mediaarray of string

≤ 4 items

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}/x/home-timeline/{itemId}/reply
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ]
  }'
Response · 200

X: Like (Home timeline)

POST/accounts/{accountId}/x/home-timeline/{itemId}/like

Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-home-timeline-like (toolset focus_x)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}/x/home-timeline/{itemId}/like
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unlike (Home timeline)

POST/accounts/{accountId}/x/home-timeline/{itemId}/unlike

Enterprise-only on X. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, like.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-home-timeline-unlike (toolset focus_x)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}/x/home-timeline/{itemId}/unlike
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/unlike" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Repost (Home timeline)

POST/accounts/{accountId}/x/home-timeline/{itemId}/repost

Repost. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-home-timeline-repost (toolset focus_x)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}/x/home-timeline/{itemId}/repost
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/repost" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Bookmark (Home timeline)

POST/accounts/{accountId}/x/home-timeline/{itemId}/bookmark

Bookmark. Posts from accounts you follow, newest first. Requires scopes: tweet.read, users.read, bookmark.write. Network docs: https://docs.x.com/x-api/posts/timelines/introduction Generic route: /v1/accounts/{accountId}/focus/home-timeline.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-home-timeline-bookmark (toolset focus_x)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}/x/home-timeline/{itemId}/bookmark
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/home-timeline/ITEM_ID/bookmark" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Profile

X: Get Profile

GET/accounts/{accountId}/x/profile

GET /2/users/me. The connected account: handle, bio, verification and public counts. X has no profile-editing API. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/profile.

Access: read

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
usernamestringread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | nullread-only
confirmed_emailstring (email) | nullread-only

Needs users.email

subscription_typestring | nullread-only
verified_followers_countinteger | nullread-only
pinned_post_idstring | 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}/x/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Followers

X: List Followers

GET/accounts/{accountId}/x/followers

GET /2/users/:id/followers ($0.010 per user returned). Cursor pagination: pass next_cursor back as cursor. Requires scopes: follows.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: read

Try it with MCPAsk your agent to call x-followers-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–1000

user_idstring

Defaults to the connected account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Follow (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/follow

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-follow (toolset focus_x)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}/x/followers/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unfollow (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/unfollow

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-unfollow (toolset focus_x)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}/x/followers/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Mute (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/mute

Mute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-mute (toolset focus_x)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}/x/followers/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unmute (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/unmute

Unmute. Requires scopes: follows.read, users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-unmute (toolset focus_x)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}/x/followers/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/block

Enterprise-only on X. Destructive. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: write

Try it with MCPAsk your agent to call x-followers-block (toolset focus_x)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}/x/followers/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/unblock

Enterprise-only on X. Requires scopes: follows.read, users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-unblock (toolset focus_x)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}/x/followers/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block DMs (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/block-dms

Block DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-block-dms (toolset focus_x)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}/x/followers/{itemId}/block-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/block-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock DMs (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/unblock-dms

Unblock DMs. Requires scopes: follows.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-unblock-dms (toolset focus_x)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}/x/followers/{itemId}/unblock-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/unblock-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Send DM (Followers)

POST/accounts/{accountId}/x/followers/{itemId}/send-dm

Send DM. Requires scopes: follows.read, users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/followers.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followers-send-dm (toolset focus_x)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

≤ 10000 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}/x/followers/{itemId}/send-dm
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followers/ITEM_ID/send-dm" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Users

X: List People

GET/accounts/{accountId}/x/users

GET /2/users/search. Search and look up X accounts; follow, mute, block or DM them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: read

Try it with MCPAsk your agent to call x-users-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

qstringrequired

Name or handle

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/users
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a People item

GET/accounts/{accountId}/x/users/{itemId}

GET /2/users/:id or /2/users/by/username/:username. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: read

Try it with MCPAsk your agent to call x-users-get (toolset focus_x)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

idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/users/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Follow (People)

POST/accounts/{accountId}/x/users/{itemId}/follow

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-follow (toolset focus_x)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}/x/users/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unfollow (People)

POST/accounts/{accountId}/x/users/{itemId}/unfollow

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, follows.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-unfollow (toolset focus_x)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}/x/users/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Mute (People)

POST/accounts/{accountId}/x/users/{itemId}/mute

Mute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-mute (toolset focus_x)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}/x/users/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unmute (People)

POST/accounts/{accountId}/x/users/{itemId}/unmute

Unmute. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, mute.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-unmute (toolset focus_x)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}/x/users/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block (People)

POST/accounts/{accountId}/x/users/{itemId}/block

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Destructive. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: write

Try it with MCPAsk your agent to call x-users-block (toolset focus_x)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}/x/users/{itemId}/block
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/block" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock (People)

POST/accounts/{accountId}/x/users/{itemId}/unblock

Enterprise-only on X. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, block.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-unblock (toolset focus_x)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}/x/users/{itemId}/unblock
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/unblock" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Block DMs (People)

POST/accounts/{accountId}/x/users/{itemId}/block-dms

Block DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-block-dms (toolset focus_x)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}/x/users/{itemId}/block-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/block-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unblock DMs (People)

POST/accounts/{accountId}/x/users/{itemId}/unblock-dms

Unblock DMs. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-unblock-dms (toolset focus_x)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}/x/users/{itemId}/unblock-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/unblock-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Send DM (People)

POST/accounts/{accountId}/x/users/{itemId}/send-dm

Send DM. Search and look up X accounts; follow, mute, block or DM them. Requires scopes: users.read, tweet.read, dm.write, dm.read. Generic route: /v1/accounts/{accountId}/focus/users.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-users-send-dm (toolset focus_x)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

≤ 10000 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}/x/users/{itemId}/send-dm
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/users/ITEM_ID/send-dm" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string"
  }'
Response · 200

Affiliates

X: List Affiliates

GET/accounts/{accountId}/x/affiliates

GET /2/users/:id/affiliates. Accounts affiliated with a verified organization. Cursor pagination: pass next_cursor back as cursor. Requires scopes: users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/affiliates.

Access: read

Try it with MCPAsk your agent to call x-affiliates-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

user_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/affiliates
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/affiliates" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mutes

X: List Muted accounts

GET/accounts/{accountId}/x/mutes

GET /2/users/:id/muting. Cursor pagination: pass next_cursor back as cursor. Requires scopes: mute.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: read

Try it with MCPAsk your agent to call x-mutes-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–1000

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/mutes
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Muted accounts item

POST/accounts/{accountId}/x/mutes

Mute a user. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-mutes-create (toolset focus_x)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

user_idstring
usernamestring

Returns object

idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/mutes
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mutes" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
Response · 201

X: Delete a Muted accounts item

DELETE/accounts/{accountId}/x/mutes/{itemId}

Unmute. Requires scopes: mute.read, users.read, tweet.read, mute.write. Network docs: https://docs.x.com/x-api/users/mutes/introduction Generic route: /v1/accounts/{accountId}/focus/mutes.

Access: write

Try it with MCPAsk your agent to call x-mutes-delete (toolset focus_x)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}/x/mutes/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/mutes/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Blocks

X: List Blocked accounts

GET/accounts/{accountId}/x/blocks

GET /2/users/:id/blocking. Reading the block list is self-serve; block/unblock are Enterprise-only on X. Cursor pagination: pass next_cursor back as cursor. Requires scopes: block.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: read

Try it with MCPAsk your agent to call x-blocks-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–1000

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/blocks
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Blocked accounts item

POST/accounts/{accountId}/x/blocks

Block a user (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-blocks-create (toolset focus_x)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

user_idstring
usernamestring

Returns object

idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/blocks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/blocks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
Response · 201

X: Delete a Blocked accounts item

DELETE/accounts/{accountId}/x/blocks/{itemId}

Unblock (Enterprise-only). Reading the block list is self-serve; block/unblock are Enterprise-only on X. Requires scopes: block.read, users.read, tweet.read, block.write. Network docs: https://docs.x.com/x-api/users/blocks/introduction Generic route: /v1/accounts/{accountId}/focus/blocks.

Access: write

Try it with MCPAsk your agent to call x-blocks-delete (toolset focus_x)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}/x/blocks/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/blocks/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Lists

X: List My lists

GET/accounts/{accountId}/x/lists

GET /2/users/:id/owned_lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: read

Try it with MCPAsk your agent to call x-lists-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

user_idstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-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}/x/lists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a My lists item

POST/accounts/{accountId}/x/lists

POST /2/lists. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-create (toolset focus_x)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

namestringrequired

1–25 characters

descriptionstring

≤ 100 characters

privateboolean

Returns object

idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "private": true
  }'
Response · 201

X: Get a My lists item

GET/accounts/{accountId}/x/lists/{itemId}

GET /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: read

Try it with MCPAsk your agent to call x-lists-get (toolset focus_x)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

idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-only

Responses

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

X: Update a My lists item

PATCH/accounts/{accountId}/x/lists/{itemId}

PUT /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: write

Try it with MCPAsk your agent to call x-lists-update (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring

1–25 characters

descriptionstring

≤ 100 characters

privateboolean

Returns object

idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/x/lists/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "private": true
  }'
Response · 200

X: Delete a My lists item

DELETE/accounts/{accountId}/x/lists/{itemId}

DELETE /2/lists/:id. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: write

Try it with MCPAsk your agent to call x-lists-delete (toolset focus_x)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}/x/lists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Add member (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/add-member

Add member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-add-member (toolset focus_x)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

user_idstring
usernamestring

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}/x/lists/{itemId}/add-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/add-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string",
    "username": "string"
  }'
Response · 200

X: Remove member (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/remove-member

Remove member. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-remove-member (toolset focus_x)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

user_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}/x/lists/{itemId}/remove-member
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/remove-member" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
Response · 200

X: Follow list (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/follow

Follow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-follow (toolset focus_x)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}/x/lists/{itemId}/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unfollow list (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/unfollow

Unfollow list. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-unfollow (toolset focus_x)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}/x/lists/{itemId}/unfollow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/unfollow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Pin (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/pin

Pin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-pin (toolset focus_x)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}/x/lists/{itemId}/pin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unpin (My lists)

POST/accounts/{accountId}/x/lists/{itemId}/unpin

Unpin. Lists you own: create, edit, delete, add or remove members, follow and pin. Requires scopes: list.read, users.read, tweet.read, list.write. Network docs: https://docs.x.com/x-api/lists/introduction Generic route: /v1/accounts/{accountId}/focus/lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-lists-unpin (toolset focus_x)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}/x/lists/{itemId}/unpin
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/lists/ITEM_ID/unpin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

List members

X: List List members

GET/accounts/{accountId}/x/list-members

GET /2/lists/:id/members (item id = "<list_id>:<user_id>"). Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: read

Try it with MCPAsk your agent to call x-list-members-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

list_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
usernamestringread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | nullread-only
list_idstringread-only
user_idstringread-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}/x/list-members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-members?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a List members item

POST/accounts/{accountId}/x/list-members

POST /2/lists/:id/members. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-list-members-create (toolset focus_x)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

list_idstringrequired
user_idstring
usernamestring

Returns object

idstringread-only
usernamestringread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | nullread-only
list_idstringread-only
user_idstringread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/list-members
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-members" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string",
    "user_id": "string",
    "username": "string"
  }'
Response · 201

X: Delete a List members item

DELETE/accounts/{accountId}/x/list-members/{itemId}

DELETE /2/lists/:id/members/:user_id. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/list-members.

Access: write

Try it with MCPAsk your agent to call x-list-members-delete (toolset focus_x)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}/x/list-members/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List followers

X: List List followers

GET/accounts/{accountId}/x/list-followers

GET /2/lists/:id/followers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-followers.

Access: read

Try it with MCPAsk your agent to call x-list-followers-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

list_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/list-followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-followers?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List posts

X: List List timeline

GET/accounts/{accountId}/x/list-posts

GET /2/lists/:id/tweets. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-posts.

Access: read

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

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

list_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/list-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-posts?list_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Followed lists

X: List Followed lists

GET/accounts/{accountId}/x/followed-lists

GET /2/users/:id/followed_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: read

Try it with MCPAsk your agent to call x-followed-lists-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-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}/x/followed-lists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followed-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Followed lists item

POST/accounts/{accountId}/x/followed-lists

Follow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-followed-lists-create (toolset focus_x)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

list_idstringrequired

Returns object

idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/followed-lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followed-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string"
  }'
Response · 201

X: Delete a Followed lists item

DELETE/accounts/{accountId}/x/followed-lists/{itemId}

Unfollow a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/followed-lists.

Access: write

Try it with MCPAsk your agent to call x-followed-lists-delete (toolset focus_x)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}/x/followed-lists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/followed-lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinned lists

X: List Pinned lists

GET/accounts/{accountId}/x/pinned-lists

GET /2/users/:id/pinned_lists. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: read

Try it with MCPAsk your agent to call x-pinned-lists-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-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}/x/pinned-lists
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/pinned-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Pinned lists item

POST/accounts/{accountId}/x/pinned-lists

Pin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-pinned-lists-create (toolset focus_x)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

list_idstringrequired

Returns object

idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/pinned-lists
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/pinned-lists" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "list_id": "string"
  }'
Response · 201

X: Delete a Pinned lists item

DELETE/accounts/{accountId}/x/pinned-lists/{itemId}

Unpin a list. Requires scopes: list.read, users.read, tweet.read, list.write. Generic route: /v1/accounts/{accountId}/focus/pinned-lists.

Access: write

Try it with MCPAsk your agent to call x-pinned-lists-delete (toolset focus_x)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}/x/pinned-lists/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/pinned-lists/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List memberships

X: List Lists I am on

GET/accounts/{accountId}/x/list-memberships

GET /2/users/:id/list_memberships. Cursor pagination: pass next_cursor back as cursor. Requires scopes: list.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/list-memberships.

Access: read

Try it with MCPAsk your agent to call x-list-memberships-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringrequiredread-only
namestringrequired

1–25 characters

descriptionstring | null

≤ 100 characters

privatebooleandefault: false
member_countintegerread-only
follower_countintegerread-only
created_atstring (date-time)read-only
owner_idstringread-only
owner_usernamestring | nullread-only
urlstring (uri)read-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}/x/list-memberships
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/list-memberships" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Conversations

X: List Direct messages

GET/accounts/{accountId}/x/conversations

Conversations grouped from GET /2/dm_events. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: readZernio: GET /v1/inbox/conversationsGET /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call x-conversations-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
typestringread-only

one_to_onegroup

participantsarray of objectread-only
Show 4 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri)
last_messagestring | nullread-only
last_sender_idstring | nullread-only
updated_atstring (date-time)read-only
unread_countintegerread-only
message_countintegerread-only
messagesarray of objectread-only
Show 10 item attributes
idstringread-only
textstring
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | 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}/x/conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Direct messages item

POST/accounts/{accountId}/x/conversations

Start a 1:1 conversation (participant id or @username) or a group (participant_ids). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversationsPOST /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call x-conversations-create (toolset focus_x)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

participant_idstring
participant_usernamestring
participant_idsarray of string

Group conversation

2–49 items

textstring

≤ 10000 characters

mediastring
skip_dm_checkboolean

Returns object

idstringread-only
typestringread-only

one_to_onegroup

participantsarray of objectread-only
Show 4 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri)
last_messagestring | nullread-only
last_sender_idstring | nullread-only
updated_atstring (date-time)read-only
unread_countintegerread-only
message_countintegerread-only
messagesarray of objectread-only
Show 10 item attributes
idstringread-only
textstring
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/conversations
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "participant_id": "string",
    "participant_username": "string",
    "participant_ids": [
      "string"
    ],
    "text": "string",
    "media": "string"
  }'
Response · 201

X: Get a Direct messages item

GET/accounts/{accountId}/x/conversations/{itemId}

Messages in a conversation (GET /2/dm_conversations/:id/dm_events). DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}

Try it with MCPAsk your agent to call x-conversations-get (toolset focus_x)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
typestringread-only

one_to_onegroup

participantsarray of objectread-only
Show 4 item attributes
idstring
namestring
usernamestring
avatar_urlstring (uri)
last_messagestring | nullread-only
last_sender_idstring | nullread-only
updated_atstring (date-time)read-only
unread_countintegerread-only
message_countintegerread-only
messagesarray of objectread-only
Show 10 item attributes
idstringread-only
textstring
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | null

Responses

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

X: Send message (Direct messages)

POST/accounts/{accountId}/x/conversations/{itemId}/send

Send message. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-KeyZernio: DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}

Try it with MCPAsk your agent to call x-conversations-send (toolset focus_x)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

textstring

≤ 10000 characters

mediastring

One image, GIF or video

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}/x/conversations/{itemId}/send
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations/ITEM_ID/send" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": "string"
  }'
Response · 200

X: Block DMs from participant (Direct messages)

POST/accounts/{accountId}/x/conversations/{itemId}/block-dms

Block DMs from participant. DM conversations (legacy DM API). End-to-end encrypted X Chat threads are not readable here. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/direct-messages/introduction Generic route: /v1/accounts/{accountId}/focus/conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-conversations-block-dms (toolset focus_x)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

user_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}/x/conversations/{itemId}/block-dms
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/conversations/ITEM_ID/block-dms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
Response · 200

DM events

X: List DM events

GET/accounts/{accountId}/x/dm-events

GET /2/dm_events. Raw DM event log: messages, joins and leaves across conversations. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: read

Try it with MCPAsk your agent to call x-dm-events-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

event_typesarray of string

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
textstring
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | 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}/x/dm-events
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/dm-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a DM events item

POST/accounts/{accountId}/x/dm-events

Send a DM to a participant or conversation. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-dm-events-create (toolset focus_x)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

participant_idstring
conversation_idstring
textstring

≤ 10000 characters

mediastring

Returns object

idstringread-only
textstring
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/dm-events
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/dm-events" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "participant_id": "string",
    "conversation_id": "string",
    "text": "string",
    "media": "string"
  }'
Response · 201

X: Get a DM events item

GET/accounts/{accountId}/x/dm-events/{itemId}

GET /2/dm_events/:id. Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: read

Try it with MCPAsk your agent to call x-dm-events-get (toolset focus_x)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
directionstringread-only

inout

sent_atstring (date-time)read-only
from_idstringread-only
sender_usernamestring | nullread-only
sender_namestring | nullread-only
conversation_idstringread-only
event_typestringread-only

MessageCreateParticipantsJoinParticipantsLeave

attachmentsarray of objectread-only
Show 3 item attributes
typestring
media_keystring
urlstring (uri) | null

Responses

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

X: Delete a DM events item

DELETE/accounts/{accountId}/x/dm-events/{itemId}

DELETE /2/dm_events/:id (for you only). Raw DM event log: messages, joins and leaves across conversations. Requires scopes: dm.read, users.read, tweet.read, dm.write. Generic route: /v1/accounts/{accountId}/focus/dm-events.

Access: write

Try it with MCPAsk your agent to call x-dm-events-delete (toolset focus_x)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}/x/dm-events/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/dm-events/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Chat conversations

X: List X Chat

GET/accounts/{accountId}/x/chat-conversations

GET /2/chat/conversations (or message requests). Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Cursor pagination: pass next_cursor back as cursor. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: read

Try it with MCPAsk your agent to call x-chat-conversations-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

unread_onlyboolean
folderstringdefault: "inbox"

inboxrequests

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 11 item attributes
idstringread-only
typestring | null
group_namestring | null

Encrypted with the conversation key for groups

participantsarray of object
Show 3 item attributes
idstring
usernamestring
namestring
unreadboolean | null
is_archivedboolean
is_mutedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null
newest_event_idstring | null
message_ttl_msinteger | 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}/x/chat-conversations
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a X Chat item

GET/accounts/{accountId}/x/chat-conversations/{itemId}

GET /2/chat/conversations/:id. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: read

Try it with MCPAsk your agent to call x-chat-conversations-get (toolset focus_x)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
typestring | null
group_namestring | null

Encrypted with the conversation key for groups

participantsarray of object
Show 3 item attributes
idstring
usernamestring
namestring
unreadboolean | null
is_archivedboolean
is_mutedboolean
created_atstring (date-time) | null
updated_atstring (date-time) | null
newest_event_idstring | null
message_ttl_msinteger | null

Responses

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

X: Mark read (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/mark-read

Mark read. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-mark-read (toolset focus_x)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}/x/chat-conversations/{itemId}/mark-read
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/mark-read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Mark unread (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/mark-unread

Mark unread. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-mark-unread (toolset focus_x)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}/x/chat-conversations/{itemId}/mark-unread
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/mark-unread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Archive (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/archive

Archive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-archive (toolset focus_x)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}/x/chat-conversations/{itemId}/archive
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/archive" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unarchive (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/unarchive

Unarchive. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-unarchive (toolset focus_x)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}/x/chat-conversations/{itemId}/unarchive
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/unarchive" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Mute (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/mute

Mute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-mute (toolset focus_x)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}/x/chat-conversations/{itemId}/mute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/mute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Unmute (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/unmute

Unmute. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-unmute (toolset focus_x)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}/x/chat-conversations/{itemId}/unmute
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/unmute" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

X: Accept message request (X Chat)

POST/accounts/{accountId}/x/chat-conversations/{itemId}/accept

Accept message request. Encrypted X Chat conversations: metadata, read state, archive and mute. Message bodies are end-to-end encrypted and need the Chat XDK to decrypt. Requires scopes: dm.read, users.read, tweet.read, dm.write. Network docs: https://docs.x.com/x-api/chat/introduction Generic route: /v1/accounts/{accountId}/focus/chat-conversations.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-chat-conversations-accept (toolset focus_x)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}/x/chat-conversations/{itemId}/accept
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/chat-conversations/ITEM_ID/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Post counts

X: List Post volume

GET/accounts/{accountId}/x/post-counts

GET /2/tweets/counts/recent ($0.005 per request). How many posts match a query over the last 7 days (per minute, hour or day). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/post-counts.

Access: read

Try it with MCPAsk your agent to call x-post-counts-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
granularitystringdefault: "day"

minutehourday

start_timestring (date-time)
end_timestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
datestring (date-time)
endstring (date-time)
postsinteger
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}/x/post-counts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/post-counts?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
GET/accounts/{accountId}/x/trends

GET /2/users/personalized_trends | /2/trends/by/woeid/:woeid ($0.010 per request). Trends personalized for the account, or for a location (WOEID). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/trends.

Access: read

Try it with MCPAsk your agent to call x-trends-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

woeidinteger

Yahoo WOEID (1 = worldwide). Omit for personalized trends.

limitinteger

1–50

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
idstring
trend_namestring
post_countstring | null

As reported by X, e.g. "12.5K posts"

categorystring | null
trending_sincestring | null
search_urlstring (uri)
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}/x/trends
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/trends" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

News

X: List News

GET/accounts/{accountId}/x/news

GET /2/news/search. X News stories (Grok-summarized clusters of posts). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.

Access: read

Try it with MCPAsk your agent to call x-news-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
max_age_hoursintegerdefault: 168

1–720

limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstring
namestring
summarystring
hookstring | null
categorystring | null
keywordsarray of string
updated_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}/x/news
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/news?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a News item

GET/accounts/{accountId}/x/news/{itemId}

GET /2/news/:id. X News stories (Grok-summarized clusters of posts). Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/news.

Access: read

Try it with MCPAsk your agent to call x-news-get (toolset focus_x)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

idstring
namestring
summarystring
hookstring | null
categorystring | null
keywordsarray of string
updated_atstring (date-time) | null

Responses

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

Communities

X: List Communities

GET/accounts/{accountId}/x/communities

GET /2/communities/search. Find X Communities and post into them. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: read

Try it with MCPAsk your agent to call x-communities-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstringrequired
cursorstring
limitinteger

10–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
namestring
descriptionstring | null
accessstring | null
join_policystring | null
member_countinteger | null
created_atstring (date-time) | null
urlstring (uri)
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}/x/communities
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/communities?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a Communities item

GET/accounts/{accountId}/x/communities/{itemId}

GET /2/communities/:id. Find X Communities and post into them. Requires scopes: tweet.read, users.read, list.read. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: read

Try it with MCPAsk your agent to call x-communities-get (toolset focus_x)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
descriptionstring | null
accessstring | null
join_policystring | null
member_countinteger | null
created_atstring (date-time) | null
urlstring (uri)

Responses

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

X: Post to community (Communities)

POST/accounts/{accountId}/x/communities/{itemId}/post

Post to community. Find X Communities and post into them. Requires scopes: tweet.read, users.read, tweet.write. Network docs: https://docs.x.com/x-api/communities/lookup/introduction Generic route: /v1/accounts/{accountId}/focus/communities.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-communities-post (toolset focus_x)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
mediaarray of string

≤ 4 items

share_with_followersboolean

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}/x/communities/{itemId}/post
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/communities/ITEM_ID/post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media": [
      "string"
    ],
    "share_with_followers": true
  }'
Response · 200

Spaces

X: List Spaces

GET/accounts/{accountId}/x/spaces

GET /2/spaces/by/creator_ids (mine) | /2/spaces/search. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.

Access: read

Try it with MCPAsk your agent to call x-spaces-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

qstring

Search Spaces; omit for your own

statestringdefault: "all"

livescheduledall

creator_idsstring
limitinteger

1–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
titlestring
statestring

livescheduledended

langstring | null
is_ticketedboolean
participant_countinteger | null
subscriber_countinteger | null
scheduled_startstring (date-time) | null
started_atstring (date-time) | null
ended_atstring (date-time) | null
creator_idstring
creator_usernamestring | null
urlstring (uri)
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}/x/spaces
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/spaces" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a Spaces item

GET/accounts/{accountId}/x/spaces/{itemId}

GET /2/spaces/:id. Your live and scheduled Spaces, or search Spaces. Spaces cannot be created through the API. Requires scopes: space.read, users.read, tweet.read. Network docs: https://docs.x.com/x-api/spaces/introduction Generic route: /v1/accounts/{accountId}/focus/spaces.

Access: read

Try it with MCPAsk your agent to call x-spaces-get (toolset focus_x)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
titlestring
statestring

livescheduledended

langstring | null
is_ticketedboolean
participant_countinteger | null
subscriber_countinteger | null
scheduled_startstring (date-time) | null
started_atstring (date-time) | null
ended_atstring (date-time) | null
creator_idstring
creator_usernamestring | null
urlstring (uri)

Responses

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

Space posts

X: List Space posts

GET/accounts/{accountId}/x/space-posts

GET /2/spaces/:id/tweets. Posts shared in a Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-posts.

Access: read

Try it with MCPAsk your agent to call x-space-posts-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

space_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
idstringrequiredread-only
textstringrequired
created_atstring (date-time)read-only
urlstring (uri)read-only
kindstringread-only

postreplyquoterepost

author_idstringread-only
author_usernamestringread-only
author_namestringread-only
author_avatar_urlstring (uri)read-only
conversation_idstringread-only
in_reply_to_user_idstring | nullread-only
reply_to_idstring | nullread-only
quoted_idstring | nullread-only
reposted_idstring | nullread-only
langstringread-only
reply_settingsstring

everyonefollowingmentionedUserssubscribersverified

community_idstring | null
possibly_sensitivebooleanread-only
paid_partnershipboolean
editable_untilstring (date-time) | nullread-only
edits_remaininginteger | nullread-only
mediaarray of objectread-only
Show 9 item attributes
media_keystring
typestring

photovideoanimated_gif

urlstring (uri)
preview_image_urlstring (uri)
widthinteger
heightinteger
duration_msinteger
alt_textstring
view_countinteger
pollobject | null
Show 6 child attributes
idstring
optionsarray of object
Show 3 item attributes
positioninteger
labelstring
votesinteger
total_votesinteger
voting_statusstring

openclosed

end_datetimestring (date-time)
duration_minutesinteger
likesintegerread-only
repostsintegerread-only
repliesintegerread-only
quotesintegerread-only
bookmarksintegerread-only
impressionsintegerread-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}/x/space-posts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/space-posts?space_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Space buyers

X: List Ticket buyers

GET/accounts/{accountId}/x/space-buyers

GET /2/spaces/:id/buyers. Accounts that bought a ticket to your ticketed Space. Cursor pagination: pass next_cursor back as cursor. Requires scopes: space.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/space-buyers.

Access: read

Try it with MCPAsk your agent to call x-space-buyers-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

space_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/space-buyers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/space-buyers?space_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Broadcasts

X: List Broadcasts

GET/accounts/{accountId}/x/broadcasts

GET /2/broadcasts. Your X Live broadcasts: live, ended and replays with viewer counts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.

Access: read

Try it with MCPAsk your agent to call x-broadcasts-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

idsstring

Comma-separated broadcast ids

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 15 item attributes
idstringread-only
titlestring | null
statestring | null
share_urlstring (uri) | null
image_urlstring (uri) | null
post_idstring | null
chat_optioninteger | null
available_for_replayboolean | null
languagestring | null
started_atstring (date-time) | null
ended_atstring (date-time) | null
scheduled_startstring (date-time) | null
scheduled_endstring (date-time) | null
watchinginteger | null
watchedinteger | 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}/x/broadcasts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Get a Broadcasts item

GET/accounts/{accountId}/x/broadcasts/{itemId}

GET /2/broadcasts/:id. Your X Live broadcasts: live, ended and replays with viewer counts. Requires scopes: broadcast.read. Network docs: https://docs.x.com/x-api/broadcasts/introduction Generic route: /v1/accounts/{accountId}/focus/broadcasts.

Access: read

Try it with MCPAsk your agent to call x-broadcasts-get (toolset focus_x)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
titlestring | null
statestring | null
share_urlstring (uri) | null
image_urlstring (uri) | null
post_idstring | null
chat_optioninteger | null
available_for_replayboolean | null
languagestring | null
started_atstring (date-time) | null
ended_atstring (date-time) | null
scheduled_startstring (date-time) | null
scheduled_endstring (date-time) | null
watchinginteger | null
watchedinteger | null

Responses

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

Scheduled broadcasts

X: List Scheduled broadcasts

GET/accounts/{accountId}/x/scheduled-broadcasts

GET /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: read

Try it with MCPAsk your agent to call x-scheduled-broadcasts-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–100

oldest_start_timestring (date-time)
newest_start_timestring (date-time)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 14 item attributes
idstringread-only
broadcast_idstring | nullread-only
titlestring
descriptionstring | null
statestring | nullread-only
source_idstring

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)
scheduled_endstring (date-time) | null
chat_optionstring | null

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean | null
manual_publishboolean | null
localestring | null
recurring_schedule_idstring | nullread-only
thumbnail_media_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}/x/scheduled-broadcasts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Scheduled broadcasts item

POST/accounts/{accountId}/x/scheduled-broadcasts

POST /2/broadcasts/scheduled. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-scheduled-broadcasts-create (toolset focus_x)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

titlestring
descriptionstring
source_idstringrequired

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)required
scheduled_endstring (date-time)
chat_optionstring

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean
manual_publishboolean

Do not auto-publish at start; call go-live

is_lockedboolean
localestring
thumbnail_media_idstring
recurrenceobject
Show 2 child attributes
frequencystring

DailyWeekly

repeatsinteger

≥ 1

Returns object

idstringread-only
broadcast_idstring | nullread-only
titlestring
descriptionstring | null
statestring | nullread-only
source_idstring

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)
scheduled_endstring (date-time) | null
chat_optionstring | null

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean | null
manual_publishboolean | null
localestring | null
recurring_schedule_idstring | nullread-only
thumbnail_media_idstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/scheduled-broadcasts
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "source_id": "string",
    "scheduled_start": "2026-10-13T09:00:00.000Z",
    "scheduled_end": "2026-10-13T09:00:00.000Z"
  }'
Response · 201

X: Get a Scheduled broadcasts item

GET/accounts/{accountId}/x/scheduled-broadcasts/{itemId}

GET /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: read

Try it with MCPAsk your agent to call x-scheduled-broadcasts-get (toolset focus_x)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
broadcast_idstring | nullread-only
titlestring
descriptionstring | null
statestring | nullread-only
source_idstring

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)
scheduled_endstring (date-time) | null
chat_optionstring | null

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean | null
manual_publishboolean | null
localestring | null
recurring_schedule_idstring | nullread-only
thumbnail_media_idstring | null

Responses

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

X: Update a Scheduled broadcasts item

PATCH/accounts/{accountId}/x/scheduled-broadcasts/{itemId}

PUT /2/broadcasts/scheduled/:id (start and end are required by X; missing ones are read back first). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: write

Try it with MCPAsk your agent to call x-scheduled-broadcasts-update (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

titlestring
descriptionstring
source_idstring

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)
scheduled_endstring (date-time)
chat_optionstring

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean
manual_publishboolean

Do not auto-publish at start; call go-live

is_lockedboolean
localestring
thumbnail_media_idstring
recurrenceobject
Show 2 child attributes
frequencystring

DailyWeekly

repeatsinteger

≥ 1

roll_forwardboolean

Returns object

idstringread-only
broadcast_idstring | nullread-only
titlestring
descriptionstring | null
statestring | nullread-only
source_idstring

Ingest source id (RTMP stream key)

scheduled_startstring (date-time)
scheduled_endstring (date-time) | null
chat_optionstring | null

Who can chat: 0 default, 1 off, 2 everyone, 3 verified, 4 accounts the host follows, 5 subscribers, 6 followed-by-followed

0123456

available_for_replayboolean | null
manual_publishboolean | null
localestring | null
recurring_schedule_idstring | nullread-only
thumbnail_media_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/x/scheduled-broadcasts/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "source_id": "string",
    "scheduled_start": "2026-10-13T09:00:00.000Z",
    "scheduled_end": "2026-10-13T09:00:00.000Z"
  }'
Response · 200

X: Delete a Scheduled broadcasts item

DELETE/accounts/{accountId}/x/scheduled-broadcasts/{itemId}

DELETE /2/broadcasts/scheduled/:id. Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: write

Try it with MCPAsk your agent to call x-scheduled-broadcasts-delete (toolset focus_x)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}/x/scheduled-broadcasts/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Go live (Scheduled broadcasts)

POST/accounts/{accountId}/x/scheduled-broadcasts/{itemId}/go-live

POST /2/broadcasts/scheduled/:id/live (for manual_publish broadcasts). Schedule X Live broadcasts (one-off or recurring), edit them and go live. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/scheduled-broadcasts.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-scheduled-broadcasts-go-live (toolset focus_x)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}/x/scheduled-broadcasts/{itemId}/go-live
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/scheduled-broadcasts/ITEM_ID/go-live" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Broadcast chat

X: List Live chat

GET/accounts/{accountId}/x/broadcast-chat

GET /2/broadcasts/:id/chat (item id = "<broadcast_id>:<message_id>"). Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: read

Try it with MCPAsk your agent to call x-broadcast-chat-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (next_cursor)

limitinteger

1–200

broadcast_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
message_idstringread-only
broadcast_idstringread-only
textstring

≤ 140 characters

author_idstring | nullread-only
author_usernamestring | nullread-only
author_namestring | nullread-only
reply_tostring | null
created_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}/x/broadcast-chat
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat?broadcast_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Live chat item

POST/accounts/{accountId}/x/broadcast-chat

POST /2/broadcasts/:id/chat. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-broadcast-chat-create (toolset focus_x)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

broadcast_idstringrequired
textstringrequired

≤ 140 characters

reply_tostring

Returns object

idstringread-only
message_idstringread-only
broadcast_idstringread-only
textstring

≤ 140 characters

author_idstring | nullread-only
author_usernamestring | nullread-only
author_namestring | nullread-only
reply_tostring | null
created_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}/x/broadcast-chat
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "text": "string",
    "reply_to": "+15551234567"
  }'
Response · 201

X: Delete a Live chat item

DELETE/accounts/{accountId}/x/broadcast-chat/{itemId}

DELETE /2/broadcasts/:id/chat/:message_id. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: write

Try it with MCPAsk your agent to call x-broadcast-chat-delete (toolset focus_x)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}/x/broadcast-chat/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Mute author (Live chat)

POST/accounts/{accountId}/x/broadcast-chat/{itemId}/mute-author

Mute author. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-broadcast-chat-mute-author (toolset focus_x)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

minutesinteger

Omit to mute for the whole broadcast

≥ 1

remove_messagebooleandefault: true

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}/x/broadcast-chat/{itemId}/mute-author
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/ITEM_ID/mute-author" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "minutes": 1,
    "remove_message": true
  }'
Response · 200

X: Mute user (Live chat)

POST/accounts/{accountId}/x/broadcast-chat/mute-user

Mute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-broadcast-chat-mute-user (toolset focus_x)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

broadcast_idstringrequired
user_idstringrequired
minutesinteger

≥ 1

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}/x/broadcast-chat/mute-user
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/mute-user" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "user_id": "string",
    "minutes": 1
  }'
Response · 200

X: Unmute user (Live chat)

POST/accounts/{accountId}/x/broadcast-chat/unmute-user

Unmute user. Read and moderate a broadcast chat: send, remove messages, mute or time out viewers. Requires scopes: broadcast.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-chat.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-broadcast-chat-unmute-user (toolset focus_x)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

broadcast_idstringrequired
user_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}/x/broadcast-chat/unmute-user
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-chat/unmute-user" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcast_id": "string",
    "user_id": "string"
  }'
Response · 200

Broadcast moderators

X: List Chat moderators

GET/accounts/{accountId}/x/broadcast-moderators

GET /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Cursor pagination: pass next_cursor back as cursor. Requires scopes: broadcast.read, users.read, tweet.read. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: read

Try it with MCPAsk your agent to call x-broadcast-moderators-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 18 item attributes
idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/broadcast-moderators
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X: Create a Chat moderators item

POST/accounts/{accountId}/x/broadcast-moderators

POST /2/broadcasts/chat/moderators. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call x-broadcast-moderators-create (toolset focus_x)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

user_idstringrequired

Returns object

idstringrequiredread-only
usernamestringrequiredread-only
namestringread-only
urlstring (uri)read-only
avatar_urlstring (uri)read-only
descriptionstringread-only
locationstring | nullread-only
websitestring (uri) | nullread-only
created_atstring (date-time)read-only
protectedbooleanread-only
verifiedbooleanread-only
verified_typestring | nullread-only

bluebusinessgovernmentnone

followersintegerread-only
followingintegerread-only
postsintegerread-only
listedintegerread-only
likesinteger | nullread-only
media_countinteger | 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}/x/broadcast-moderators
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-moderators" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "string"
  }'
Response · 201

X: Delete a Chat moderators item

DELETE/accounts/{accountId}/x/broadcast-moderators/{itemId}

DELETE /2/broadcasts/chat/moderators/:user_id. Accounts allowed to moderate your live chats. Requires scopes: broadcast.read, users.read, tweet.read, broadcast.write. Generic route: /v1/accounts/{accountId}/focus/broadcast-moderators.

Access: write

Try it with MCPAsk your agent to call x-broadcast-moderators-delete (toolset focus_x)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}/x/broadcast-moderators/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/broadcast-moderators/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Account overview

X: Get Overview

GET/accounts/{accountId}/x/account-overview

GET /2/users/:id + GET /2/users/:id/tweets in the period. Followers and daily engagement aggregated from your posts in the period. Requires scopes: tweet.read, users.read. Generic route: /v1/accounts/{accountId}/focus/account-overview.

Access: readZernio: GET /v1/accounts/follower-stats

Try it with MCPAsk your agent to call x-account-overview-get (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

followersinteger
followinginteger
posts_countinteger
listed_countinteger
likes_countinteger
media_countinteger
totalsobject
Show 11 child attributes
impressionsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
savesinteger
clicksinteger
profile_viewsinteger
viewsinteger
engagementsinteger
engagement_ratenumber
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 11 child attributes
impressionsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
savesinteger
clicksinteger
profile_viewsinteger
viewsinteger
engagementsinteger
engagement_ratenumber
posts_analyzedinteger

Responses

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

Post metrics

X: List Post performance

GET/accounts/{accountId}/x/post-metrics

Recent posts (or ids) with public + non-public metrics. Per-post impressions, engagements, link and profile clicks (non-public metrics for posts under 30 days). Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/fundamentals/metrics Generic route: /v1/accounts/{accountId}/focus/post-metrics.

Access: readZernio: GET /v1/analytics

Try it with MCPAsk your agent to call x-post-metrics-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

idsstring

Comma-separated post ids; omit for your recent posts

limitinteger

5–100

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
idstring
textstring
created_atstring (date-time)
urlstring (uri)
metricsobject
Show 11 child attributes
impressionsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
savesinteger
clicksinteger
profile_viewsinteger
viewsinteger
engagementsinteger
engagement_ratenumber
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}/x/post-metrics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/post-metrics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Post analytics

X: List Post analytics (Enterprise)

GET/accounts/{accountId}/x/post-analytics

GET /2/tweets/analytics. Hourly/daily/weekly time series for up to 100 posts. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read, users.read. Network docs: https://docs.x.com/x-api/posts/get-post-analytics Generic route: /v1/accounts/{accountId}/focus/post-analytics.

Access: read

Try it with MCPAsk your agent to call x-post-analytics-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

idsstringrequired

Comma-separated post ids (≤100)

sincestring (date-time)
untilstring (date-time)
granularitystringdefault: "daily"

hourlydailyweeklytotal

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstring
metricsobject
Show 11 child attributes
impressionsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
savesinteger
clicksinteger
profile_viewsinteger
viewsinteger
engagementsinteger
engagement_ratenumber
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 11 child attributes
impressionsinteger
likesinteger
commentsinteger
sharesinteger
quotesinteger
savesinteger
clicksinteger
profile_viewsinteger
viewsinteger
engagementsinteger
engagement_ratenumber
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}/x/post-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/post-analytics?ids=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Media analytics

X: List Video analytics (Enterprise)

GET/accounts/{accountId}/x/media-analytics

GET /2/media/analytics. Video views, playback quartiles and watch time. Requires an X Enterprise contract. Cursor pagination: pass next_cursor back as cursor. Requires scopes: tweet.read. Generic route: /v1/accounts/{accountId}/focus/media-analytics.

Access: read

Try it with MCPAsk your agent to call x-media-analytics-list (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

media_keysstringrequired
sincestring (date-time)
untilstring (date-time)
granularitystringdefault: "daily"

hourlydailytotal

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
media_keystring
video_viewsinteger
playback_startinteger
playback25integer
playback50integer
playback75integer
playback_completeinteger
watch_time_msinteger
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}/x/media-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/media-analytics?media_keys=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Usage

X: Get API usage

GET/accounts/{accountId}/x/usage

GET /2/usage/credits + GET /2/usage/tweets (app bearer). X developer-account credit balance and daily post consumption against the monthly cap. Generic route: /v1/accounts/{accountId}/focus/usage.

Access: read

Try it with MCPAsk your agent to call x-usage-get (toolset focus_x)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

total_balancenumber | null
prepaid_balancenumber | null
free_balancenumber | null
project_capinteger | null
project_usageinteger | null
cap_reset_dayinteger | null
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 1 child attributes
postsinteger

Responses

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