TweetAPI

Follow Requests

GET/tw-v2/interaction/follow-requests

Description

Retrieve pending follow-request user IDs for the authenticated X account.

Usage notes

A successful request costs one API unit; failed requests are not billed.

Start with cursor="-1" or omit it. Pass nextCursor unchanged for the next page; stop when it is null. Keep IDs and cursors as strings. An empty list is a successful response.

Query Parameters

ParameterTypeRequiredDescription
authTokenstringrequiredAuthentication token (auth_token cookie value) for the X account whose incoming requests you manage
cursorstringoptionalPagination cursor as a string; default "-1" for the first page
countnumberoptionalPage size as an integer from 1 to 100; default 100
proxystringoptionalOptional proxy in format 'host:port@user:pass'

Code Examples

const params = new URLSearchParams({
  authToken: 'YOUR_AUTH_TOKEN',
  cursor: '-1',
  count: '100'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/interaction/follow-requests?${params}`, {
  method: 'GET',
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

Synthetic example:

200
{
  "data": [
    "9007199254740993123"
  ],
  "pagination": {
    "nextCursor": null,
    "prevCursor": null
  }
}

An empty page is also successful:

200
{
  "data": [],
  "pagination": {
    "nextCursor": null,
    "prevCursor": null
  }
}

Errors

Errors return { statusCode, message } with a non-2xx HTTP status.

400
{
  "statusCode": 400,
  "message": "Request validation failed"
}

TweetAPI is a third-party API and is not affiliated with X Corp.