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 accountPOST
/v2/tweets/:tweetId/bookmarkBookmark a tweet| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| tweetId | string | required | — | 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 profileResponseJSON
{ "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| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| username | string | required | — | 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 userResponseJSON
{ "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)