Subscriptions
GET
/tw-v2/user/subscriptionsDescription
Get a list of accounts that the user has subscribed to. Includes Premium subscribers and Super Followers.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| userId | string | required | Unique platform user ID (e.g., '10017528') |
| cursor | string | optional | Pagination cursor for fetching next page of results. Obtained from previous response. |
Code Examples
const params = new URLSearchParams({
userId: '10017528'
});
const response = await fetch(`https://api.tweetapi.com/tw-v2/user/subscriptions?${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": "3840",
"username": "sample_user_64341",
"name": "Sample User 64341",
"bio": "Sample profile bio for Sample User 64341.",
"location": "Sample City 652",
"website": "https://example.com/link-94089/profile-64341",
"pinnedTweetIds": [
"2001416746569535734"
],
"avatar": "https://example.com/images/sample-avatar-64341.jpg",
"banner": "https://example.com/images/sample-banner-64341.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": 958,
"name": "Entrepreneur",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9001762041664069366"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {
"label": {
"url": {
"url": "https://x.com/sample_user_43038",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/link-94089/profile-29900/media/sample-media-64239.jpg"
},
"description": "Sample description for documentation 90059.",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 1024055,
"followingCount": 5595,
"tweetCount": 63813,
"listedCount": 16459,
"mediaCount": 13310,
"favoritesCount": 118307,
"createdAt": "2006-08-05T23:31:27.000Z"
},
{
"id": "1001320203605596555",
"username": "sample_user_19393",
"name": "Sample User 19393",
"bio": "Sample profile bio for Sample User 19393.",
"location": "Sample City 391",
"website": null,
"pinnedTweetIds": [],
"avatar": "https://example.com/images/sample-avatar-19393.jpg",
"banner": "https://example.com/images/sample-banner-19393.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": 934,
"name": "Social Media Influencer",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9002738441562932892"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 1236846,
"followingCount": 511,
"tweetCount": 58146,
"listedCount": 4026,
"mediaCount": 10986,
"favoritesCount": 32221,
"createdAt": "2021-02-02T02:48:53.000Z"
},
{
"id": "1001462022",
"username": "sample_user_77161",
"name": "Sample User 77161",
"bio": "Sample profile bio for Sample User 77161.",
"location": "Sample City 982",
"website": "https://example.com/link-94089/profile-77161",
"pinnedTweetIds": [
"2004589540135395236"
],
"avatar": "https://example.com/images/sample-avatar-77161.jpg",
"banner": "https://example.com/images/sample-banner-77161.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": 933,
"name": "Media Personality",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9002373364822333041"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 1994813,
"followingCount": 621,
"tweetCount": 25398,
"listedCount": 5838,
"mediaCount": 3590,
"favoritesCount": 28308,
"createdAt": "2015-04-14T21:15:35.000Z"
},
{
"id": "1008666091",
"username": "sample_user_44348",
"name": "Sample User 44348",
"bio": "Sample profile bio for Sample User 44348.",
"location": null,
"website": "https://example.com/link-94089/profile-44348",
"pinnedTweetIds": [
"2001355934359261760"
],
"avatar": "https://example.com/images/sample-avatar-44348.jpg",
"banner": "https://example.com/images/sample-banner-44348.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": true,
"defaultProfileImage": false,
"followerCount": 885949,
"followingCount": 891,
"tweetCount": 7954,
"listedCount": 7015,
"mediaCount": 1927,
"favoritesCount": 5170,
"createdAt": "2013-03-20T02:43:48.000Z"
},
{
"id": "100104298216617487",
"username": "sample_user_19905",
"name": "Sample User 19905",
"bio": "Sample profile bio for Sample User 19905.",
"location": null,
"website": null,
"pinnedTweetIds": [
"2001161250854625224"
],
"avatar": "https://example.com/images/sample-avatar-19905.jpg",
"banner": "https://example.com/images/sample-banner-19905.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9001663416244746192"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": false,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 5757331,
"followingCount": 332,
"tweetCount": 23774,
"listedCount": 14137,
"mediaCount": 19201,
"favoritesCount": 3971,
"createdAt": "2017-04-21T18:02:54.000Z"
},
{
"id": "1001806644416168543",
"username": "sample_user_29731",
"name": "Sample User 29731",
"bio": "Sample profile bio for Sample User 29731.",
"location": "Sample City 468",
"website": "https://example.com/link-94089/profile-29731",
"pinnedTweetIds": [
"2001058379486432640"
],
"avatar": "https://example.com/images/sample-avatar-29731.jpg",
"banner": "https://example.com/images/sample-banner-29731.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Business",
"category": [
{
"id": 954,
"name": "Blogger",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9001174466627142844"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 1046321,
"followingCount": 0,
"tweetCount": 12529,
"listedCount": 2963,
"mediaCount": 10607,
"favoritesCount": 1530,
"createdAt": "2020-07-30T14:20:03.000Z"
},
{
"id": "1001076429713431624",
"username": "sample_user_74786",
"name": "Sample User 74786",
"bio": "Sample profile bio for Sample User 74786.",
"location": null,
"website": "https://example.com/link-94089/profile-74786",
"pinnedTweetIds": [
"2001318824993419822"
],
"avatar": "https://example.com/images/sample-avatar-74786.jpg",
"banner": "https://example.com/images/sample-banner-74786.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": false,
"isTranslator": false,
"affiliatesHighlightedLabel": {
"label": {
"url": {
"url": "https://x.com/sample_user_24646",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/link-94089/profile-29900/media/sample-media-19930.jpg"
},
"description": "Sample description for documentation 84611.",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 4483557,
"followingCount": 428,
"tweetCount": 38835,
"listedCount": 7591,
"mediaCount": 2046,
"favoritesCount": 3442,
"createdAt": "2020-12-05T08:07:34.000Z"
},
{
"id": "1001596317",
"username": "sample_user_76083",
"name": "Sample User 76083",
"bio": "Sample profile bio for Sample User 76083.",
"location": "Sample City 778",
"website": "https://example.com/link-94089/profile-76083",
"pinnedTweetIds": [
"2005726192852681267"
],
"avatar": "https://example.com/images/sample-avatar-76083.jpg",
"banner": "https://example.com/images/sample-banner-76083.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9001626199604209349"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 734418,
"followingCount": 2230,
"tweetCount": 161547,
"listedCount": 7510,
"mediaCount": 17594,
"favoritesCount": 149690,
"createdAt": "2013-07-08T09:31:59.000Z"
},
{
"id": "1002294696",
"username": "sample_user_32614",
"name": "Sample User 32614",
"bio": "Sample profile bio for Sample User 32614.",
"location": null,
"website": "https://example.com/link-94089/profile-32614",
"pinnedTweetIds": [
"2001398697812994995"
],
"avatar": "https://example.com/images/sample-avatar-32614.jpg",
"banner": "https://example.com/images/sample-banner-32614.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": 713,
"name": "Science & Technology",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9001585914007339968"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 428717,
"followingCount": 3108,
"tweetCount": 44526,
"listedCount": 4884,
"mediaCount": 18887,
"favoritesCount": 37280,
"createdAt": "2014-04-27T00:20:12.000Z"
},
{
"id": "1008719261537552105",
"username": "sample_user_82916",
"name": "Sample User 82916",
"bio": "Sample profile bio for Sample User 82916.",
"location": "Sample City 571",
"website": "https://example.com/link-94089/profile-82916",
"pinnedTweetIds": [
"2004173550753566405"
],
"avatar": "https://example.com/images/sample-avatar-82916.jpg",
"banner": "https://example.com/images/sample-banner-82916.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9001838761663999105"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": true,
"defaultProfileImage": false,
"followerCount": 217927,
"followingCount": 427,
"tweetCount": 2715,
"listedCount": 3086,
"mediaCount": 865,
"favoritesCount": 7079,
"createdAt": "2022-09-24T16:27:40.000Z"
},
{
"id": "10017528",
"username": "sample_user_96991",
"name": "Sample User 96991",
"bio": "Sample profile bio for Sample User 96991.",
"location": null,
"website": null,
"pinnedTweetIds": [
"2003874737416606947"
],
"avatar": "https://example.com/images/sample-avatar-96991.jpg",
"banner": "https://example.com/images/sample-banner-96991.jpg",
"profileImageShape": "Circle",
"verified": false,
"isBlueVerified": true,
"verifiedType": null,
"verifiedSince": null,
"isIdentityVerified": false,
"isProtected": false,
"possiblySensitive": false,
"profileInterstitialType": null,
"withheldInCountries": [],
"professional": {
"type": "Creator",
"category": [],
"restId": "9009505976599913053"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {
"label": {
"url": {
"url": "https://example.com/link-94089/profile-41921/X",
"urlType": "DeepLink"
},
"badge": {
"url": "https://example.com/link-94089/profile-29900/media/sample-media-25883.jpg"
},
"description": "Sample description for documentation 53418.",
"userLabelType": "BusinessLabel",
"userLabelDisplayType": "Badge"
}
},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 226998062,
"followingCount": 1218,
"tweetCount": 86750,
"listedCount": 164449,
"mediaCount": 4162,
"favoritesCount": 174844,
"createdAt": "2009-06-02T20:12:29.000Z"
},
{
"id": "1004453754",
"username": "sample_user_75839",
"name": "Sample User 75839",
"bio": "Sample profile bio for Sample User 75839.",
"location": "Sample City 417",
"website": "https://example.com/link-94089/profile-75839",
"pinnedTweetIds": [
"2004470839611227157"
],
"avatar": "https://example.com/images/sample-avatar-75839.jpg",
"banner": "https://example.com/images/sample-banner-75839.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": 933,
"name": "Media Personality",
"icon_name": "IconBriefcaseStroke"
}
],
"restId": "9001183443225160892"
},
"businessAccount": null,
"creatorSubscriptionsCount": 0,
"hasHiddenSubscriptions": false,
"highlightsInfo": null,
"hasGraduatedAccess": true,
"isProfileTranslatable": false,
"hasCustomTimelines": true,
"isTranslator": false,
"affiliatesHighlightedLabel": {},
"defaultProfile": false,
"defaultProfileImage": false,
"followerCount": 33317973,
"followingCount": 2190,
"tweetCount": 7459,
"listedCount": 9062,
"mediaCount": 971,
"favoritesCount": 23204,
"createdAt": "2014-04-21T00:28:42.000Z"
}
],
"pagination": {
"nextCursor": "0|1973632539645968370",
"prevCursor": "-1|1973632539645968385"
}
}API Playground
GET
/tw-v2/user/subscriptionsPress ⌘ + Enter to execute
curl -X GET "https://api.tweetapi.com/tw-v2/user/subscriptions" \
-H "X-API-Key: YOUR_API_KEY"Response
Click "Try It!" to see the response