By Id

GET/tw-v2/space/by-id

Description

Retrieve detailed information about a Twitter Space (audio room) by its ID. Returns comprehensive data including title, state, creator, participants, topics, and engagement stats.

Parameters

ParameterTypeRequiredDescription
spaceIdstringrequiredUnique Space ID (e.g., '1MnxnPmLRQBGO')

Code Examples

const params = new URLSearchParams({
  spaceId: '1MnxnPmLRQBGO'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/space/by-id?${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": "1MnxnPmLRQBGO",
    "title": "DOG TALK ON CSN",
    "state": "Ended",
    "mediaKey": "28_1991353658102149130",
    "createdAt": 1763610684292,
    "scheduledStart": 1763647200000,
    "startedAt": 1763647259862,
    "endedAt": 1763651150919,
    "updatedAt": 1763651153433,
    "creator": {
      "id": "832980412452503556",
      "username": "web3smb",
      "name": "Web",
      "bio": "CSN Creator",
      "location": "Web3",
      "website": "http://doginaldogs.com",
      "pinnedTweetIds": [
        "1996623331056144459"
      ],
      "avatar": "https://pbs.twimg.com/profile_images/1994572701151670272/h0So0tv6_normal.jpg",
      "banner": "https://pbs.twimg.com/profile_banners/832980412452503556/1754162025/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": 144,
            "name": "Education",
            "icon_name": "IconBriefcaseStroke"
          }
        ],
        "restId": "1659307945165832194"
      },
      "businessAccount": null,
      "creatorSubscriptionsCount": 0,
      "hasHiddenSubscriptions": false,
      "highlightsInfo": null,
      "hasGraduatedAccess": true,
      "isProfileTranslatable": false,
      "hasCustomTimelines": true,
      "isTranslator": false,
      "affiliatesHighlightedLabel": {
        "label": {
          "url": {
            "url": "https://twitter.com/BeanieDaoX",
            "urlType": "DeepLink"
          },
          "badge": {
            "url": "https://pbs.twimg.com/profile_images/1984697970705801217/WbUNxWHa_bigger.jpg"
          },
          "description": "BoB",
          "userLabelType": "BusinessLabel",
          "userLabelDisplayType": "Badge"
        }
      },
      "defaultProfile": true,
      "defaultProfileImage": false,
      "followerCount": 29294,
      "followingCount": 8520,
      "tweetCount": 81254,
      "listedCount": 172,
      "mediaCount": 10183,
      "favoritesCount": 324852,
      "createdAt": "2017-02-18T15:49:41.000Z"
    },
    "totalLiveListeners": 3272,
    "totalReplayWatched": 13,
    "participants": {
      "admins": [
        {
          "periscopeUserId": "1WLERbMWDkWEb",
          "twitterUserId": "832980412452503556",
          "username": "web3smb",
          "displayName": "Web",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1994572701151670272/h0So0tv6_normal.jpg",
          "isVerified": true,
          "isBlueVerified": true,
          "isMutedByAdmin": false,
          "isMutedByGuest": true,
          "startedAt": 1763610684292
        },
        {
          "periscopeUserId": "1zYKbMkApPlQe",
          "twitterUserId": "1459169428743114756",
          "username": "DroMeta",
          "displayName": "Dro",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1961059876819341312/_dN49Yj2_normal.jpg",
          "isVerified": true,
          "isBlueVerified": true,
          "isMutedByAdmin": false,
          "isMutedByGuest": true,
          "startedAt": 1763610684292
        },
        {
          "periscopeUserId": "1YLEJOpJWzVQN",
          "twitterUserId": "923570556330500096",
          "username": "Nicemetax",
          "displayName": "Nice",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1969428257901625344/Two1K4ur_normal.jpg",
          "isVerified": true,
          "isBlueVerified": true,
          "isMutedByAdmin": false,
          "isMutedByGuest": true,
          "startedAt": 1763610684292
        }
      ],
      "speakers": [
        {
          "periscopeUserId": "1DLKBnxebLmKJ",
          "twitterUserId": "1433178538228822022",
          "username": "KingAnt",
          "displayName": "Ant",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1995152528330162176/mIT9asuZ_normal.jpg",
          "isVerified": true,
          "isBlueVerified": true,
          "isMutedByAdmin": false,
          "isMutedByGuest": true,
          "startedAt": 1763649253456
        },
        {
          "periscopeUserId": "1PmKqJMmgBxjo",
          "twitterUserId": "3588771076",
          "username": "Shieldmetax",
          "displayName": "Shield",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1995538745706020864/kmuPLRAx_normal.jpg",
          "isVerified": true,
          "isBlueVerified": true,
          "isMutedByAdmin": false,
          "isMutedByGuest": true,
          "startedAt": 1763649603080
        }
      ],
      "listeners": [],
      "total": 0
    },
    "isAvailableForReplay": true,
    "isAvailableForClipping": true,
    "contentType": "visual_audio",
    "narrowCastSpaceType": 0,
    "conversationControls": 0,
    "disallowJoin": false,
    "isEmployeeOnly": false,
    "isLocked": false,
    "isMuted": false,
    "noIncognito": false,
    "maxGuestSessions": 10,
    "maxAdminCapacity": 3,
    "topics": [
      {
        "id": "1369311988040355840",
        "name": "NFTs"
      },
      {
        "id": "913142676819648512",
        "name": "Cryptocurrencies"
      },
      {
        "id": "839544274442051584",
        "name": "Entertainment"
      }
    ],
    "tweetId": "1991507072345944240",
    "mentionedUserIds": [
      "3588771076"
    ]
  }
}

API Playground

GET/tw-v2/space/by-id

Press ⌘ + Enter to execute

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

Click "Try It!" to see the response