Skip to main content
POST
/
twitter
/
like_twitter
Like a tweet
curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/like_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tweet_id": "1346889436626259968"
}
'
{
  "data": {
    "liked": true
  }
}
Like a tweet on behalf of the authenticated source user. Proxies the official X v2 POST /2/users/{id}/likes endpoint, routed through the AIsa gateway at https://api.aisa.one/apis/v1/twitter/like_twitter.

​
Prerequisites

  • An AIsa API key (Bearer token for every request).
  • A one-time OAuth authorization for the source user account. Link your X account by calling POST /apis/v1/twitter/auth_twitter — AIsa stores the session against your API key and uses it automatically on every write call.
  • The X session must hold like.write, tweet.read, users.read.

​
Response fields

FieldTypeMeaning
data.likedbooleantrue once the source user has liked the target tweet.

​
Idempotency

Liking a tweet the source user has already liked is a no-op. The endpoint still returns 200 with { "data": { "liked": true } }. Safe to retry.

​
Common 4xx causes

  • 400 invalid-request — missing or non-numeric tweet_id
  • 403 client-forbidden — OAuth session missing the like.write scope. Re-link via auth_twitter.
  • 404 resource-not-found — tweet doesn’t exist or isn’t visible to the source user (e.g., a protected account the source user doesn’t follow).
See Error Codes and Rate Limits for more.

Link an X Account

Start the OAuth flow this endpoint requires.

Post a Tweet

Create tweets you (or your agents) can like.

Follow a User

Another write endpoint using the same OAuth session.

Authorizations

​
Authorization
string
header
required

Your AIsa API key. The authenticated source user (the account doing the follow) is determined by the OAuth session attached to your key.

Body

application/json
​
tweet_id
string
required

Numeric ID of the tweet to like. Must match X's regex ^[0-9]{1,19}$.

Pattern: ^[0-9]{1,19}$
Example:

"1346889436626259968"

Response

Like succeeded (or was already in place).

​
data
object