Skip to content

ENGAGEMENT

Twitter Engagement API: Like, Repost and Measure

Updated July 2026

A Twitter engagement API has two halves. The write half performs the interaction itself, so your code can like, repost, bookmark, follow or publish as a real X account. The read half returns the counters those interactions move on any public post. TwitterAPIs covers both on one Bearer key, with five write actions and their matching undo calls at $0.0008 each, after a free one-time session registration.

We bill each engagement action at $0.0008 (source: our published pricing), the same flat rate as a standard read.

Every engagement action, and the call that reverses it

Each interaction is one POST, and each one has a mirror that undoes it at the identical price. That symmetry matters more than it looks: it means a bad run is cheap to unwind, and a dry-run mode in your own code is trivially reversible.

ActionEndpointReverse it withPer callDocs
Like a postPOST /twitter/tweet/favoritePOST /twitter/tweet/unfavorite$0.0008View docs
Repost a postPOST /twitter/tweet/retweetPOST /twitter/tweet/unretweet$0.0008View docs
Bookmark a postPOST /twitter/tweet/bookmarkPOST /twitter/tweet/unbookmark$0.0008View docs
Follow an accountPOST /twitter/user/followPOST /twitter/user/unfollow$0.0008View docs
Publish a postPOST /twitter/tweet/createPOST /twitter/tweet/delete$0.0016View docs

Publishing is the single premium write at $0.0016. Everything else on this table, including the undo calls, bills at the standard $0.0008 read rate.

One free setup call before your first like

A read works on your Bearer token alone, because public data is not attributed to anybody. A write has to act as somebody. So you register an X session once with POST /twitter/customer/session, handing over auth_token and ct0 from the account you control. That call is free, the session is stored against your API key, and every later write is applied as that account with no further arguments. There is no OAuth consent screen and no app review anywhere in this path.

Register once, then like a post

1# 1. Register your X session once. This call is free.
2curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
3 "https://api.twitterapis.com/twitter/customer/session" \
4 -d '{"auth_token":"YOUR_AUTH_TOKEN","ct0":"YOUR_CT0"}'
5
6# 2. Like a post. $0.0008.
7curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
8 "https://api.twitterapis.com/twitter/tweet/favorite?id=1234567890"

Both id and url are accepted on the like and repost calls, so you can pass a raw post link straight through without parsing an ID out of it first.

Reading engagement without touching the post

Reporting work never needs a session. These four calls run on your Bearer token alone, modify nothing, and attribute nothing to you.

SignalEndpointDocs
Like, repost, reply and quote counts on one postGET /twitter/tweet/detailView docs
The accounts that reposted a given postGET /twitter/tweet/retweetersView docs
Everything a specific account has likedGET /twitter/user/likesView docs
The reply thread under a postGET /twitter/tweet/repliesView docs

One gap worth naming plainly: X does not expose the list of accounts that liked a post to third parties, so neither do we. The reverse lookup is available instead, reading what a given account has liked.

A write costs the same as a read

$0.0008

per like, repost, bookmark, follow, or undo

$0.0016

to publish a post, the one premium write

$0

to register your session, and no monthly fee

A thousand likes is about $0.80. An idle script costs nothing, because nothing bills until a call is made. Compare the whole endpoint table on the Twitter API pricing page, or size a monthly budget with the Twitter API cost calculator.

Related surfaces on the same key

To aggregate the counters rather than move them, the Twitter analytics API covers reporting over a whole account or keyword. Following and unfollowing sit next to the rest of the graph on the Twitter followers API. For the request shape, auth header and error handling behind all of these, read the Twitter REST API overview, and to drive engagement from an AI agent, connect the MCP server.

By the numbers

Engagement access, in numbers.

Sourced figures behind write-action pricing.

  • The official X API prices pay-per-use writes at $0.050 per post created, well above the third-party rate for the same action. (X Developer Platform, 2026)

  • Official X API write endpoints are capped per 15-minute and per 24-hour window, with limits that vary by access tier. (X API docs, 2026)

  • TwitterAPIs bills likes, reposts, bookmarks, follows and every undo call at a flat $0.0008, the same rate as a standard read. (TwitterAPIs pricing, 2026)

  • Session registration is a single free call that stores auth_token and ct0 against your API key and applies to every later write. (TwitterAPIs docs, 2026)

  • A new account starts with $0.50 in free credit and no card on file, which covers roughly 600 engagement actions. (TwitterAPIs pricing, 2026)

Engagement API, common questions

A Twitter engagement API is a REST interface with two halves. The write half performs the interactions themselves, so your code can like, repost, bookmark, follow or publish as a real X account. The read half returns the counters those interactions move, so you can measure like, repost, reply and quote totals on any public post. TwitterAPIs covers both on a single Bearer key: five write actions with matching undo calls at $0.0008 each, and four read endpoints at the same standard rate, with no X developer account and no monthly plan.

Yes, and this is the one setup step people miss. A read works on your Bearer token alone, because public data is not attributed to anybody. A write has to act as somebody, so it needs an X session. You supply auth_token and ct0 once through POST /twitter/customer/session, which costs nothing, and the session is stored against your key and applied to every subsequent like, repost, bookmark, follow and post. There is no OAuth consent screen and no app review in the path.

Yes, and it needs no session at all. GET /twitter/tweet/detail takes a post id or url on your Bearer token and returns the like, repost, reply, quote, bookmark and view counters on that post. Nothing is attributed to you and nothing is modified. That call is the right one for dashboards, leaderboards and reporting, where you want the number without touching the post.

Automation that a real person has authorised on their own account is ordinary API use; bulk unsolicited interaction is what platform policy targets, and X enforces against it regardless of which tool produced it. Two practical consequences. Register only sessions for accounts you actually control, and pace your write volume to look like a person rather than a loop. Our per-call billing means throttling costs you nothing, so there is no commercial reason to run hot.

Send POST /twitter/tweet/favorite with either the post id or its url as a query parameter, carrying your Bearer token. Because a like has to be attributed to a real account, you register your X session once beforehand with POST /twitter/customer/session, supplying auth_token and ct0. That registration call is free and is stored against your API key, so every later write is applied as your account automatically. Undoing is the mirror call, POST /twitter/tweet/unfavorite, at the same $0.0008.

Likes, reposts, bookmarks, follows and every matching undo bill at a flat $0.0008 per call, the same rate as a standard read, so a write costs you no more than a read. Publishing a post is the one premium write at $0.0016. Registering your session is free. There is no monthly minimum and no seat licence, which means a thousand likes costs about $0.80 and a script that idles costs nothing at all.

Reposts, yes. GET /twitter/tweet/retweeters pages through the accounts that reposted a given post, each with its profile fields, so you can profile who amplifies a topic. The list of accounts that liked a post is not exposed by X to third parties in the same way, so we do not offer it. The nearest available angle is the reverse lookup: GET /twitter/user/likes returns what a specific account has liked, which answers audience questions from the account side rather than the post side.

Like and repost from your own code

$0.0008 per action, free session setup, $0.50 in signup credit. Five write actions, each with a matching undo.