TweetAPI

Subscriptions

GET/tw-v2/user/subscriptions

Description

Get a list of accounts that the user has subscribed to. Includes Twitter Blue subscribers and Super Followers.

Parameters

ParameterTypeRequiredDescription
userIdstringrequiredUnique Twitter/X user ID (e.g., '44196397')
cursorstringoptionalPagination cursor for fetching next page of results. Obtained from previous response.

Code Examples

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

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": "Jason",
      "name": "@jason",
      "bio": "first investor in https://t.co/M6cblbFld9 Host: @twistartups @theallinpod; I also invest in 100 startups a year @launch & @founderuni jason@calacanis.com for life",
      "location": "austin ",
      "website": "http://calacanis.com",
      "pinnedTweetIds": [
        "1972647552052019429"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1828870492633104384/o37xorx4_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/3840/1694810043/1500x500",
      "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": "1462524255942311936"
      },
      "businessAccount": null,
      "creatorSubscriptionsCount": 0,
      "hasHiddenSubscriptions": false,
      "highlightsInfo": null,
      "hasGraduatedAccess": true,
      "isProfileTranslatable": false,
      "hasCustomTimelines": true,
      "isTranslator": false,
      "affiliatesHighlightedLabel": {
        "label": {
          "url": {
            "url": "https://twitter.com/theallinpod",
            "urlType": "DeepLink"
          },
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/1789812359084519424/hg3j0g2E_bigger.jpg"
          },
          "description": "The All-In Podcast",
          "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": "1356434353623093249",
      "username": "greg16676935420",
      "name": "greg",
      "bio": "im greg I like football and stocks and my birthday im from kentuckey. I'm a investor. I like to golf at the golf course. subscribe for just 10¢ a day ⤴️",
      "location": "Kentucky, USA",
      "website": null,
      "pinnedTweetIds": [],
      "avatar": "https://pbs.twimg.com/profile_images/1581014308397502464/NPogKMyk_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/1356434353623093249/1757986366/1500x500",
      "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": "1909768173290922245"
      },
      "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": "3167257102",
      "username": "Erdayastronaut",
      "name": "Everyday Astronaut",
      "bio": "Professional rocket orientation specialist, explainer of flamey stuff and rocket chaser. Bringing space down to Earth for everyday people 🚀",
      "location": "Iowa, United States",
      "website": "http://astroawards.live",
      "pinnedTweetIds": [
        "1796764250897260716"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1253477073265532928/MmGBMWsQ_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/3167257102/1705712683/1500x500",
      "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": "1503187800358895624"
      },
      "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": "1282121312",
      "username": "waitbutwhy",
      "name": "Tim Urban",
      "bio": "Writer, infant",
      "location": null,
      "website": "https://waitbutwhy.com/",
      "pinnedTweetIds": [
        "1627991876413321219"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/378800000096549990/2b5b8a614e16b1527ebb75e1a7266d85_400x400.jpeg",
      "banner": "https://pbs.twimg.com/profile_banners/1282121312/1654100504/1500x500",
      "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": "855481986290524160",
      "username": "historyinmemes",
      "name": "Historic Vids",
      "bio": "Daily history lessons. Education through memes!",
      "location": null,
      "website": null,
      "pinnedTweetIds": [
        "1973121382398505051"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1648334723725361152/ev7V1230_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/855481986290524160/1651700840/1500x500",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": {
        "type": "Creator",
        "category": [],
        "restId": "1511422137550180354"
      },
      "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": "1288841746898534401",
      "username": "PhysInHistory",
      "name": "Physics In History",
      "bio": "Photos from the history of physics | © with mentioned Archives. Shared for educational purposes. Einstein portrait © Ullsteinbild. Subscribe for curated papers.",
      "location": "Nepal",
      "website": "https://medium.com/@piggsboson",
      "pinnedTweetIds": [
        "1967551517076132010"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1456245154377916417/oPMz8-kf_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/1288841746898534401/1596119215/1500x500",
      "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": "1455790000021262337"
      },
      "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": "1335132884278108161",
      "username": "stats_feed",
      "name": "World of Statistics",
      "bio": "There are three kinds of lies: lies, damned lies, and statistics. Sister page of @engineers_feed",
      "location": null,
      "website": "http://youtube.com/@stats_feed",
      "pinnedTweetIds": [
        "1973065770276913422"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1335168437220421632/VCHg78Nf_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/1335132884278108161/1630493927/1500x500",
      "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://twitter.com/Kalshi",
            "urlType": "DeepLink"
          },
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/1841549922694262784/1qzNBZII_bigger.jpg"
          },
          "description": "Kalshi",
          "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": "1577241403",
      "username": "levelsio",
      "name": "@levelsio",
      "bio": "💸https://t.co/sQ0aiU7v02 $336K/m\n📸https://t.co/lAyoqmSBRX $150K/m\n🛰https://t.co/ZHSvI2wjyW $33K/m\n🏡https://t.co/1oqUgfD6CZ $30K/m\n🌍https://t.co/UXK5AFqCaQ $7K/m\n👙https://t.co/RyXpqGuFM3 $14K/m\n💾https://t.co/M1hEUBAynC $6K/m",
      "location": "📕 My book $8K/m  👉",
      "website": "http://readMAKE.com",
      "pinnedTweetIds": [
        "1457315274466594817"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1589756412078555136/YlXMBzhp_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/1577241403/1665964220/1500x500",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": {
        "type": "Creator",
        "category": [],
        "restId": "1800203633688027410"
      },
      "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": "2465283662",
      "username": "_akhaliq",
      "name": "AK",
      "bio": "AI research paper tweets, ML @Gradio (acq. by @HuggingFace 🤗) dm for promo ,submit papers here: https://t.co/UzmYN5YmrQ",
      "location": null,
      "website": "https://huggingface.co/akhaliq",
      "pinnedTweetIds": [
        "1844746338396770616"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1451191636810092553/kpM5Fe12_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/2465283662/1610997549/1500x500",
      "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": "1517258517157228544"
      },
      "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": "1573710710852489216",
      "username": "AiBreakfast",
      "name": "AI Breakfast",
      "bio": "The latest rumors and developments in the world of artificial intelligence.  DM to include your AI project in the newsletter.",
      "location": "Join 95,000 on the newsletter→",
      "website": "http://aibreakfast.beehiiv.com/subscribe",
      "pinnedTweetIds": [
        "1948511404958568820"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1597035080421019649/QnsiETGG_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/1573710710852489216/1669597417/1500x500",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": {
        "type": "Creator",
        "category": [],
        "restId": "1574062604259139584"
      },
      "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": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "bio": "https://t.co/9qhgzJ69UQ",
      "location": null,
      "website": null,
      "pinnedTweetIds": [
        "1973288477988143277"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1936002956333080576/kqqe2iWO_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/44196397/1739948056/1500x500",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": true,
      "verifiedType": null,
      "verifiedSince": null,
      "isIdentityVerified": false,
      "isProtected": false,
      "possiblySensitive": false,
      "profileInterstitialType": null,
      "withheldInCountries": [],
      "professional": {
        "type": "Creator",
        "category": [],
        "restId": "1679729435447275522"
      },
      "businessAccount": null,
      "creatorSubscriptionsCount": 0,
      "hasHiddenSubscriptions": false,
      "highlightsInfo": null,
      "hasGraduatedAccess": true,
      "isProfileTranslatable": false,
      "hasCustomTimelines": true,
      "isTranslator": false,
      "affiliatesHighlightedLabel": {
        "label": {
          "url": {
            "url": "https://twitter.com/X",
            "urlType": "DeepLink"
          },
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
          },
          "description": "X",
          "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": "2455740283",
      "username": "MrBeast",
      "name": "MrBeast",
      "bio": "New MrBeast or MrBeast Gaming video each Saturday!",
      "location": "Follow me for a cookie",
      "website": "http://teamwater.org",
      "pinnedTweetIds": [
        "1941802940768850033"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/994592419705274369/RLplF55e_400x400.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/2455740283/1743017990/1500x500",
      "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": "1679573344159510535"
      },
      "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/subscriptions

Press ⌘ + 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