Follow User

Make the authenticated source user follow a target user on X/Twitter. Proxies the official X v2 follow-user endpoint through the AIsa gateway.

POST https://api.aisa.one/apis/v1/twitter/follow_twitter

Reference example

text

# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
  --url https://api.aisa.one/apis/v1/twitter/follow_twitter \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "target_user_id": "6253282"
}'

200

{
  "data": {
    "following": true,
    "pending_follow": false
  }
}

Follow a user on X/Twitter on behalf of the authenticated source user. This is a direct proxy for the official X v2 POST /2/users/{id}/following endpoint, routed through the AIsa gateway at https://api.aisa.one/apis/v1/twitter/follow_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 — that endpoint kicks off the OAuth flow and stores the resulting session against your AIsa key, so you do not pass OAuth tokens in the request body here.
• The X session must hold the following scopes: follows.write, tweet.read, users.read.

Looking to follow by @username instead of numeric ID? Resolve the user first with GET /twitter/user/info, then pass the returned id as target_user_id.

Response fields

Field	Type	Meaning
data.following	boolean	true once the source user follows the target. For public accounts this is the success signal.
data.pending_follow	boolean	true when the target is a protected account — the follow request has been sent and is awaiting the target user’s approval.

For the full set of error responses and retry guidance, see Error Codes. Write endpoints count toward your standard key RPM/TPM — see Rate Limits.

Request contract

• Method and path: POST /apis/v1/twitter/follow_twitter
• Availability: enabled
• Request URL template: https://api.aisa.one/apis/v1/twitter/follow_twitter
• Runtime facts: a3adc9187fd943329f04d77651501718ebfb69f2eb47355d287b171db1c09ebc

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "followTwitterUser",
  "method": "POST",
  "path": "/apis/v1/twitter/follow_twitter",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "follow_user": {
            "summary": "Follow @TwitterDev (id 2244994945)",
            "value": {
              "target_user_id": "2244994945"
            }
          }
        },
        "schema": {
          "properties": {
            "target_user_id": {
              "description": "Numeric ID of the X/Twitter user to follow. Must match the X regex `^[0-9]{1,19}$`.",
              "example": "6253282",
              "pattern": "^[0-9]{1,19}$",
              "type": "string"
            }
          },
          "required": [
            "target_user_id"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.015,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.015 USD per successful request. Account-specific pricing and final settlement may differ.

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

• Default request reference estimate (USD): 0.015
• Cost contract: fixed_success
• Published reference multiplier: 1.0
• Settlement evidence source: request_snapshot

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

target_user_id · string · required

Numeric ID of the X/Twitter user to follow. Must match the X regex ^[0-9]{1,19}$.

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

Example:

"6253282"

Response

200

application/json

Follow succeeded (or was already in place).

data · object

Show child attributes