Skip to main content

Bookmark / Pin / Mute / Block: XCROP API Documentation

Bookmark / Pin / Mute / Block

Four more account actions, each with a POST to turn it on and a DELETE to turn it off. They need an API key with write permission, a paid plan and a connected X account, and each call consumes 100 flat credits like like and follow. Every response carries already: true when X reported the item was already in that state, so repeating a call is safe

ℹ
On the user routes the :username segment also takes a numeric id written as id:44196397. Pin only works on tweets that belong to the connected account
POST/v2/tweets/:tweetId/bookmarkBookmark a tweet
ParameterTypeRequiredDefaultDescription
tweetIdstringrequired—The numeric tweet ID (path parameter)
BASH
curl -X POST https://xcrop.io/api/v2/tweets/1893045621038174208/bookmark \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "success": true,
  "data": { "tweet_id": "1893045621038174208", "bookmarked": true, "already": false },
  "meta": { "latency_ms": 355 }
}
DELETE/v2/tweets/:tweetId/bookmarkRemove a bookmark (bookmarked: false)
POST/v2/tweets/:tweetId/pinPin one of your own tweets to your profile
ResponseJSON
{
  "success": true,
  "data": { "tweet_id": "1893045621038174208", "pinned": true, "already": false },
  "meta": { "latency_ms": 410 }
}
DELETE/v2/tweets/:tweetId/pinUnpin a tweet (pinned: false)
POST/v2/users/:username/muteMute a user
ParameterTypeRequiredDefaultDescription
usernamestringrequired—The username, or id:<digits> (path parameter)
BASH
curl -X POST https://xcrop.io/api/v2/users/VitalikButerin/mute \
  -H "Authorization: Bearer $XCROP_API_KEY"
ResponseJSON
{
  "success": true,
  "data": { "user_id": "295218901", "username": "VitalikButerin", "muted": true, "already": false },
  "meta": { "latency_ms": 498 }
}
DELETE/v2/users/:username/muteUnmute a user (muted: false)
POST/v2/users/:username/blockBlock a user
ResponseJSON
{
  "success": true,
  "data": { "user_id": "295218901", "username": "VitalikButerin", "blocked": true, "already": false },
  "meta": { "latency_ms": 512 }
}
DELETE/v2/users/:username/blockUnblock a user (blocked: false)