Details

GET/tw-v2/list/details

Description

Get detailed information about a specific list including metadata, member count, and configuration settings.

Parameters

ParameterTypeRequiredDescription
listIdstringrequiredUnique list ID

Code Examples

const params = new URLSearchParams({
  listId: '1234567890'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/list/details?${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": "9001939934624392988",
    "name": "Sample User 71233",
    "description": "Sample profile bio for Sample User 52066.",
    "mode": "public",
    "memberCount": 42,
    "subscriberCount": 2362,
    "createdAt": "2022-07-01T02:37:35.000Z",
    "owner": {
      "id": "1004175810672249878",
      "username": "sample_user_78026",
      "name": "Sample User 78026",
      "bio": "Sample profile bio for Sample User 78026.",
      "location": null,
      "website": null,
      "pinnedTweetIds": [
        "2003389317958797165"
      ],
      "avatar": "https://example.com/images/sample-avatar-78026.jpg",
      "banner": "https://example.com/images/sample-banner-78026.jpg",
      "profileImageShape": "Circle",
      "verified": false,
      "isBlueVerified": false,
      "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": 66,
      "followingCount": 334,
      "tweetCount": 1477,
      "listedCount": 0,
      "mediaCount": 19,
      "favoritesCount": 59316,
      "createdAt": "2020-03-14T01:03:23.000Z"
    },
    "bannerUrl": null,
    "defaultBannerMedia": null,
    "facepileUrls": [
      "https://example.com/link-94089/profile-29900/media/sample-media-71233.jpg",
      "https://example.com/link-94089/profile-29900/media/sample-media-71233.jpg",
      "https://example.com/link-94089/profile-29900/media/sample-media-71233.jpg"
    ],
    "slug": "",
    "uri": ""
  }
}

API Playground

GET/tw-v2/list/details

Press ⌘ + Enter to execute

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

Click "Try It!" to see the response