Following V2

GET/tw-v2/user/following

Description

Get a paginated list of users that the specified account is following. Returns user objects with complete profile information.

Parameters

ParameterTypeRequiredDescription
userIdstringrequiredUnique platform user ID (e.g., '90013690')
cursorstringoptionalPagination cursor for fetching next page of results. Obtained from previous response.

Code Examples

const params = new URLSearchParams({
  userId: '90013690'
});

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

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

Response

Success Response (200 OK)

200
{
  "data": [
    {
      "id": "10019446",
      "username": "sample_user_50395",
      "name": "Sample User 50395",
      "bio": "Sample profile bio for Sample User 50395.",
      "location": null,
      "website": "https://example.com/link-94089/profile-50395",
      "pinnedTweetIds": [
        "2008720192651161914"
      ],
      "avatar": "https://example.com/images/sample-avatar-50395.jpg",
      "banner": "https://example.com/images/sample-banner-50395.jpg",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": {
        "type": "Creator",
        "category": [
          {
            "id": 144,
            "name": "Education",
            "icon_name": "IconBriefcaseStroke"
          }
        ],
        "restId": "9001486309657427110"
      },
      "businessAccount": null,
      "creatorSubscriptionsCount": 0,
      "hasHiddenSubscriptions": false,
      "highlightsInfo": null,
      "hasGraduatedAccess": true,
      "isProfileTranslatable": false,
      "hasCustomTimelines": true,
      "isTranslator": false,
      "affiliatesHighlightedLabel": {},
      "defaultProfile": false,
      "defaultProfileImage": false,
      "followerCount": 6154414,
      "followingCount": 1659,
      "tweetCount": 51578,
      "listedCount": 14926,
      "mediaCount": 7370,
      "favoritesCount": 227,
      "createdAt": "2009-12-06T23:33:02.000Z"
    },
    {
      "id": "10075982",
      "username": "sample_user_89761",
      "name": "Sample User 89761",
      "bio": "Sample profile bio for Sample User 89761.",
      "location": "Sample City 982",
      "website": "https://example.com/link-94089/profile-89761",
      "pinnedTweetIds": [
        "2001816059599512081"
      ],
      "avatar": "https://example.com/images/sample-avatar-89761.jpg",
      "banner": "https://example.com/images/sample-banner-89761.jpg",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": null,
      "businessAccount": null,
      "creatorSubscriptionsCount": 0,
      "hasHiddenSubscriptions": false,
      "highlightsInfo": null,
      "hasGraduatedAccess": true,
      "isProfileTranslatable": false,
      "hasCustomTimelines": true,
      "isTranslator": false,
      "affiliatesHighlightedLabel": {},
      "defaultProfile": false,
      "defaultProfileImage": false,
      "followerCount": 15512691,
      "followingCount": 2296,
      "tweetCount": 51834,
      "listedCount": 25067,
      "mediaCount": 3408,
      "favoritesCount": 38858,
      "createdAt": "2009-05-11T21:18:33.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "1839632320121967803|1973625938591612856",
    "prevCursor": "-1|1973625938591612929"
  }
}

API Playground

GET/tw-v2/user/following

Press ⌘ + Enter to execute

curl -X GET "https://api.tweetapi.com/tw-v2/user/following" \
  -H "X-API-Key: YOUR_API_KEY"
Response

Click "Try It!" to see the response