Skip to content

Like / retweet

POST/v1/x/actions/like
MCPx_like5 creditsComingNeeds a connected X account

Stage 6, not yet available. This arrives with connected X accounts and can't be called yet.

Updated

Description

Like or retweet a tweet from a connected X account. Needs accountId, tweetId (or tweet URL), action like or retweet, and an idempotencyKey. Costs 5 credits on success. Tip: liking a lead's recent tweet before a DM is a light, low-risk warm-up.

Parameters

accountId body, string, required
Id of an X account you connected in the dashboard.
tweetId body, string, required
Tweet id or tweet URL.
action body, enum
Like or retweet. One of: like, retweet. Default like.

Send an Idempotency-Key header with every write, so a retry never acts twice.

Request examples

curl -X POST "https://chatterapi.com/v1/x/actions/like" \
  -H "Authorization: Bearer $CHATTERAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "accountId": "8b0e6a52-1f7c-4a3e-9d2b-5c1e7f0a9b11",
  "tweetId": "1845201837465319425",
  "action": "like"
}'

Response

data is one XWriteResult. Fields:

FieldTypeNullableDescription
okbooleannoAlways true on success.
actionenumnoWhat was done.
accountIdstringnoConnected account that acted.
targetIdstringyesTarget user or tweet id.
resultIdstringyesId of what was created, if any.
dryRunbooleannoTrue when nothing was sent.
response
{
  "data": {
    "ok": true,
    "action": "like",
    "accountId": "8b0e6a52-1f7c-4a3e-9d2b-5c1e7f0a9b11",
    "targetId": "1845201837465319425",
    "resultId": null,
    "dryRun": true
  },
  "credits": {
    "charged": 5,
    "remaining": 24997
  },
  "requestId": "req_01JA7Q3V8K2N4P5R6S7T8V",
  "cached": false
}

Recorded live response captured 2026-10-14T00:00:00.000Z, truncated to 3 items. Credits and request id are illustrative.

Credits

5 credits per call. Failed calls cost 0. Cached responses cost the same. Test keys cost 0.

Errors this tool can return

Try it

Not callable yet.

Related tools