{ "openapi": "3.0.3", "info": { "title": "TweetAPI v2 API Reference", "version": "2.0.0", "description": "Public contract for TweetAPI's customer-facing /tw-v2 API. TweetAPI is a third-party API and is not affiliated with X Corp.", "contact": { "name": "TweetAPI Support", "url": "https://tweetapi.com" }, "license": { "name": "Proprietary", "url": "https://tweetapi.com/terms" } }, "servers": [ { "url": "https://api.tweetapi.com", "description": "TweetAPI production API" } ], "tags": [ { "name": "User", "description": "Public profile, relationship, timeline, and follower data." }, { "name": "Tweet", "description": "Tweet lookup, conversation, quote, retweet, and translation operations." }, { "name": "Post (write)", "description": "Operations that publish, reply to, quote, or delete public content." }, { "name": "Interaction (account action)", "description": "Authenticated engagement and account activity operations." }, { "name": "List", "description": "List lookup and authenticated list-management operations." }, { "name": "Profile (account action)", "description": "Authenticated profile settings and media operations." }, { "name": "Community", "description": "Community discovery, membership, and community-post operations." }, { "name": "Space", "description": "Space metadata and stream lookup operations." }, { "name": "Search", "description": "Public Twitter search operations." }, { "name": "Authentication (credentials)", "description": "Credential-bearing login operation. Handle request and response data as secrets." }, { "name": "XChat (encrypted messaging)", "description": "Encrypted-message setup, reads, and writes. Handle all message material as sensitive." }, { "name": "Direct Messages (legacy)", "description": "Legacy direct-message reads and writes. Handle all message material as sensitive." } ], "security": [ { "TweetApiKey": [] } ], "paths": { "/tw-v2/user/by-username": { "get": { "tags": [ "User" ], "summary": "By Username", "description": "Retrieve comprehensive user profile information using a platform username. Returns detailed user data including statistics, verification status, and profile metadata.", "operationId": "getUserByUsername", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "pinnedTweetIds": [ "2001738170940982678" ], "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": "9001630152611040706" }, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 225, "hasHiddenSubscriptions": true, "highlightsInfo": { "canHighlight": true, "highlightedTweetsCount": "758" }, "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": 226995885, "followingCount": 1218, "tweetCount": 86745, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174837, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "username", "in": "query", "required": true, "description": "platform username without @ symbol (e.g., 'sample_user_96991')", "schema": { "type": "string", "minLength": 1 }, "example": "sample_user" } ] } }, "/tw-v2/user/by-usernames": { "get": { "tags": [ "User" ], "summary": "By Usernames", "description": "Retrieve comprehensive user profile information for multiple users in a single request using their platform usernames. Returns detailed user data including statistics, verification status, and profile metadata for up to 50 users at once.", "operationId": "getUserByUsernames", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserArrayResponse" }, "example": { "data": [ { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "", "location": null, "website": null, "pinnedTweetIds": [ "2001165726736489550" ], "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": "9002120522450210227" }, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 232, "hasHiddenSubscriptions": true, "highlightsInfo": { "canHighlight": true, "highlightedTweetsCount": "827" }, "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": 229682771, "followingCount": 1245, "tweetCount": 91086, "listedCount": 165562, "mediaCount": 4262, "favoritesCount": 189194, "createdAt": "2009-06-02T20:12:29.000Z" }, { "id": "10016309", "username": "sample_user_59576", "name": "Sample User 59576", "bio": "Sample profile bio for Sample User 59576.", "location": "Sample City 250", "website": "https://example.com/link-94089/profile-59576", "pinnedTweetIds": [ "2009999514733160317" ], "avatar": "https://example.com/images/sample-avatar-59576.jpg", "banner": "https://example.com/images/sample-banner-59576.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": "2012-01-11T16:12:34.088Z", "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [], "restId": "9004223157933035875" }, "businessAccount": { "affiliatesCount": 16 }, "creatorSubscriptionsCount": 1, "hasHiddenSubscriptions": false, "highlightsInfo": { "canHighlight": true, "highlightedTweetsCount": "113" }, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 40396663, "followingCount": 120, "tweetCount": 10896, "listedCount": 43884, "mediaCount": 4235, "favoritesCount": 519, "createdAt": "2009-04-23T21:53:30.000Z" } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "usernames", "in": "query", "required": true, "description": "Comma-separated list of platform usernames without @ symbol (maximum 50 usernames per request). The @ symbol is automatically stripped if provided.", "schema": { "oneOf": [ { "type": "string", "minLength": 1, "description": "Comma-separated usernames." }, { "type": "array", "minItems": 1, "maxItems": 50, "items": { "type": "string" } } ] }, "example": "sample_user,sample_researcher" } ] } }, "/tw-v2/user/by-id": { "get": { "tags": [ "User" ], "summary": "By User Id", "description": "Retrieve comprehensive user profile information using a platform user ID. Returns detailed user data including statistics, verification status, and profile metadata.", "operationId": "getUserById", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "pinnedTweetIds": [ "2001738170940982678" ], "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": "9001630152611040706" }, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 225, "hasHiddenSubscriptions": false, "highlightsInfo": { "canHighlight": true, "highlightedTweetsCount": "758" }, "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": 226995890, "followingCount": 1218, "tweetCount": 86745, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174837, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" } ] } }, "/tw-v2/user/by-ids": { "get": { "tags": [ "User" ], "summary": "By User Ids", "description": "Retrieve comprehensive user profile information for multiple users in a single request using their platform user IDs. Returns detailed user data including statistics, verification status, and profile metadata for up to 50 users at once.", "operationId": "getUserByIds", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserArrayResponse" }, "example": { "data": [ { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "pinnedTweetIds": [ "2008402643216600030" ], "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": "9002120522450210227" }, "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": 226995859, "followingCount": 1218, "tweetCount": 86745, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.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": [ "2001487922093177253" ], "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": "9005853162840217067" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 734417, "followingCount": 2230, "tweetCount": 161547, "listedCount": 7510, "mediaCount": 17594, "favoritesCount": 149690, "createdAt": "2013-07-08T09:31:59.000Z" } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userIds", "in": "query", "required": true, "description": "Comma-separated list of platform user IDs to retrieve (maximum 50 IDs per request).", "schema": { "oneOf": [ { "type": "string", "pattern": "^\\s*\\d+\\s*(?:,\\s*\\d+\\s*){0,49}$", "description": "One to 50 comma-separated numeric user IDs. Surrounding whitespace is trimmed." }, { "type": "array", "minItems": 1, "maxItems": 50, "items": { "$ref": "#/components/schemas/SnowflakeId" } } ] }, "example": "1234567890,9876543210" } ] } }, "/tw-v2/user/tweets": { "get": { "tags": [ "User" ], "summary": "Tweets", "description": "Retrieve tweets posted by a specific user. Returns a paginated timeline of original tweets (no replies).", "operationId": "getUserTweets", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetPageResponse" }, "example": { "data": [ { "id": "5001591756625130239", "conversationId": "5001591756625130239", "text": "Sample post text 83969 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174839, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 308, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_18760", "sample_user_26437" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:47:48.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008764432791373827", "conversationId": "5008764432791373827", "text": "Sample post text 05861 for documentation.", "displayTextRange": [ 0, 14 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174839, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5001326762730364257", "conversationId": "5001326762730364257", "text": "Sample post text 87993 for documentation.", "displayTextRange": [ 0, 4 ], "author": { "id": "10051246", "username": "sample_user_35585", "name": "Sample User 35585", "bio": "Sample profile bio for Sample User 35585.", "location": "Sample City 147", "website": null, "pinnedTweetIds": [ "2001184043341139638" ], "avatar": "https://example.com/images/sample-avatar-35585.jpg", "banner": "https://example.com/images/sample-banner-35585.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": 672408, "followingCount": 3478, "tweetCount": 267584, "listedCount": 4978, "mediaCount": 15841, "favoritesCount": 96203, "createdAt": "2007-06-25T21:03:36.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 6504, "retweetCount": 493, "replyCount": 303, "quoteCount": 2, "bookmarkCount": 259, "viewCount": 13373944, "media": [ { "id": "2001542505607599289", "key": "3_2001542505607599289", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg", "displayUrl": "pic.x.com/IZ6RBzsBAa", "expandedUrl": "https://x.com/sample_user_14641/status/2009988722539212593/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg", "width": 631, "height": 664, "aspectRatio": [ 631, 664 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 631, "height": 664, "resize": "fit" }, "medium": { "width": 631, "height": 664, "resize": "fit" }, "large": { "width": 631, "height": 664, "resize": "fit" }, "original": { "width": 631, "height": 664, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 239, "width": 631, "height": 353 }, { "x": 0, "y": 33, "width": 631, "height": 631 }, { "x": 0, "y": 0, "width": 582, "height": 664 }, { "x": 0, "y": 0, "width": 332, "height": 664 }, { "x": 0, "y": 0, "width": 631, "height": 664 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T23:59:45.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 133058, "retweetCount": 12364, "replyCount": 8555, "quoteCount": 838, "bookmarkCount": 2775, "viewCount": 13154390, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T02:42:03.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAAHCgABG2O6blp__-sLAAIAAAATMTk3MzQ5NjkzNDM4MDk5OTA3OQgAAwAAAAIAAA", "prevCursor": "DAAHCgABG2O6blqAJxELAAIAAAATMTk3MzYyNTk0NTQ4MDQyOTYwMggAAwAAAAEAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/tweets-and-replies": { "get": { "tags": [ "User" ], "summary": "Tweets And Replies", "description": "Retrieve tweets and replies posted by a specific user. Returns a paginated timeline including both original tweets and replies.", "operationId": "getUserTweetsAndReplies", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetPageResponse" }, "example": { "data": [ { "id": "5001591756625130239", "conversationId": "5001591756625130239", "text": "Sample post text 83969 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 309, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_18760", "sample_user_26437" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:47:48.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008764432791373827", "conversationId": "5008764432791373827", "text": "Sample post text 05861 for documentation.", "displayTextRange": [ 0, 14 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5001326762730364257", "conversationId": "5001326762730364257", "text": "Sample post text 87993 for documentation.", "displayTextRange": [ 0, 4 ], "author": { "id": "10051246", "username": "sample_user_35585", "name": "Sample User 35585", "bio": "Sample profile bio for Sample User 35585.", "location": "Sample City 147", "website": null, "pinnedTweetIds": [ "2001184043341139638" ], "avatar": "https://example.com/images/sample-avatar-35585.jpg", "banner": "https://example.com/images/sample-banner-35585.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": 672408, "followingCount": 3478, "tweetCount": 267584, "listedCount": 4978, "mediaCount": 15841, "favoritesCount": 96203, "createdAt": "2007-06-25T21:03:36.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 6506, "retweetCount": 493, "replyCount": 303, "quoteCount": 2, "bookmarkCount": 259, "viewCount": 13328937, "media": [ { "id": "2001542505607599289", "key": "3_2001542505607599289", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg", "displayUrl": "pic.x.com/IZ6RBzsBAa", "expandedUrl": "https://x.com/sample_user_14641/status/2009988722539212593/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-82570.jpg", "width": 631, "height": 664, "aspectRatio": [ 631, 664 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 631, "height": 664, "resize": "fit" }, "medium": { "width": 631, "height": 664, "resize": "fit" }, "large": { "width": 631, "height": 664, "resize": "fit" }, "original": { "width": 631, "height": 664, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 239, "width": 631, "height": 353 }, { "x": 0, "y": 33, "width": 631, "height": 631 }, { "x": 0, "y": 0, "width": 582, "height": 664 }, { "x": 0, "y": 0, "width": 332, "height": 664 }, { "x": 0, "y": 0, "width": 631, "height": 664 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T23:59:45.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 133087, "retweetCount": 12366, "replyCount": 8555, "quoteCount": 838, "bookmarkCount": 2775, "viewCount": 13154390, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T02:42:03.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5009654759134967489", "conversationId": "5009654759134967489", "text": "Sample post text 08754 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 6979, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 18, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_89849" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T00:22:28.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001408543408895944", "conversationId": "5001408543408895944", "text": "Sample post text 17797 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 5549, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 2, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_01062" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T00:20:42.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5002333148827998832", "conversationId": "5002333148827998832", "text": "Sample post text 76968 for documentation.", "displayTextRange": [ 0, 148 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 19745, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 9, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_28930", "sample_user_75527" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T00:20:03.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001015733109059270", "conversationId": "5001015733109059270", "text": "Sample post text 96189 for documentation.", "displayTextRange": [ 0, 4 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5003969848913653241", "conversationId": "5003969848913653241", "text": "Sample post text 89313 for documentation.", "displayTextRange": [ 0, 241 ], "author": { "id": "2001703038104952149", "username": "sample_user_93054", "name": "Sample User 93054", "bio": "Sample profile bio for Sample User 93054.", "location": null, "website": null, "pinnedTweetIds": [ "2001197362889368128" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-29104.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-29104.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": "2001644683195519401" }, "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_16773", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-90585.jpg" }, "description": "Sample description for documentation 16374.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 1742586, "followingCount": 998, "tweetCount": 52653, "listedCount": 5829, "mediaCount": 29414, "favoritesCount": 110461, "createdAt": "2021-05-05T12:03:43.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 616, "retweetCount": 128, "replyCount": 138, "quoteCount": 27, "bookmarkCount": 46, "viewCount": 2202073, "media": [ { "id": "2006780362599633143", "key": "3_2006780362599633143", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-39843.jpg", "displayUrl": "pic.x.com/q22239nnbE", "expandedUrl": "https://x.com/sample_user_36702/status/2005157336766221997/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-39843.jpg", "width": 800, "height": 1074, "aspectRatio": [ 400, 537 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 507, "height": 680, "resize": "fit" }, "medium": { "width": 800, "height": 1074, "resize": "fit" }, "large": { "width": 800, "height": 1074, "resize": "fit" }, "original": { "width": 800, "height": 1074, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 626, "width": 800, "height": 448 }, { "x": 0, "y": 274, "width": 800, "height": 800 }, { "x": 0, "y": 162, "width": 800, "height": 912 }, { "x": 188, "y": 0, "width": 537, "height": 1074 }, { "x": 0, "y": 0, "width": 800, "height": 1074 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:40:31.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 10032, "retweetCount": 1734, "replyCount": 1706, "quoteCount": 97, "bookmarkCount": 301, "viewCount": 2157784, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T00:16:48.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008041707893943814", "conversationId": "5008041707893943814", "text": "Sample post text 73327 for documentation.", "displayTextRange": [ 0, 2 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5001883234431964544", "conversationId": "5001883234431964544", "text": "Sample post text 01970 for documentation.", "displayTextRange": [ 0, 272 ], "author": { "id": "20011470", "username": "sample_user_94596", "name": "Sample User 94596", "bio": "Sample profile bio for Sample User 94596.", "location": "Sample City 031", "website": "https://example.com/link-94089/profile-29900/profile-76341", "pinnedTweetIds": [ "2001584270043555670" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-76341.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-76341.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [], "restId": "2004994708298694452" }, "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_72380", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-91111.jpg" }, "description": "Sample description for documentation 09590.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 2319191, "followingCount": 992, "tweetCount": 109447, "listedCount": 22273, "mediaCount": 13445, "favoritesCount": 30736, "createdAt": "2008-09-01T03:13:32.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 8531, "retweetCount": 1732, "replyCount": 331, "quoteCount": 124, "bookmarkCount": 470, "viewCount": 3469415, "media": [ { "id": "2001426637152556421", "key": "3_2001426637152556421", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-44550.jpg", "displayUrl": "pic.x.com/M1En4hIaOI", "expandedUrl": "https://x.com/sample_user_02807/status/2006709766184718602/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-44550.jpg", "width": 2382, "height": 950, "aspectRatio": [ 1191, 475 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 271, "resize": "fit" }, "medium": { "width": 1200, "height": 479, "resize": "fit" }, "large": { "width": 2048, "height": 817, "resize": "fit" }, "original": { "width": 2382, "height": 950, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 0, "width": 1696, "height": 950 }, { "x": 0, "y": 0, "width": 950, "height": 950 }, { "x": 0, "y": 0, "width": 833, "height": 950 }, { "x": 178, "y": 0, "width": 475, "height": 950 }, { "x": 0, "y": 0, "width": 2382, "height": 950 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:42:21.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 34085, "retweetCount": 5724, "replyCount": 1923, "quoteCount": 131, "bookmarkCount": 1068, "viewCount": 3095212, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "qst", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T23:33:19.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5007094016832281578", "conversationId": "5007094016832281578", "text": "Sample post text 05861 for documentation.", "displayTextRange": [ 0, 14 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5001213616578405896", "conversationId": "5001213616578405896", "text": "Sample post text 58170 for documentation.", "displayTextRange": [ 0, 241 ], "author": { "id": "2001782185964267420", "username": "sample_user_26437", "name": "Sample User 26437", "bio": "Sample profile bio for Sample User 26437.", "location": "Sample City 977", "website": "https://example.com/link-94089/profile-29900/profile-59797", "pinnedTweetIds": [ "2001254681058547323" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-59797.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-59797.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001751835260489657" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4497601, "followingCount": 1023, "tweetCount": 46626, "listedCount": 10678, "mediaCount": 19267, "favoritesCount": 63217, "createdAt": "2020-11-10T18:26:33.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 56800, "retweetCount": 13355, "replyCount": 3126, "quoteCount": 1303, "bookmarkCount": 5534, "viewCount": 15936558, "media": [ { "id": "2007403570675672058", "key": "13_2007403570675672058", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-82683.jpg", "displayUrl": "pic.x.com/wEculUEgkM", "expandedUrl": "https://x.com/sample_user_80582/status/2001570035345337566/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-52800.jpg", "width": 1280, "height": 720, "aspectRatio": [ 16, 9 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 383, "resize": "fit" }, "medium": { "width": 1200, "height": 675, "resize": "fit" }, "large": { "width": 1280, "height": 720, "resize": "fit" }, "original": { "width": 1280, "height": 720, "resize": "fit" } }, "duration": 69, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-92918.jpg" }, { "bitrate": 256000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-14096.jpg" }, { "bitrate": 832000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-11568.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-82683.jpg" } ], "durationMillis": 69400 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_91430" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T19:38:19.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 202300, "retweetCount": 33371, "replyCount": 8489, "quoteCount": 1231, "bookmarkCount": 9345, "viewCount": 14380656, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T23:26:30.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5006608729078501635", "conversationId": "5006608729078501635", "text": "Sample post text 27460 for documentation.", "displayTextRange": [ 0, 67 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5008090808741178646", "conversationId": "5008090808741178646", "text": "Sample post text 51617 for documentation.", "displayTextRange": [ 0, 65 ], "author": { "id": "2001782185964267420", "username": "sample_user_26437", "name": "Sample User 26437", "bio": "Sample profile bio for Sample User 26437.", "location": "Sample City 977", "website": "https://example.com/link-94089/profile-29900/profile-59797", "pinnedTweetIds": [ "2001254681058547323" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-59797.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-59797.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001751835260489657" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4497601, "followingCount": 1023, "tweetCount": 46626, "listedCount": 10678, "mediaCount": 19267, "favoritesCount": 63217, "createdAt": "2020-11-10T18:26:33.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 8920, "retweetCount": 2312, "replyCount": 645, "quoteCount": 214, "bookmarkCount": 771, "viewCount": 7162127, "media": [ { "id": "2009486686233892146", "key": "3_2009486686233892146", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-82395.jpg", "displayUrl": "pic.x.com/bOta7VUY28", "expandedUrl": "https://x.com/sample_user_80582/status/2004281467487414668/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-82395.jpg", "width": 1200, "height": 1687, "aspectRatio": [ 1200, 1687 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 484, "height": 680, "resize": "fit" }, "medium": { "width": 854, "height": 1200, "resize": "fit" }, "large": { "width": 1200, "height": 1687, "resize": "fit" }, "original": { "width": 1200, "height": 1687, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 0, "width": 1200, "height": 672 }, { "x": 0, "y": 0, "width": 1200, "height": 1200 }, { "x": 0, "y": 0, "width": 1200, "height": 1368 }, { "x": 0, "y": 0, "width": 844, "height": 1687 }, { "x": 0, "y": 0, "width": 1200, "height": 1687 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_91430" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T20:40:46.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 103057, "retweetCount": 22760, "replyCount": 7452, "quoteCount": 866, "bookmarkCount": 5184, "viewCount": 6874955, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T23:01:24.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001787444199496782", "conversationId": "5001787444199496782", "text": "Sample post text 91320 for documentation.", "displayTextRange": [ 0, 9 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5001448173797287788", "conversationId": "5001448173797287788", "text": "Sample post text 29360 for documentation.", "displayTextRange": [ 0, 279 ], "author": { "id": "2001820320070453690", "username": "sample_user_06849", "name": "Sample User 06849", "bio": "Sample profile bio for Sample User 06849.", "location": "Sample City 324", "website": "https://example.com/link-94089/profile-29900/profile-31033", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-31033.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-31033.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": "2001783820338157278" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 37746, "followingCount": 1185, "tweetCount": 20965, "listedCount": 201, "mediaCount": 2816, "favoritesCount": 28507, "createdAt": "2024-07-30T15:42:27.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 2444, "retweetCount": 363, "replyCount": 317, "quoteCount": 55, "bookmarkCount": 139, "viewCount": 2551773, "media": [ { "id": "2001065274344671822", "key": "3_2001065274344671822", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-25816.jpg", "displayUrl": "pic.x.com/xhDZrN1DHF", "expandedUrl": "https://x.com/sample_user_39237/status/2006736258355867150/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-25816.jpg", "width": 1152, "height": 707, "aspectRatio": [ 1152, 707 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 417, "resize": "fit" }, "medium": { "width": 1152, "height": 707, "resize": "fit" }, "large": { "width": 1152, "height": 707, "resize": "fit" }, "original": { "width": 1152, "height": 707, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 0, "width": 1152, "height": 645 }, { "x": 223, "y": 0, "width": 707, "height": 707 }, { "x": 266, "y": 0, "width": 620, "height": 707 }, { "x": 399, "y": 0, "width": 354, "height": 707 }, { "x": 0, "y": 0, "width": 1152, "height": 707 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T18:06:41.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 25805, "retweetCount": 3201, "replyCount": 2056, "quoteCount": 152, "bookmarkCount": 678, "viewCount": 2495509, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "pt", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:55:34.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001627600522378982", "conversationId": "5001627600522378982", "text": "Sample post text 75067 for documentation.", "displayTextRange": [ 0, 76 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 786, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_96195" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:53:22.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008653895371084382", "conversationId": "5008653895371084382", "text": "Sample post text 74657 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 1280, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_15129" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:52:58.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001409355181656063", "conversationId": "5001409355181656063", "text": "Sample post text 54223 for documentation.", "displayTextRange": [ 0, 140 ], "author": { "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 11871.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 226995942, "followingCount": 1218, "tweetCount": 86746, "listedCount": 164447, "mediaCount": 4162, "favoritesCount": 174838, "createdAt": "2009-06-02T20:12:29.000Z" }, "source": null, "type": "retweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 5195, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_25934" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T22:52:35.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAAHCgABG2O6ceH__-oLAAIAAAATMTk3MzUyMTI4NDY4NTU3MDA1NggAAwAAAAIAAA", "prevCursor": "DAAHCgABG2O6ceIAJxELAAIAAAATMTk3MzYyNTk0NTQ4MDQyOTYwMggAAwAAAAEAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/following": { "get": { "tags": [ "User" ], "summary": "Following V2", "description": "Get a paginated list of users that the specified account is following. Returns user objects with complete profile information.", "operationId": "getUserFollowing", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "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" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/followers": { "get": { "tags": [ "User" ], "summary": "Followers V2", "description": "Get a paginated list of users following the specified account. Returns user objects with complete profile information.", "operationId": "getUserFollowers", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "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": 15512690, "followingCount": 2296, "tweetCount": 51834, "listedCount": 25067, "mediaCount": 3408, "favoritesCount": 38858, "createdAt": "2009-05-11T21:18:33.000Z" }, { "id": "10010429", "username": "sample_user_75202", "name": "Sample User 75202", "bio": "Sample profile bio for Sample User 75202.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-75202", "pinnedTweetIds": [ "2006545590552064494" ], "avatar": "https://example.com/images/sample-avatar-75202.jpg", "banner": "https://example.com/images/sample-banner-75202.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": "9001689989477935742" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 3438694, "followingCount": 3593, "tweetCount": 60215, "listedCount": 4525, "mediaCount": 3761, "favoritesCount": 14449, "createdAt": "2009-01-03T19:24:16.000Z" }, { "id": "1004932249", "username": "sample_user_00177", "name": "Sample User 00177", "bio": "Sample profile bio for Sample User 00177.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-00177", "pinnedTweetIds": [ "2007590767998597953" ], "avatar": "https://example.com/images/sample-avatar-00177.jpg", "banner": "https://example.com/images/sample-banner-00177.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001009602696335894" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 5040478, "followingCount": 10, "tweetCount": 33467, "listedCount": 8413, "mediaCount": 16291, "favoritesCount": 1865, "createdAt": "2016-02-15T16:05:21.000Z" }, { "id": "10014087", "username": "sample_user_22227", "name": "Sample User 22227", "bio": "Sample profile bio for Sample User 22227.", "location": "Sample City 585", "website": "https://example.com/link-94089/profile-22227", "pinnedTweetIds": [ "2004151465091274884" ], "avatar": "https://example.com/images/sample-avatar-22227.jpg", "banner": "https://example.com/images/sample-banner-22227.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": "Government", "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": { "label": { "url": { "url": "https://x.com/sample_user_40733", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-18210.jpg" }, "description": "Sample description for documentation 18045.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 6541864, "followingCount": 3650, "tweetCount": 16020, "listedCount": 11755, "mediaCount": 2118, "favoritesCount": 5369, "createdAt": "2008-12-16T17:20:24.000Z" }, { "id": "100144151", "username": "sample_user_40864", "name": "Sample User 40864", "bio": "", "location": null, "website": "https://example.com/link-94089/profile-40864", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-40864.jpg", "banner": "https://example.com/images/sample-banner-40864.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": 7181703, "followingCount": 2309, "tweetCount": 50280, "listedCount": 11455, "mediaCount": 1819, "favoritesCount": 70535, "createdAt": "2011-01-01T17:50:03.000Z" }, { "id": "100112199", "username": "sample_user_23211", "name": "Sample User 23211", "bio": "Sample profile bio for Sample User 23211.", "location": "Sample City 337", "website": "https://example.com/link-94089/profile-23211", "pinnedTweetIds": [ "2001783813960580691" ], "avatar": "https://example.com/images/sample-avatar-23211.jpg", "banner": "https://example.com/images/sample-banner-23211.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": 4429648, "followingCount": 594, "tweetCount": 3918, "listedCount": 12475, "mediaCount": 1211, "favoritesCount": 8132, "createdAt": "2011-12-03T03:06:19.000Z" }, { "id": "1006229070126670670", "username": "sample_user_46095", "name": "Sample User 46095", "bio": "Sample profile bio for Sample User 46095.", "location": "Sample City 643", "website": "https://example.com/link-94089/profile-46095", "pinnedTweetIds": [ "2002879484214916989" ], "avatar": "https://example.com/images/sample-avatar-46095.jpg", "banner": "https://example.com/images/sample-banner-46095.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": "9006389953237489813" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4874823, "followingCount": 1877, "tweetCount": 10968, "listedCount": 5886, "mediaCount": 1184, "favoritesCount": 9536, "createdAt": "2019-12-03T01:14:36.000Z" }, { "id": "10016591", "username": "sample_user_31804", "name": "Sample User 31804", "bio": "Sample profile bio for Sample User 31804.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-31804", "pinnedTweetIds": [ "2006194732330529009" ], "avatar": "https://example.com/images/sample-avatar-31804.jpg", "banner": "https://example.com/images/sample-banner-31804.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": "9002465772715329062" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 5245710, "followingCount": 9666, "tweetCount": 165767, "listedCount": 10258, "mediaCount": 15864, "favoritesCount": 22989, "createdAt": "2009-11-22T22:32:41.000Z" }, { "id": "1001548256123191814", "username": "sample_user_92818", "name": "Sample User 92818", "bio": "Sample profile bio for Sample User 92818.", "location": "Sample City 528", "website": "https://example.com/link-94089/profile-92818", "pinnedTweetIds": [ "2001174341840129479" ], "avatar": "https://example.com/images/sample-avatar-92818.jpg", "banner": "https://example.com/images/sample-banner-92818.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": "Government", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9001378932804071680" }, "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_40733", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-18210.jpg" }, "description": "Sample description for documentation 18045.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 5108609, "followingCount": 753, "tweetCount": 9191, "listedCount": 7851, "mediaCount": 2884, "favoritesCount": 6121, "createdAt": "2020-12-30T18:57:01.000Z" }, { "id": "10074112", "username": "sample_user_51514", "name": "Sample User 51514", "bio": "Sample profile bio for Sample User 51514.", "location": null, "website": "https://example.com/link-94089/profile-51514", "pinnedTweetIds": [ "2007954673942832888" ], "avatar": "https://example.com/images/sample-avatar-51514.jpg", "banner": "https://example.com/images/sample-banner-51514.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": 7959185, "followingCount": 484, "tweetCount": 204605, "listedCount": 18742, "mediaCount": 8575, "favoritesCount": 50, "createdAt": "2008-12-09T16:40:22.000Z" }, { "id": "10016309", "username": "sample_user_59576", "name": "Sample User 59576", "bio": "Sample profile bio for Sample User 59576.", "location": "Sample City 250", "website": "https://example.com/link-94089/profile-59576", "pinnedTweetIds": [ "2004025342157136961" ], "avatar": "https://example.com/images/sample-avatar-59576.jpg", "banner": "https://example.com/images/sample-banner-59576.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [], "restId": "9001494270842127833" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 40112583, "followingCount": 120, "tweetCount": 10696, "listedCount": 43663, "mediaCount": 4130, "favoritesCount": 504, "createdAt": "2009-04-23T21:53:30.000Z" }, { "id": "10015960", "username": "sample_user_28571", "name": "Sample User 28571", "bio": "Sample profile bio for Sample User 28571.", "location": "Sample City 982", "website": "https://example.com/link-94089/profile-28571", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-28571.jpg", "banner": "https://example.com/images/sample-banner-28571.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": 948, "name": "Actor", "icon_name": "IconBriefcaseStroke" } ], "restId": "9007736652300020868" }, "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_69268", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-50434.jpg" }, "description": "Sample description for documentation 68894.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 2556162, "followingCount": 612, "tweetCount": 26270, "listedCount": 4198, "mediaCount": 2713, "favoritesCount": 13810, "createdAt": "2009-04-20T18:21:04.000Z" }, { "id": "1002989103939089142", "username": "sample_user_00560", "name": "Sample User 00560", "bio": "Sample profile bio for Sample User 00560.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-00560", "pinnedTweetIds": [ "2001051649036143321" ], "avatar": "https://example.com/images/sample-avatar-00560.jpg", "banner": "https://example.com/images/sample-banner-00560.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [], "restId": "9005958866210894823" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 1598876, "followingCount": 845, "tweetCount": 4132, "listedCount": 1400, "mediaCount": 464, "favoritesCount": 3171, "createdAt": "2021-12-06T19:00:41.000Z" }, { "id": "10011567", "username": "sample_user_46742", "name": "Sample User 46742", "bio": "Sample profile bio for Sample User 46742.", "location": "Sample City 865", "website": "https://example.com/link-94089/profile-46742", "pinnedTweetIds": [ "2001611966223933842" ], "avatar": "https://example.com/images/sample-avatar-46742.jpg", "banner": "https://example.com/images/sample-banner-46742.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": "9001155013850626954" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 3205171, "followingCount": 4916, "tweetCount": 93017, "listedCount": 6613, "mediaCount": 10529, "favoritesCount": 4817, "createdAt": "2008-12-20T14:32:44.000Z" }, { "id": "100144217", "username": "sample_user_66108", "name": "Sample User 66108", "bio": "Sample profile bio for Sample User 66108.", "location": "Sample City 458", "website": "https://example.com/link-94089/profile-66108", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-66108.jpg", "banner": "https://example.com/images/sample-banner-66108.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": "Government", "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": 6016243, "followingCount": 807, "tweetCount": 19781, "listedCount": 17097, "mediaCount": 3806, "favoritesCount": 931, "createdAt": "2010-11-17T23:52:35.000Z" }, { "id": "10016794", "username": "sample_user_45834", "name": "Sample User 45834", "bio": "Sample profile bio for Sample User 45834.", "location": "Sample City 713", "website": "https://example.com/link-94089/profile-45834", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-45834.jpg", "banner": "https://example.com/images/sample-banner-45834.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": true, "verifiedType": "Government", "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": 7099875, "followingCount": 5391, "tweetCount": 55872, "listedCount": 17947, "mediaCount": 8875, "favoritesCount": 1404, "createdAt": "2009-03-06T03:20:20.000Z" }, { "id": "10020623", "username": "sample_user_11511", "name": "Sample User 11511", "bio": "Sample profile bio for Sample User 11511.", "location": null, "website": "https://example.com/link-94089/profile-11511", "pinnedTweetIds": [ "2001162637645088719" ], "avatar": "https://example.com/images/sample-avatar-11511.jpg", "banner": "https://example.com/images/sample-banner-11511.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [], "restId": "9001114828117980887" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 24406674, "followingCount": 74, "tweetCount": 9821, "listedCount": 27631, "mediaCount": 1873, "favoritesCount": 7252, "createdAt": "2008-02-10T01:12:32.000Z" }, { "id": "100105043", "username": "sample_user_17189", "name": "Sample User 17189", "bio": "Sample profile bio for Sample User 17189.", "location": null, "website": "https://example.com/link-94089/profile-17189", "pinnedTweetIds": [ "2001667962071639630" ], "avatar": "https://example.com/images/sample-avatar-17189.jpg", "banner": "https://example.com/images/sample-banner-17189.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": 4043522, "followingCount": 2799, "tweetCount": 25926, "listedCount": 7482, "mediaCount": 2709, "favoritesCount": 20118, "createdAt": "2011-02-28T23:33:33.000Z" }, { "id": "10013697", "username": "sample_user_79990", "name": "Sample User 79990", "bio": "Sample profile bio for Sample User 79990.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-79990", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-79990.jpg", "banner": "https://example.com/images/sample-banner-79990.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "9009218663398184829" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 3539186, "followingCount": 805, "tweetCount": 245972, "listedCount": 8221, "mediaCount": 71341, "favoritesCount": 7635, "createdAt": "2009-02-10T21:04:49.000Z" }, { "id": "1001249435810977399", "username": "sample_user_35031", "name": "Sample User 35031", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-35031.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 10, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:12.000Z" }, { "id": "1001030260530582432", "username": "sample_user_90243", "name": "Sample User 90243", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-90243.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:55.000Z" }, { "id": "1002141922283036154", "username": "sample_user_49438", "name": "Sample User 49438", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-49438.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 38, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:01.000Z" }, { "id": "1001734135992073809", "username": "sample_user_04963", "name": "Sample User 04963", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-04963.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 4, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:15.000Z" }, { "id": "1003357192855335205", "username": "sample_user_35740", "name": "Sample User 35740", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-35740.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 10, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:43:44.000Z" }, { "id": "1001264721456342129", "username": "sample_user_55655", "name": "Sample User 55655", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-55655.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:39.000Z" }, { "id": "1007572344033247128", "username": "sample_user_48565", "name": "Sample User 48565", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-48565.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:39:19.000Z" }, { "id": "1001263060873742513", "username": "sample_user_58811", "name": "Sample User 58811", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-58811.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:16.000Z" }, { "id": "1001641940312141882", "username": "sample_user_78764", "name": "Sample User 78764", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-78764.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:55.000Z" }, { "id": "1001436023907571535", "username": "sample_user_64783", "name": "Sample User 64783", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-64783.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:17.000Z" }, { "id": "1001181706774722711", "username": "sample_user_78523", "name": "Sample User 78523", "bio": "", "location": null, "website": null, "pinnedTweetIds": [ "2003567571374084562" ], "avatar": "https://example.com/images/sample-avatar-78523.jpg", "banner": "https://example.com/images/sample-banner-78523.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": 139, "followingCount": 196, "tweetCount": 5822, "listedCount": 0, "mediaCount": 684, "favoritesCount": 3974, "createdAt": "2022-07-03T01:40:27.000Z" }, { "id": "1006081864165875172", "username": "sample_user_26974", "name": "Sample User 26974", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-26974.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 6, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:40.000Z" }, { "id": "1001816171870390383", "username": "sample_user_70646", "name": "Sample User 70646", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-70646.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 3, "listedCount": 0, "mediaCount": 1, "favoritesCount": 0, "createdAt": "2025-09-30T23:23:48.000Z" }, { "id": "1005710242145459013", "username": "sample_user_79735", "name": "Sample User 79735", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-79735.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 2, "followingCount": 21, "tweetCount": 35, "listedCount": 0, "mediaCount": 6, "favoritesCount": 1, "createdAt": "2025-09-22T21:19:33.000Z" }, { "id": "1001014325068222241", "username": "sample_user_49858", "name": "Sample User 49858", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-49858.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:44:12.000Z" }, { "id": "1002401412045303570", "username": "sample_user_87486", "name": "Sample User 87486", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-87486.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:38:51.000Z" }, { "id": "1001144693125879907", "username": "sample_user_90132", "name": "Sample User 90132", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-90132.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:24.000Z" }, { "id": "1001649137738729766", "username": "sample_user_67682", "name": "Sample User 67682", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-67682.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:00.000Z" }, { "id": "1005236872335573473", "username": "sample_user_85303", "name": "Sample User 85303", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-85303.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:44:52.000Z" }, { "id": "1001031337965437915", "username": "sample_user_51551", "name": "Sample User 51551", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-51551.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:08.000Z" }, { "id": "1006456970312706957", "username": "sample_user_62588", "name": "Sample User 62588", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-62588.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:58.000Z" }, { "id": "1001239314081425955", "username": "sample_user_71346", "name": "Sample User 71346", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-71346.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:48.000Z" }, { "id": "1007419157108831232", "username": "sample_user_09574", "name": "Sample User 09574", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-09574.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:42:34.000Z" }, { "id": "1007055376029644621", "username": "sample_user_58779", "name": "Sample User 58779", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-58779.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 53, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:42:51.000Z" }, { "id": "1003802609446540557", "username": "sample_user_90858", "name": "Sample User 90858", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-90858.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:02.000Z" }, { "id": "1009441998763470966", "username": "sample_user_89742", "name": "Sample User 89742", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-89742.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 2, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:05.000Z" }, { "id": "1004681201792597055", "username": "sample_user_70666", "name": "Sample User 70666", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-70666.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 2, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:48.000Z" }, { "id": "1001390251380208370", "username": "sample_user_22589", "name": "Sample User 22589", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-22589.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:06.000Z" }, { "id": "1001740156743096541", "username": "sample_user_80465", "name": "Sample User 80465", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-80465.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:03.000Z" }, { "id": "1003174543253897950", "username": "sample_user_08398", "name": "Sample User 08398", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-08398.jpg", "banner": "https://example.com/images/sample-banner-08398.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": 9, "followingCount": 36, "tweetCount": 1148, "listedCount": 0, "mediaCount": 2, "favoritesCount": 912, "createdAt": "2021-08-21T12:43:06.000Z" }, { "id": "1001776127300175876", "username": "sample_user_65653", "name": "Sample User 65653", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-65653.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 4, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:42.000Z" }, { "id": "1009837791731795920", "username": "sample_user_41160", "name": "Sample User 41160", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-41160.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 4, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:59.000Z" }, { "id": "1001794935278552965", "username": "sample_user_56515", "name": "Sample User 56515", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-56515.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:58.000Z" }, { "id": "1001078804231565032", "username": "sample_user_64647", "name": "Sample User 64647", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-64647.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:38.000Z" }, { "id": "1002330369510848052", "username": "sample_user_30114", "name": "Sample User 30114", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-30114.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:00.000Z" }, { "id": "1001673843194239529", "username": "sample_user_84396", "name": "Sample User 84396", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-84396.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 5, "tweetCount": 8, "listedCount": 0, "mediaCount": 0, "favoritesCount": 3, "createdAt": "2025-10-01T06:57:27.000Z" }, { "id": "1002282341290672612", "username": "sample_user_76576", "name": "Sample User 76576", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-76576.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 2, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:44:30.000Z" }, { "id": "1001221810168893636", "username": "sample_user_28815", "name": "Sample User 28815", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-28815.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:44:12.000Z" }, { "id": "1001646989759182116", "username": "sample_user_92943", "name": "Sample User 92943", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-92943.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:43:26.000Z" }, { "id": "1001277423649231946", "username": "sample_user_20299", "name": "Sample User 20299", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-20299.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:45.000Z" }, { "id": "1007754786203296009", "username": "sample_user_66809", "name": "Sample User 66809", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-66809.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:42.000Z" }, { "id": "1001423456923195614", "username": "sample_user_03599", "name": "Sample User 03599", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-03599.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 17, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:34.000Z" }, { "id": "1003170623373202317", "username": "sample_user_57485", "name": "Sample User 57485", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-57485.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 8, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:53.000Z" }, { "id": "1004454400193229455", "username": "sample_user_38749", "name": "Sample User 38749", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-38749.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 10, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:56.000Z" }, { "id": "100199442", "username": "sample_user_82110", "name": "Sample User 82110", "bio": "", "location": "Sample City 720", "website": "https://example.com/link-94089/profile-82110", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-82110.jpg", "banner": "https://example.com/images/sample-banner-82110.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 48, "followingCount": 84, "tweetCount": 230, "listedCount": 0, "mediaCount": 2, "favoritesCount": 100, "createdAt": "2010-06-22T09:13:35.000Z" }, { "id": "1003738881993176535", "username": "sample_user_51740", "name": "Sample User 51740", "bio": "Sample profile bio for Sample User 51740.", "location": "Sample City 012", "website": null, "pinnedTweetIds": [ "2008685407130212701" ], "avatar": "https://example.com/images/sample-avatar-51740.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "possiblySensitive": true, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 5, "followingCount": 67, "tweetCount": 89, "listedCount": 0, "mediaCount": 2, "favoritesCount": 4988, "createdAt": "2020-08-04T10:55:41.000Z" }, { "id": "1001755153231446456", "username": "sample_user_11318", "name": "Sample User 11318", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-11318.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:44.000Z" }, { "id": "1006802469595229900", "username": "sample_user_56826", "name": "Sample User 56826", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-56826.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:57.000Z" }, { "id": "1001531807979269984", "username": "sample_user_99897", "name": "Sample User 99897", "bio": "Sample profile bio for Sample User 99897.", "location": "Sample City 785", "website": null, "pinnedTweetIds": [ "2001630704832715508" ], "avatar": "https://example.com/images/sample-avatar-99897.jpg", "banner": "https://example.com/images/sample-banner-99897.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 205, "followingCount": 1355, "tweetCount": 2809, "listedCount": 1, "mediaCount": 123, "favoritesCount": 9120, "createdAt": "2025-02-26T06:34:23.000Z" }, { "id": "1001379445001713966", "username": "sample_user_79150", "name": "Sample User 79150", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-79150.jpg", "banner": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:27.000Z" } ], "pagination": { "nextCursor": "1844847872833209866|1973625928105852856", "prevCursor": "-1|1973625928105852929" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/verified-followers": { "get": { "tags": [ "User" ], "summary": "Verified Followers", "description": "Get a paginated list of users following the specified account. Returns user objects with complete profile information.", "operationId": "getUserVerifiedFollowers", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "1001713320106723297", "username": "sample_user_21518", "name": "Sample User 21518", "bio": "Sample profile bio for Sample User 21518.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-21518.jpg", "banner": "https://example.com/images/sample-banner-21518.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4900, "followingCount": 384, "tweetCount": 107, "listedCount": 1, "mediaCount": 0, "favoritesCount": 11080, "createdAt": "2025-02-12T19:37:11.000Z" }, { "id": "1005541600", "username": "sample_user_05058", "name": "Sample User 05058", "bio": "", "location": "Sample City 389", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-05058.jpg", "banner": "https://example.com/images/sample-banner-05058.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 17, "tweetCount": 17, "listedCount": 1, "mediaCount": 6, "favoritesCount": 4, "createdAt": "2014-12-09T13:15:59.000Z" }, { "id": "1001159653076102305", "username": "sample_user_46070", "name": "Sample User 46070", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-46070.jpg", "banner": "https://example.com/images/sample-banner-46070.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4, "followingCount": 70, "tweetCount": 5, "listedCount": 0, "mediaCount": 1, "favoritesCount": 755, "createdAt": "2025-07-09T02:34:22.000Z" }, { "id": "1006431666924098552", "username": "sample_user_98121", "name": "Sample User 98121", "bio": "Sample profile bio for Sample User 98121.", "location": "Sample City 810", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-98121.jpg", "banner": "https://example.com/images/sample-banner-98121.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 154, "followingCount": 517, "tweetCount": 829, "listedCount": 1, "mediaCount": 241, "favoritesCount": 4253, "createdAt": "2024-06-29T16:07:39.000Z" }, { "id": "1008112084157992525", "username": "sample_user_87597", "name": "Sample User 87597", "bio": "Sample profile bio for Sample User 87597.", "location": "Sample City 764", "website": "https://example.com/link-94089/profile-87597", "pinnedTweetIds": [ "2006744983960340592" ], "avatar": "https://example.com/images/sample-avatar-87597.jpg", "banner": "https://example.com/images/sample-banner-87597.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": 15, "name": "Entertainment & Recreation", "icon_name": "IconBriefcaseStroke" } ], "restId": "9003845886837926035" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 2025, "followingCount": 7504, "tweetCount": 488, "listedCount": 0, "mediaCount": 71, "favoritesCount": 124, "createdAt": "2024-10-26T14:16:17.000Z" }, { "id": "1007437453187209954", "username": "sample_user_44704", "name": "Sample User 44704", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-44704.jpg", "banner": "https://example.com/images/sample-banner-44704.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4, "followingCount": 21, "tweetCount": 8, "listedCount": 0, "mediaCount": 0, "favoritesCount": 66, "createdAt": "2025-05-22T10:50:16.000Z" }, { "id": "1003504435597926134", "username": "sample_user_71017", "name": "Sample User 71017", "bio": "Sample profile bio for Sample User 71017.", "location": "Sample City 295", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-71017.jpg", "banner": null, "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": {}, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 3, "followingCount": 32, "tweetCount": 34, "listedCount": 0, "mediaCount": 0, "favoritesCount": 56, "createdAt": "2024-12-22T02:27:51.000Z" }, { "id": "100114970", "username": "sample_user_41921", "name": "Sample User 41921", "bio": "Sample profile bio for Sample User 41921.", "location": "Sample City 298", "website": "https://example.com/link-94089/profile-41921", "pinnedTweetIds": [ "2003693104053158328" ], "avatar": "https://example.com/images/sample-avatar-41921.jpg", "banner": "https://example.com/images/sample-banner-41921.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": 220, "followingCount": 61, "tweetCount": 883, "listedCount": 0, "mediaCount": 274, "favoritesCount": 305, "createdAt": "2012-02-14T05:48:26.000Z" }, { "id": "1001512754161316710", "username": "sample_user_07457", "name": "Sample User 07457", "bio": "Sample profile bio for Sample User 07457.", "location": "Sample City 306", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-07457.jpg", "banner": "https://example.com/images/sample-banner-07457.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 17, "followingCount": 15, "tweetCount": 329, "listedCount": 0, "mediaCount": 7, "favoritesCount": 2173, "createdAt": "2024-01-31T04:50:20.000Z" }, { "id": "1009005475322848232", "username": "sample_user_27016", "name": "Sample User 27016", "bio": "Sample profile bio for Sample User 27016.", "location": "Sample City 520", "website": null, "pinnedTweetIds": [ "2004358803948291087" ], "avatar": "https://example.com/images/sample-avatar-27016.jpg", "banner": "https://example.com/images/sample-banner-27016.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": 760, "followingCount": 494, "tweetCount": 5620, "listedCount": 1, "mediaCount": 362, "favoritesCount": 12591, "createdAt": "2022-10-05T04:08:18.000Z" }, { "id": "1001004664", "username": "sample_user_67013", "name": "Sample User 67013", "bio": "Sample profile bio for Sample User 67013.", "location": null, "website": null, "pinnedTweetIds": [ "2001415854033023957" ], "avatar": "https://example.com/images/sample-avatar-67013.jpg", "banner": "https://example.com/images/sample-banner-67013.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": "9001019078689295634" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4022, "followingCount": 4786, "tweetCount": 9063, "listedCount": 1, "mediaCount": 2068, "favoritesCount": 3743, "createdAt": "2014-12-19T16:53:55.000Z" }, { "id": "1001431559329076444", "username": "sample_user_01550", "name": "Sample User 01550", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-01550.jpg", "banner": null, "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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-09-18T22:29:59.000Z" }, { "id": "1001848158580427622", "username": "sample_user_82436", "name": "Sample User 82436", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-82436.jpg", "banner": null, "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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 3, "followingCount": 65, "tweetCount": 46, "listedCount": 0, "mediaCount": 2, "favoritesCount": 36, "createdAt": "2022-12-01T19:37:11.000Z" }, { "id": "1009866220216062559", "username": "sample_user_08860", "name": "Sample User 08860", "bio": "Sample profile bio for Sample User 08860.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-08860.jpg", "banner": null, "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": "9005377951609635487" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 12, "followingCount": 367, "tweetCount": 5, "listedCount": 0, "mediaCount": 0, "favoritesCount": 11295, "createdAt": "2022-04-25T23:42:15.000Z" }, { "id": "1005476130358153018", "username": "sample_user_76007", "name": "Sample User 76007", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-76007.jpg", "banner": "https://example.com/images/sample-banner-76007.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-01T22:47:35.000Z" }, { "id": "1005954664164441903", "username": "sample_user_28845", "name": "Sample User 28845", "bio": "Sample profile bio for Sample User 28845.", "location": "Sample City 701", "website": "https://example.com/link-94089/profile-28845", "pinnedTweetIds": [ "2001741681963383019" ], "avatar": "https://example.com/images/sample-avatar-28845.jpg", "banner": "https://example.com/images/sample-banner-28845.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": 579, "name": "Media & News", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001778843899253183" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 242, "followingCount": 49, "tweetCount": 2107, "listedCount": 0, "mediaCount": 106, "favoritesCount": 1956, "createdAt": "2022-10-29T02:39:55.000Z" }, { "id": "1001034483566559862", "username": "sample_user_31142", "name": "Sample User 31142", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-31142.jpg", "banner": "https://example.com/images/sample-banner-31142.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 307, "followingCount": 175, "tweetCount": 5084, "listedCount": 0, "mediaCount": 8, "favoritesCount": 36, "createdAt": "2022-06-12T20:31:06.000Z" }, { "id": "1003219499747609575", "username": "sample_user_90612", "name": "Sample User 90612", "bio": "Sample profile bio for Sample User 90612.", "location": null, "website": null, "pinnedTweetIds": [ "2001239758542508168" ], "avatar": "https://example.com/images/sample-avatar-90612.jpg", "banner": "https://example.com/images/sample-banner-90612.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": 189, "followingCount": 577, "tweetCount": 841, "listedCount": 1, "mediaCount": 85, "favoritesCount": 19967, "createdAt": "2019-07-25T12:50:21.000Z" }, { "id": "1001839478048852946", "username": "sample_user_33434", "name": "Sample User 33434", "bio": "Sample profile bio for Sample User 33434.", "location": "Sample City 120", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-33434.jpg", "banner": "https://example.com/images/sample-banner-33434.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 55, "followingCount": 76, "tweetCount": 6, "listedCount": 1, "mediaCount": 2, "favoritesCount": 10, "createdAt": "2025-10-01T20:15:59.000Z" }, { "id": "100335586", "username": "sample_user_03404", "name": "Sample User 03404", "bio": "", "location": "Sample City 530", "website": null, "pinnedTweetIds": [ "2001785609217021530" ], "avatar": "https://example.com/images/sample-avatar-03404.jpg", "banner": "https://example.com/images/sample-banner-03404.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": 621, "followingCount": 1565, "tweetCount": 8864, "listedCount": 7, "mediaCount": 771, "favoritesCount": 7320, "createdAt": "2011-05-23T06:20:43.000Z" } ], "pagination": { "nextCursor": "1844847424876541634|1973626000210132970", "prevCursor": "-1|1973626000210132993" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/subscriptions": { "get": { "tags": [ "User" ], "summary": "Subscriptions", "description": "Get a list of accounts that the user has subscribed to. Includes Premium subscribers and Super Followers.", "operationId": "getUserSubscriptions", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "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" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/following-list": { "get": { "tags": [ "User" ], "summary": "Following V1", "description": "Get a paginated list of users that the specified account is following. Returns user objects with complete profile information.", "operationId": "getUserFollowingList", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "10088980", "username": "sample_user_55298", "name": "Sample User 55298", "bio": "Sample profile bio for Sample User 55298.", "location": "Sample City 504", "website": "https://example.com/link-94089/profile-55298", "pinnedTweetIds": [ "2005446137938324206" ], "avatar": "https://example.com/images/sample-avatar-55298.jpg", "banner": "https://example.com/images/sample-banner-55298.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 882232, "followingCount": 52, "tweetCount": 24311, "listedCount": 12649, "mediaCount": 1715, "favoritesCount": 9008, "createdAt": "2009-08-11T22:26:28.000Z" }, { "id": "100788754", "username": "sample_user_35446", "name": "Sample User 35446", "bio": "Sample profile bio for Sample User 35446.", "location": "Sample City 801", "website": "https://example.com/link-94089/profile-35446", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-35446.jpg", "banner": "https://example.com/images/sample-banner-35446.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 78373, "followingCount": 177, "tweetCount": 12681, "listedCount": 915, "mediaCount": 5987, "favoritesCount": 2370, "createdAt": "2010-03-11T08:04:25.000Z" }, { "id": "1001725635885283840", "username": "sample_user_70117", "name": "Sample User 70117", "bio": "Sample profile bio for Sample User 70117.", "location": null, "website": null, "pinnedTweetIds": [ "2001552369583120801" ], "avatar": "https://example.com/images/sample-avatar-70117.jpg", "banner": "https://example.com/images/sample-banner-70117.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 7318, "followingCount": 4, "tweetCount": 9, "listedCount": 9, "mediaCount": 2, "favoritesCount": 7, "createdAt": "2025-06-23T20:55:27.000Z" }, { "id": "1007279781545554210", "username": "sample_user_12074", "name": "Sample User 12074", "bio": "Sample profile bio for Sample User 12074.", "location": "Sample City 865", "website": "https://example.com/link-94089/profile-12074", "pinnedTweetIds": [ "2001539123604070045" ], "avatar": "https://example.com/images/sample-avatar-12074.jpg", "banner": "https://example.com/images/sample-banner-12074.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 17708, "followingCount": 41, "tweetCount": 284, "listedCount": 170, "mediaCount": 56, "favoritesCount": 190, "createdAt": "2025-03-24T12:15:30.000Z" }, { "id": "100849850", "username": "sample_user_25605", "name": "Sample User 25605", "bio": "Sample profile bio for Sample User 25605.", "location": "Sample City 074", "website": "https://example.com/link-94089/profile-25605", "pinnedTweetIds": [ "2006029887141122174" ], "avatar": "https://example.com/images/sample-avatar-25605.jpg", "banner": "https://example.com/images/sample-banner-25605.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 1463768, "followingCount": 1849, "tweetCount": 34795, "listedCount": 3214, "mediaCount": 11505, "favoritesCount": 20302, "createdAt": "2012-02-13T23:15:31.000Z" }, { "id": "10081545", "username": "sample_user_07151", "name": "Sample User 07151", "bio": "Sample profile bio for Sample User 07151.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-07151", "pinnedTweetIds": [ "2001322811109515935" ], "avatar": "https://example.com/images/sample-avatar-07151.jpg", "banner": "https://example.com/images/sample-banner-07151.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 2424430, "followingCount": 1432, "tweetCount": 15150, "listedCount": 3441, "mediaCount": 4817, "favoritesCount": 6035, "createdAt": "2009-06-15T08:46:13.000Z" }, { "id": "1007949731", "username": "sample_user_67980", "name": "Sample User 67980", "bio": "Sample profile bio for Sample User 67980.", "location": "Sample City 459", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-67980.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 6162, "followingCount": 307, "tweetCount": 272, "listedCount": 62, "mediaCount": 14, "favoritesCount": 874, "createdAt": "2013-12-30T15:53:37.000Z" }, { "id": "1003792412575786288", "username": "sample_user_01062", "name": "Sample User 01062", "bio": "Sample profile bio for Sample User 01062.", "location": "Sample City 865", "website": "https://example.com/link-94089/profile-01062", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-01062.jpg", "banner": "https://example.com/images/sample-banner-01062.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 1041639, "followingCount": 9, "tweetCount": 312, "listedCount": 2327, "mediaCount": 136, "favoritesCount": 4, "createdAt": "2025-02-03T21:47:12.000Z" }, { "id": "1001361025", "username": "sample_user_07467", "name": "Sample User 07467", "bio": "Sample profile bio for Sample User 07467.", "location": "Sample City 459", "website": "https://example.com/link-94089/profile-07467", "pinnedTweetIds": [ "2001285777487951785" ], "avatar": "https://example.com/images/sample-avatar-07467.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 53947, "followingCount": 696, "tweetCount": 2555, "listedCount": 1002, "mediaCount": 202, "favoritesCount": 4450, "createdAt": "2013-06-23T12:57:08.000Z" }, { "id": "1001359723661677634", "username": "sample_user_47769", "name": "Sample User 47769", "bio": "Sample profile bio for Sample User 47769.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-47769.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 750, "followingCount": 22, "tweetCount": 0, "listedCount": 5, "mediaCount": 0, "favoritesCount": 11, "createdAt": "2021-03-28T19:16:07.000Z" }, { "id": "1005427224324788504", "username": "sample_user_05872", "name": "Sample User 05872", "bio": "Sample profile bio for Sample User 05872.", "location": "Sample City 750", "website": "https://example.com/link-94089/profile-05872", "pinnedTweetIds": [ "2004387363993367112" ], "avatar": "https://example.com/images/sample-avatar-05872.jpg", "banner": "https://example.com/images/sample-banner-05872.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 16545, "followingCount": 21, "tweetCount": 254, "listedCount": 108, "mediaCount": 111, "favoritesCount": 63, "createdAt": "2023-07-06T10:46:17.000Z" }, { "id": "1005612830", "username": "sample_user_23717", "name": "Sample User 23717", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-23717.jpg", "banner": "https://example.com/images/sample-banner-23717.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 846, "followingCount": 90, "tweetCount": 10, "listedCount": 6, "mediaCount": 0, "favoritesCount": 125, "createdAt": "2013-02-13T05:14:04.000Z" }, { "id": "1001004927889873081", "username": "sample_user_67755", "name": "Sample User 67755", "bio": "Sample profile bio for Sample User 67755.", "location": null, "website": null, "pinnedTweetIds": [ "2009520019288498853" ], "avatar": "https://example.com/images/sample-avatar-67755.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 32070, "followingCount": 511, "tweetCount": 21234, "listedCount": 255, "mediaCount": 1873, "favoritesCount": 62726, "createdAt": "2023-08-25T17:30:19.000Z" }, { "id": "1001826983839195269", "username": "sample_user_67343", "name": "Sample User 67343", "bio": "Sample profile bio for Sample User 67343.", "location": "Sample City 865", "website": "https://example.com/link-94089/profile-67343", "pinnedTweetIds": [ "2001772829598333837" ], "avatar": "https://example.com/images/sample-avatar-67343.jpg", "banner": "https://example.com/images/sample-banner-67343.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 413765, "followingCount": 69, "tweetCount": 11241, "listedCount": 823, "mediaCount": 2274, "favoritesCount": 18949, "createdAt": "2022-04-29T20:22:48.000Z" }, { "id": "1001140180846719767", "username": "sample_user_05353", "name": "Sample User 05353", "bio": "Sample profile bio for Sample User 05353.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-05353.jpg", "banner": "https://example.com/images/sample-banner-05353.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 905417, "followingCount": 25, "tweetCount": 54, "listedCount": 507, "mediaCount": 0, "favoritesCount": 16, "createdAt": "2021-06-17T06:26:36.000Z" }, { "id": "1004724182165837366", "username": "sample_user_15502", "name": "Sample User 15502", "bio": "Sample profile bio for Sample User 15502.", "location": "Sample City 542", "website": "https://example.com/link-94089/profile-15502", "pinnedTweetIds": [ "2004684196523002385" ], "avatar": "https://example.com/images/sample-avatar-15502.jpg", "banner": "https://example.com/images/sample-banner-15502.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 260056, "followingCount": 1205, "tweetCount": 13375, "listedCount": 620, "mediaCount": 6059, "favoritesCount": 7363, "createdAt": "2018-12-12T01:13:08.000Z" }, { "id": "1001910612794548107", "username": "sample_user_44632", "name": "Sample User 44632", "bio": "Sample profile bio for Sample User 44632.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-44632.jpg", "banner": "https://example.com/images/sample-banner-44632.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 11135, "followingCount": 36, "tweetCount": 9, "listedCount": 51, "mediaCount": 7, "favoritesCount": 5, "createdAt": "2022-07-17T02:04:40.000Z" }, { "id": "10016059", "username": "sample_user_10693", "name": "Sample User 10693", "bio": "Sample profile bio for Sample User 10693.", "location": null, "website": "https://example.com/link-94089/profile-10693", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-10693.jpg", "banner": "https://example.com/images/sample-banner-10693.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 10941122, "followingCount": 1386, "tweetCount": 8997, "listedCount": 19161, "mediaCount": 1538, "favoritesCount": 1311, "createdAt": "2009-06-22T08:24:19.000Z" }, { "id": "10051246", "username": "sample_user_35585", "name": "Sample User 35585", "bio": "Sample profile bio for Sample User 35585.", "location": "Sample City 147", "website": null, "pinnedTweetIds": [ "2001184043341139638" ], "avatar": "https://example.com/images/sample-avatar-35585.jpg", "banner": "https://example.com/images/sample-banner-35585.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 672408, "followingCount": 3478, "tweetCount": 267584, "listedCount": 4978, "mediaCount": 15841, "favoritesCount": 96203, "createdAt": "2007-06-25T21:03:36.000Z" }, { "id": "100334094", "username": "sample_user_73770", "name": "Sample User 73770", "bio": "Sample profile bio for Sample User 73770.", "location": "Sample City 698", "website": "https://example.com/link-94089/profile-73770", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-73770.jpg", "banner": "https://example.com/images/sample-banner-73770.jpg", "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 125709, "followingCount": 258, "tweetCount": 1387, "listedCount": 243, "mediaCount": 638, "favoritesCount": 467, "createdAt": "2010-02-22T21:46:21.000Z" } ], "pagination": { "nextCursor": "1842784569137304976", "prevCursor": "0" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "count", "in": "query", "required": false, "description": "Numeric result count string (default: 20; no explicit backend maximum)", "schema": { "type": "string", "pattern": "^\\d+$", "default": "20", "description": "Numeric string converted to a number by the controller. The backend currently applies no explicit maximum." }, "example": "20" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/followers-list": { "get": { "tags": [ "User" ], "summary": "Followers V1", "description": "Get a paginated list of users following the specified account. Returns user objects with complete profile information.", "operationId": "getUserFollowersList", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "1001314082880034515", "username": "sample_user_80170", "name": "Sample User 80170", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-80170.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 6, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:58.000Z" }, { "id": "1003319103125038054", "username": "sample_user_17369", "name": "Sample User 17369", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-17369.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 12, "followingCount": 50, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2022-02-15T22:09:59.000Z" }, { "id": "1009576817859776133", "username": "sample_user_69509", "name": "Sample User 69509", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-69509.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:48:07.000Z" }, { "id": "1006370714065768771", "username": "sample_user_96589", "name": "Sample User 96589", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-96589.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:48:16.000Z" }, { "id": "1005709293142012103", "username": "sample_user_46915", "name": "Sample User 46915", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-46915.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:47.000Z" }, { "id": "1001073158194714852", "username": "sample_user_94009", "name": "Sample User 94009", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-94009.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 2, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:25.000Z" }, { "id": "1008272410444405531", "username": "sample_user_80610", "name": "Sample User 80610", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-80610.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:48:01.000Z" }, { "id": "1001436978716608665", "username": "sample_user_98121", "name": "Sample User 98121", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-98121.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:48:17.000Z" }, { "id": "1001119275049751505", "username": "sample_user_68055", "name": "Sample User 68055", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-68055.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 18, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:23:32.000Z" }, { "id": "1001364299402711757", "username": "sample_user_78763", "name": "Sample User 78763", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-78763.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:21.000Z" }, { "id": "1008623704148917770", "username": "sample_user_53231", "name": "Sample User 53231", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-53231.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:45:25.000Z" }, { "id": "1004023911488779289", "username": "sample_user_20021", "name": "Sample User 20021", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-20021.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 4, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:56.000Z" }, { "id": "1001003662374077050", "username": "sample_user_22354", "name": "Sample User 22354", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-22354.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 12, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 396, "createdAt": "2024-03-12T16:59:59.000Z" }, { "id": "1001507392931018686", "username": "sample_user_85168", "name": "Sample User 85168", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-85168.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 2, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:33.000Z" }, { "id": "1001189621131544562", "username": "sample_user_30278", "name": "Sample User 30278", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-30278.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 62, "followingCount": 2974, "tweetCount": 36, "listedCount": 1, "mediaCount": 1, "favoritesCount": 32, "createdAt": "2019-09-19T22:55:28.000Z" }, { "id": "1009354821570618394", "username": "sample_user_47530", "name": "Sample User 47530", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-47530.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:48:10.000Z" }, { "id": "1001343998169561826", "username": "sample_user_16633", "name": "Sample User 16633", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-16633.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 3, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-03-14T15:03:42.000Z" }, { "id": "1002399585468114642", "username": "sample_user_39434", "name": "Sample User 39434", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-39434.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": true, "followerCount": 0, "followingCount": 6, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:59.000Z" }, { "id": "1001583251795754519", "username": "sample_user_43895", "name": "Sample User 43895", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-43895.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 1, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:47:01.000Z" }, { "id": "1009229173585685139", "username": "sample_user_19353", "name": "Sample User 19353", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-19353.jpg", "banner": null, "profileImageShape": null, "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": { "affiliatesCount": 0 }, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 13, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-10-02T05:46:10.000Z" } ], "pagination": { "nextCursor": "1844847953281693545", "prevCursor": "0" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "count", "in": "query", "required": false, "description": "Numeric result count string (default: 20; no explicit backend maximum)", "schema": { "type": "string", "pattern": "^\\d+$", "default": "20", "description": "Numeric string converted to a number by the controller. The backend currently applies no explicit maximum." }, "example": "20" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/following-ids": { "get": { "tags": [ "User" ], "summary": "Following Ids", "description": "Get a paginated list of users that the specified account is following. Returns user objects with complete profile information.", "operationId": "getUserFollowingIds", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdPageResponse" }, "example": { "data": [ "10088980", "100788754", "1001725635885283840", "1007279781545554210", "100849850", "10081545", "1007949731", "1003792412575786288", "1001361025", "1001359723661677634", "1005427224324788504", "1005612830", "1001004927889873081", "1001826983839195269", "1001140180846719767", "1004724182165837366", "1001910612794548107", "10016059", "20099468", "100334094" ], "pagination": { "nextCursor": "1842784569137304976", "prevCursor": "0" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "count", "in": "query", "required": false, "description": "Numeric result count string (default: 20; no explicit backend maximum)", "schema": { "type": "string", "pattern": "^\\d+$", "default": "20", "description": "Numeric string converted to a number by the controller. The backend currently applies no explicit maximum." }, "example": "20" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/followers-ids": { "get": { "tags": [ "User" ], "summary": "Followers Ids", "description": "Get a paginated list of users following the specified account. Returns user objects with complete profile information.", "operationId": "getUserFollowersIds", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdPageResponse" }, "example": { "data": [ "1973624294736535554", "1973625972869177344", "1237311994471968768", "1371735280751800323", "1973625984101523456", "1973625935086948352", "1973625927201595393", "1973625919639007232", "1973625897514311682", "1302344268778856448", "1973625933576699904", "1973581129266397184", "1344298997855387650", "1973623525396324353", "1973624962377457668", "1973624267465207808", "1973625923493646336", "1973625908553490432", "1969158854177898496", "1972698769327366144" ], "pagination": { "nextCursor": "1844847931695364564", "prevCursor": "0" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "userId", "in": "query", "required": true, "description": "Unique platform user ID (e.g., '10017528')", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "count", "in": "query", "required": false, "description": "Numeric result count string (default: 20; no explicit backend maximum)", "schema": { "type": "string", "pattern": "^\\d+$", "default": "20", "description": "Numeric string converted to a number by the controller. The backend currently applies no explicit maximum." }, "example": "20" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/user/friendship": { "get": { "tags": [ "User" ], "summary": "Check Follow", "description": "Check if a follow relationship exists between two users.", "operationId": "getUserFriendship", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipResponse" }, "example": { "data": { "sourceId": "90013690", "targetId": "900114305", "following": true, "followedBy": true, "blocking": false, "blockedBy": false, "muting": false, "notificationsEnabled": false, "canDm": true, "followRequestSent": false, "followRequestReceived": false, "wantRetweets": false, "markedSpam": false, "allReplies": false, "canMediaTag": false } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "subjectId", "in": "query", "required": true, "description": "The user ID of the subject user (the follower)", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "targetId", "in": "query", "required": true, "description": "The user ID of the target user (the one being followed)", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "9876543210" } ] } }, "/tw-v2/user/about-account": { "get": { "tags": [ "User" ], "summary": "About Account", "description": "Retrieve detailed account information for a user including location, verification details, username history, affiliate relationships, and account creation source.", "operationId": "getUserAboutAccount", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AboutAccountResponse" }, "example": { "data": { "id": "1001937475184068444", "username": "exampleuser", "name": "Sample User 35037", "createdAt": "Wed Jan 15 10:30:00 +0000 2023", "verified": false, "isBlueVerified": true, "isProtected": false, "avatarUrl": "https://example.com/images/sample-avatar-35037.jpg", "profileImageShape": "Circle", "aboutProfile": { "accountBasedIn": "Sample City 457", "locationAccurate": true, "learnMoreUrl": "https://example.com/link-94089/link-85739", "source": "Sample City 457 App Store", "usernameChanges": { "count": 2, "lastChangedAt": "2024-03-15T14:22:30.000Z" } } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "username", "in": "query", "required": true, "description": "platform username without @ symbol (e.g., 'sample_user_96991')", "schema": { "type": "string", "minLength": 1 }, "example": "sample_user" } ] } }, "/tw-v2/tweet/details": { "get": { "tags": [ "Tweet" ], "summary": "Details Conversation", "description": "Get detailed information about a specific tweet including full metadata, engagement metrics, conversation context, and attached X Article content.", "operationId": "getTweetDetails", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetResponse" }, "example": { "data": { "id": "5003666593753562724", "conversationId": "5003666593753562724", "text": "Sample post text 47487 for documentation.", "displayTextRange": [ 0, 99 ], "author": { "id": "10030086", "username": "sample_user_92303", "name": "Sample User 92303", "bio": "Sample profile bio for Sample User 92303.", "location": "Sample City 731", "website": "https://example.com/link-94089/profile-29900/profile-84577", "pinnedTweetIds": [ "2001104869074971439" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-84577.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-84577.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": 579, "name": "Media & News", "icon_name": "IconBriefcaseStroke" } ], "restId": "7001747894951294611" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 732200, "followingCount": 68, "tweetCount": 106693, "listedCount": 10796, "mediaCount": 48095, "favoritesCount": 2077, "createdAt": "2009-02-10T20:27:09.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 3, "retweetCount": 1, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1977, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-06903", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "article": null, "hashtags": [ "sample_topic_28432" ], "mentions": [], "urls": [ "https://example.com/link-94089/profile-29900/profile-84577/articles/25/10/01/lowest-price-ever-apple-watch-se-2-gps-cellular-plunges-to-189?utm_source=rss&utm_source=rss&utm_medium=Sendible&utm_campaign=RSS" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:00:19.000Z", "place": null, "communityId": null, "communityResults": null } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "tweetId", "in": "query", "required": true, "description": "Unique tweet/post ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" }, { "name": "sortBy", "in": "query", "required": false, "description": "Sort order for conversation replies (Relevance, Recency, Likes). Default: Relevance", "schema": { "type": "string", "enum": [ "Relevance", "Recency", "Likes" ], "default": "Relevance" }, "example": "Relevance" } ] } }, "/tw-v2/tweet/details-by-ids": { "get": { "tags": [ "Tweet" ], "summary": "Details By Ids", "description": "Retrieve detailed information for multiple tweets in a single request. Returns comprehensive tweet data including author information, engagement metrics, media attachments, and metadata for up to 200 tweets at once.", "operationId": "getTweetDetailsByIds", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetLookupResponse" }, "example": { "data": { "tweets": [ { "id": "2002171750977445519", "conversationId": "5001695046433325839", "text": "Sample post text 98460 for documentation.", "displayTextRange": [ 0, 278 ], "author": { "id": "2006293925", "username": "sample_user_85154", "name": "Sample User 85154", "bio": "Sample profile bio for Sample User 85154.", "location": "Sample City 493", "website": "https://example.com/profile-85154", "pinnedTweetIds": [ "2005297009281584090" ], "avatar": "https://example.com/media/sample-media-72688.jpg", "banner": "https://example.com/media/sample-media-61934.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": 1009, "name": "Community", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001309288299939786" }, "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/Sample description for documentation 49447._Finance", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/media/sample-media-85061.jpg" }, "description": "Sample description for documentation 49447.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 126041, "followingCount": 1111, "tweetCount": 43934, "listedCount": 1889, "mediaCount": 6617, "favoritesCount": 143026, "createdAt": "2015-04-23T15:32:31.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 55, "retweetCount": 0, "replyCount": 20, "quoteCount": 1, "bookmarkCount": 2, "viewCount": 2615, "media": [ { "id": "2001167493280852678", "key": "13_2001167493280852678", "type": "video", "url": "https://example.com/media/sample-media-41049.jpg", "displayUrl": "pic.x.com/H8tUFQMiIM", "expandedUrl": "https://x.com/sample_user_88784/status/2005293125405946889/video/1", "thumbnailUrl": "https://example.com/media/sample-media-68973.jpg", "width": 2160, "height": 3840, "aspectRatio": [ 9, 16 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 383, "height": 680, "resize": "fit" }, "medium": { "width": 675, "height": 1200, "resize": "fit" }, "large": { "width": 1152, "height": 2048, "resize": "fit" }, "original": { "width": 2160, "height": 3840, "resize": "fit" } }, "duration": 11, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/media/sample-media-37488.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/media/sample-media-89684.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/media/sample-media-97684.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/media/sample-media-19761.jpg" }, { "bitrate": 10368000, "contentType": "video/mp4", "url": "https://example.com/media/sample-media-28268.jpg" }, { "bitrate": 25128000, "contentType": "video/mp4", "url": "https://example.com/media/sample-media-41049.jpg" } ], "durationMillis": 10921 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null }, { "id": "2003777419665913692", "key": "3_2003777419665913692", "type": "photo", "url": "https://example.com/media/sample-media-35656.jpg", "displayUrl": "pic.x.com/H8tUFQMiIM", "expandedUrl": "https://x.com/sample_user_88784/status/2005293125405946889/video/1", "thumbnailUrl": "https://example.com/media/sample-media-35656.jpg", "width": 1320, "height": 2295, "aspectRatio": [ 88, 153 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 391, "height": 680, "resize": "fit" }, "medium": { "width": 690, "height": 1200, "resize": "fit" }, "large": { "width": 1178, "height": 2048, "resize": "fit" }, "original": { "width": 1320, "height": 2295, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ { "id": "sample_user_15900", "username": "sample_user_08227", "name": "sample_user_08227" } ], "urls": [ "https://example.com/link-81824" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-12-10T10:21:33.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "2001085712943977436", "conversationId": "5005342409944857687", "text": "Sample post text 21266 for documentation.", "displayTextRange": [ 0, 139 ], "author": { "id": "2001247918698523627", "username": "sample_user_72184", "name": "Sample User 72184", "bio": "Sample profile bio for Sample User 72184.", "location": "Sample City 866", "website": "https://example.com/profile-72184", "pinnedTweetIds": [ "2001188189926834188" ], "avatar": "https://example.com/media/sample-media-90390.jpg", "banner": "https://example.com/media/sample-media-96122.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": false, "verifiedType": "Business", "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "2001358049460435192" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 124825, "followingCount": 1594, "tweetCount": 22572, "listedCount": 1179, "mediaCount": 12692, "favoritesCount": 22347, "createdAt": "2021-09-09T09:27:56.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 98, "retweetCount": 12, "replyCount": 16, "quoteCount": 9, "bookmarkCount": 6, "viewCount": 8882, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-20541", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [ { "id": "sample_user_92809", "username": "sample_user_00158", "name": "sample_user_77867" }, { "id": "sample_user_30053", "username": "sample_user_48375", "name": "sample_user_13556" }, { "id": "sample_user_35864", "username": "sample_user_54210", "name": "sample_user_80395" } ], "urls": [ "https://example.com/link-59221" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-12-10T14:05:21.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "2001390983706415851", "conversationId": "5001231875823925520", "text": "Sample post text 69284 for documentation.", "displayTextRange": [ 0, 94 ], "author": { "id": "2003402457649470437", "username": "sample_user_05168", "name": "Sample User 05168", "bio": "Sample profile bio for Sample User 05168.", "location": "Sample City 514", "website": "https://example.com/profile-05168", "pinnedTweetIds": [ "2009454311581706694" ], "avatar": "https://example.com/media/sample-media-52576.jpg", "banner": "https://example.com/media/sample-media-14687.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": 1017, "name": "Artist", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001318225778387894" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 32702, "followingCount": 1981, "tweetCount": 48322, "listedCount": 437, "mediaCount": 4888, "favoritesCount": 96501, "createdAt": "2019-12-30T13:55:14.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 39, "retweetCount": 8, "replyCount": 5, "quoteCount": 0, "bookmarkCount": 2, "viewCount": 2272, "media": [ { "id": "2001186783151650313", "key": "3_2001186783151650313", "type": "photo", "url": "https://example.com/media/sample-media-18269.jpg", "displayUrl": "pic.x.com/UIm47mTBbT", "expandedUrl": "https://x.com/sample_user_73643/status/2001418803130766099/photo/1", "thumbnailUrl": "https://example.com/media/sample-media-18269.jpg", "width": 3840, "height": 3840, "aspectRatio": [ 1, 1 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 680, "resize": "fit" }, "medium": { "width": 1200, "height": 1200, "resize": "fit" }, "large": { "width": 2048, "height": 2048, "resize": "fit" }, "original": { "width": 3840, "height": 3840, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-12-09T23:47:20.000Z", "place": null, "communityId": null, "communityResults": null } ] } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "ids", "in": "query", "required": true, "description": "Comma-separated list of tweet IDs to retrieve (maximum 200 IDs per request)", "schema": { "oneOf": [ { "type": "string", "pattern": "^\\s*\\d+\\s*(?:,\\s*\\d+\\s*){0,199}$", "description": "One to 200 comma-separated numeric tweet IDs. Surrounding whitespace is trimmed." }, { "type": "array", "minItems": 1, "maxItems": 200, "description": "Array of numeric tweet IDs. Surrounding whitespace on each item is trimmed.", "items": { "type": "string", "pattern": "^\\s*\\d+\\s*$" } } ] }, "example": "1234567890,9876543210" } ] } }, "/tw-v2/tweet/retweets": { "get": { "tags": [ "Tweet" ], "summary": "Retweets", "description": "Retrieve users who retweeted a specific tweet. Returns a paginated list of retweets with user information.", "operationId": "getTweetRetweets", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "10093216", "username": "sample_user_09342", "name": "Sample User 09342", "bio": "Sample profile bio for Sample User 09342.", "location": "Sample City 720", "website": "https://example.com/link-94089/profile-09342", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-09342.jpg", "banner": "https://example.com/images/sample-banner-09342.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": false, "defaultProfileImage": false, "followerCount": 4851, "followingCount": 1470, "tweetCount": 15446, "listedCount": 106, "mediaCount": 140, "favoritesCount": 12210, "createdAt": "2006-11-13T08:40:54.000Z" }, { "id": "10045557", "username": "sample_user_74384", "name": "Sample User 74384", "bio": "Sample profile bio for Sample User 74384.", "location": "Sample City 512", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-74384.jpg", "banner": "https://example.com/images/sample-banner-74384.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [ { "id": 477, "name": "Professional Services", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001013405075590242" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 3058, "followingCount": 4863, "tweetCount": 126640, "listedCount": 130, "mediaCount": 2151, "favoritesCount": 7393, "createdAt": "2009-01-06T15:44:46.000Z" }, { "id": "10051504", "username": "sample_user_92236", "name": "Sample User 92236", "bio": "Sample profile bio for Sample User 92236.", "location": "Sample City 250", "website": null, "pinnedTweetIds": [ "2006692596798995984" ], "avatar": "https://example.com/images/sample-avatar-92236.jpg", "banner": "https://example.com/images/sample-banner-92236.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": false, "defaultProfileImage": false, "followerCount": 391, "followingCount": 539, "tweetCount": 31780, "listedCount": 73, "mediaCount": 3616, "favoritesCount": 17982, "createdAt": "2009-09-04T20:34:57.000Z" }, { "id": "10088729", "username": "sample_user_89720", "name": "Sample User 89720", "bio": "Sample profile bio for Sample User 89720.", "location": "Sample City 259", "website": "https://example.com/link-94089/profile-89720", "pinnedTweetIds": [ "2002667272287177618" ], "avatar": "https://example.com/images/sample-avatar-89720.jpg", "banner": "https://example.com/images/sample-banner-89720.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [ { "id": 478, "name": "Advertising & Marketing Agency", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001129213133864918" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 5246, "followingCount": 4301, "tweetCount": 193081, "listedCount": 1689, "mediaCount": 35288, "favoritesCount": 7941, "createdAt": "2009-02-25T15:29:34.000Z" }, { "id": "10011152", "username": "sample_user_90113", "name": "Sample User 90113", "bio": "Sample profile bio for Sample User 90113.", "location": "Sample City 682", "website": "https://example.com/link-94089/profile-90113", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-90113.jpg", "banner": null, "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": false, "defaultProfileImage": false, "followerCount": 933, "followingCount": 283, "tweetCount": 17924, "listedCount": 95, "mediaCount": 1787, "favoritesCount": 180, "createdAt": "2008-10-23T14:26:54.000Z" }, { "id": "100128868", "username": "sample_user_67728", "name": "Sample User 67728", "bio": "Sample profile bio for Sample User 67728.", "location": "Sample City 887", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-67728.jpg", "banner": "https://example.com/images/sample-banner-67728.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 693, "followingCount": 1522, "tweetCount": 28501, "listedCount": 26, "mediaCount": 7704, "favoritesCount": 6023, "createdAt": "2011-04-22T16:58:36.000Z" }, { "id": "1005028186827600614", "username": "sample_user_03622", "name": "Sample User 03622", "bio": "Sample profile bio for Sample User 03622.", "location": "Sample City 881", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-03622.jpg", "banner": "https://example.com/images/sample-banner-03622.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": 1023, "followingCount": 774, "tweetCount": 201337, "listedCount": 14, "mediaCount": 5220, "favoritesCount": 81082, "createdAt": "2019-02-01T14:09:35.000Z" }, { "id": "100132845634597247", "username": "sample_user_91312", "name": "Sample User 91312", "bio": "Sample profile bio for Sample User 91312.", "location": "Sample City 571", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-91312.jpg", "banner": "https://example.com/images/sample-banner-91312.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": false, "defaultProfileImage": false, "followerCount": 2548, "followingCount": 7502, "tweetCount": 8568, "listedCount": 143, "mediaCount": 21, "favoritesCount": 206302, "createdAt": "2016-07-02T20:05:00.000Z" }, { "id": "100557264", "username": "sample_user_04361", "name": "Sample User 04361", "bio": "Sample profile bio for Sample User 04361.", "location": "Sample City 044", "website": "https://example.com/link-94089/profile-04361", "pinnedTweetIds": [ "2007248895840774133" ], "avatar": "https://example.com/images/sample-avatar-04361.jpg", "banner": "https://example.com/images/sample-banner-04361.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 501, "followingCount": 2230, "tweetCount": 18301, "listedCount": 103, "mediaCount": 31, "favoritesCount": 7233, "createdAt": "2012-06-13T02:21:37.000Z" }, { "id": "1002008390", "username": "sample_user_17502", "name": "Sample User 17502", "bio": "Sample profile bio for Sample User 17502.", "location": "Sample City 626", "website": "https://example.com/link-94089/profile-17502", "pinnedTweetIds": [ "2001580378303814492" ], "avatar": "https://example.com/images/sample-avatar-17502.jpg", "banner": "https://example.com/images/sample-banner-17502.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": 1148, "followingCount": 4931, "tweetCount": 90310, "listedCount": 27, "mediaCount": 340, "favoritesCount": 109968, "createdAt": "2014-04-01T17:58:37.000Z" }, { "id": "100168146599440073", "username": "sample_user_23436", "name": "Sample User 23436", "bio": "Sample profile bio for Sample User 23436.", "location": "Sample City 638", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-23436.jpg", "banner": null, "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": 509, "followingCount": 1296, "tweetCount": 76364, "listedCount": 0, "mediaCount": 807, "favoritesCount": 125524, "createdAt": "2017-05-08T08:18:01.000Z" }, { "id": "1001521053666080984", "username": "sample_user_02393", "name": "Sample User 02393", "bio": "Sample profile bio for Sample User 02393.", "location": "Sample City 982", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-02393.jpg", "banner": "https://example.com/images/sample-banner-02393.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 45, "followingCount": 172, "tweetCount": 92, "listedCount": 1, "mediaCount": 0, "favoritesCount": 531, "createdAt": "2023-07-23T17:42:21.000Z" }, { "id": "1001740750257430172", "username": "sample_user_83032", "name": "Sample User 83032", "bio": "Sample profile bio for Sample User 83032.", "location": "Sample City 697", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-83032.jpg", "banner": "https://example.com/images/sample-banner-83032.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": 50, "followingCount": 180, "tweetCount": 1219, "listedCount": 0, "mediaCount": 12, "favoritesCount": 834, "createdAt": "2021-02-10T01:00:00.000Z" }, { "id": "1001576990414266307", "username": "sample_user_08867", "name": "Sample User 08867", "bio": "Sample profile bio for Sample User 08867.", "location": null, "website": "https://example.com/link-94089/profile-08867", "pinnedTweetIds": [ "2002676710633174867" ], "avatar": "https://example.com/images/sample-avatar-08867.jpg", "banner": "https://example.com/images/sample-banner-08867.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 36, "followingCount": 93, "tweetCount": 1177, "listedCount": 0, "mediaCount": 182, "favoritesCount": 84, "createdAt": "2025-08-02T06:06:43.000Z" }, { "id": "1001745830", "username": "sample_user_24630", "name": "Sample User 24630", "bio": "Sample profile bio for Sample User 24630.", "location": "Sample City 620", "website": "https://example.com/link-94089/profile-24630", "pinnedTweetIds": [ "2004222017291246401" ], "avatar": "https://example.com/images/sample-avatar-24630.jpg", "banner": "https://example.com/images/sample-banner-24630.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": "9001009161334537419" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 143, "followingCount": 427, "tweetCount": 16804, "listedCount": 2, "mediaCount": 81, "favoritesCount": 84663, "createdAt": "2015-06-13T15:02:04.000Z" }, { "id": "1001784659478135229", "username": "sample_user_44833", "name": "Sample User 44833", "bio": "Sample profile bio for Sample User 44833.", "location": null, "website": null, "pinnedTweetIds": [ "2001252907673839380" ], "avatar": "https://example.com/images/sample-avatar-44833.jpg", "banner": "https://example.com/images/sample-banner-44833.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": 21882, "followingCount": 4289, "tweetCount": 38575, "listedCount": 679, "mediaCount": 3468, "favoritesCount": 115120, "createdAt": "2021-06-19T19:52:01.000Z" }, { "id": "1001696112", "username": "sample_user_62633", "name": "Sample User 62633", "bio": "Sample profile bio for Sample User 62633.", "location": null, "website": null, "pinnedTweetIds": [ "2001662313639878558" ], "avatar": "https://example.com/images/sample-avatar-62633.jpg", "banner": "https://example.com/images/sample-banner-62633.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9001471171028736386" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 186, "followingCount": 334, "tweetCount": 25453, "listedCount": 6, "mediaCount": 479, "favoritesCount": 49169, "createdAt": "2013-08-01T22:58:49.000Z" }, { "id": "10016902", "username": "sample_user_24354", "name": "Sample User 24354", "bio": "", "location": "Sample City 136", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-24354.jpg", "banner": "https://example.com/images/sample-banner-24354.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": 41, "followingCount": 488, "tweetCount": 879, "listedCount": 1, "mediaCount": 35, "favoritesCount": 320, "createdAt": "2009-06-28T02:19:37.000Z" }, { "id": "10024117", "username": "sample_user_49713", "name": "Sample User 49713", "bio": "Sample profile bio for Sample User 49713.", "location": "Sample City 834", "website": null, "pinnedTweetIds": [ "2006252507189316081" ], "avatar": "https://example.com/images/sample-avatar-49713.jpg", "banner": "https://example.com/images/sample-banner-49713.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": false, "defaultProfileImage": false, "followerCount": 463, "followingCount": 608, "tweetCount": 12221, "listedCount": 9, "mediaCount": 150, "favoritesCount": 96404, "createdAt": "2009-09-25T04:25:50.000Z" }, { "id": "100751789522214038", "username": "sample_user_18508", "name": "Sample User 18508", "bio": "Sample profile bio for Sample User 18508.", "location": "Sample City 192", "website": null, "pinnedTweetIds": [ "2001069024727021701" ], "avatar": "https://example.com/images/sample-avatar-18508.jpg", "banner": "https://example.com/images/sample-banner-18508.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": 133, "followingCount": 907, "tweetCount": 1614, "listedCount": 0, "mediaCount": 15, "favoritesCount": 36053, "createdAt": "2017-11-26T14:55:12.000Z" } ], "pagination": { "nextCursor": "HBaAgIC30OGUmjMAAA==", "prevCursor": "HCaAgICQhI6cmjMAAA==" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "tweetId", "in": "query", "required": true, "description": "Unique tweet/post ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/tweet/quotes": { "get": { "tags": [ "Tweet" ], "summary": "Quotes", "description": "Retrieve quote tweets for a specific tweet. Returns tweets that quote the original tweet with additional commentary.", "operationId": "getTweetQuotes", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetPageResponse" }, "example": { "data": [ { "id": "5003857790182947236", "conversationId": "5003857790182947236", "text": "Sample post text 50468 for documentation.", "displayTextRange": [ 0, 64 ], "author": { "id": "100124226173910420", "username": "sample_user_69761", "name": "Sample User 69761", "bio": "Sample profile bio for Sample User 69761.", "location": "Sample City 836", "website": null, "pinnedTweetIds": [ "200157541802507260" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-35808.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-35808.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": "7004561155932354790" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 17626, "followingCount": 6310, "tweetCount": 36568, "listedCount": 565, "mediaCount": 5803, "favoritesCount": 95929, "createdAt": "2017-10-15T03:03:23.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "2001426914081566979", "conversationId": "2001426914081566979", "text": "Sample post text 69502 for documentation.", "displayTextRange": [ 0, 220 ], "author": { "id": "20015666", "username": "sample_user_76685", "name": "Sample User 76685", "bio": "Sample profile bio for Sample User 76685.", "location": "Sample City 461", "website": "https://example.com/link-94089/profile-29900/profile-26009", "pinnedTweetIds": [ "2001426914081566979" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-26009.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-26009.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": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001177990663309073" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 428782, "followingCount": 2101, "tweetCount": 12908, "listedCount": 5696, "mediaCount": 874, "favoritesCount": 28115, "createdAt": "2008-08-23T16:43:17.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1219, "retweetCount": 78, "replyCount": 89, "quoteCount": 63, "bookmarkCount": 143, "viewCount": 194975, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-48853", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [], "urls": [ "https://example.com/link-94089/link-09458" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T21:30:53.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 3, "retweetCount": 0, "replyCount": 1, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 580, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:46:57.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001192900977388756", "conversationId": "5001192900977388756", "text": "Sample post text 94059 for documentation.", "displayTextRange": [ 0, 49 ], "author": { "id": "1005028186827600614", "username": "sample_user_03622", "name": "Sample User 03622", "bio": "Sample profile bio for Sample User 03622.", "location": "Sample City 024", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-39668.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-39668.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": 1023, "followingCount": 774, "tweetCount": 201337, "listedCount": 14, "mediaCount": 5220, "favoritesCount": 81082, "createdAt": "2019-02-01T14:09:35.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "2001426914081566979", "conversationId": "2001426914081566979", "text": "Sample post text 69502 for documentation.", "displayTextRange": [ 0, 220 ], "author": { "id": "20015666", "username": "sample_user_76685", "name": "Sample User 76685", "bio": "Sample profile bio for Sample User 76685.", "location": "Sample City 461", "website": "https://example.com/link-94089/profile-29900/profile-26009", "pinnedTweetIds": [ "2001426914081566979" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-26009.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-26009.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": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "2001177990663309073" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 428782, "followingCount": 2101, "tweetCount": 12908, "listedCount": 5696, "mediaCount": 874, "favoritesCount": 28115, "createdAt": "2008-08-23T16:43:17.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1219, "retweetCount": 78, "replyCount": 89, "quoteCount": 63, "bookmarkCount": 143, "viewCount": 194975, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-48853", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [], "urls": [ "https://example.com/link-94089/link-09458" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T21:30:53.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 16, "media": [ { "id": "2109635965318035630", "key": "3_2109635965318035630", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-17126.jpg", "displayUrl": "pic.x.com/29wTEvJFi8", "expandedUrl": "https://x.com/sample_user_66740/status/2003568736286521634/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-17126.jpg", "width": 1279, "height": 609, "aspectRatio": [ 1279, 609 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 324, "resize": "fit" }, "medium": { "width": 1200, "height": 571, "resize": "fit" }, "large": { "width": 1279, "height": 609, "resize": "fit" }, "original": { "width": 1279, "height": 609, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 63, "y": 0, "width": 1088, "height": 609 }, { "x": 303, "y": 0, "width": 609, "height": 609 }, { "x": 340, "y": 0, "width": 534, "height": 609 }, { "x": 455, "y": 0, "width": 305, "height": 609 }, { "x": 0, "y": 0, "width": 1279, "height": 609 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [ "sample_topic_14440", "sample_topic_78242" ], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:44:14.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAADDAABCgABG2O6JT_bwfgKAAIbY4qZ8NrB5QAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUbY77Vp8AnEAoABhtjvtWnv9jwAAA", "prevCursor": "DAADDAABCgABG2O6JT_bwfgKAAIbY4qZ8NrB5QAIAAIAAAABCAADAAAAAAgABAAAAAAKAAUbY77Vp8AnEAoABhtjvtWnv9jwAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "tweetId", "in": "query", "required": true, "description": "Unique tweet/post ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/tweet/translate": { "post": { "tags": [ "Tweet" ], "summary": "Translate", "description": "Translate tweet text to a target language using the built-in translation service.", "operationId": "postTweetTranslate", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RawTranslationResponse" }, "example": { "data": "{\"result\":{\"content_type\":\"POST\",\"text\":\" 😂\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"😂\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" Esto\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" es\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" famoso\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" en\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" todas\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" partes\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" \"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" J\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aja\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" \"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\" J\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aj\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aj\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aj\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aj\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aj\"}}\n{\"result\":{\"content_type\":\"POST\",\"text\":\"aja\"}}\n" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetTranslationRequest" }, "example": { "tweetId": "1234567890", "dstLang": "en" } } } } } }, "/tw-v2/interaction/create-post": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Create Post", "description": "Post a new tweet to the platform. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionCreatePost", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1001316498357235765", "action": "create_tweet", "timestamp": "2025-10-02T09:18:23.079Z", "success": true, "metadata": { "tweet_id": "2001123465058274004", "author_username": "username", "text": "Sample post text 25423 for documentation.", "created_at": "Thu Oct 02 09:18:22 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001524548149483403" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePostRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/create-post-quote": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Create Post Quote", "description": "Quote tweet another tweet with your own commentary. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionCreatePostQuote", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001288055053903767", "action": "quote", "timestamp": "2025-10-02T09:20:50.518Z", "success": true, "metadata": { "tweet_id": "2001474930414781173", "author_username": "username", "text": "Sample post text 45195 for documentation.", "created_at": "Thu Oct 02 09:20:50 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001142853007295265", "quoted_tweet_id": "2009346755595729340", "quoted_tweet_url": "https://x.com/sample_user_19356/status/2001278467352366598" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePostQuoteRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "attachmentUrl": "https://x.com/sample_user/status/1234567890", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/create-post-with-media": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Create Post With Media", "description": "Post a new tweet with media attachments to the platform. Supports text content up to 280 characters for non-premium users (or 25,000 for premium users) and up to 4 images or 1 video.", "operationId": "postInteractionCreatePostWithMedia", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1001316498357235765", "action": "create_tweet", "timestamp": "2025-10-02T09:18:23.079Z", "success": true, "metadata": { "tweet_id": "2001123465058274004", "author_username": "username", "text": "Sample post text 25423 for documentation.", "created_at": "Thu Oct 02 09:18:22 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001524548149483403" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePostWithMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "media": [ { "url": "https://example.com/sample.jpg" } ], "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/reply-post": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Reply Post", "description": "Reply to an existing tweet. Creates a tweet in the conversation thread. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionReplyPost", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1004902621421523925", "action": "reply", "timestamp": "2025-10-02T09:20:27.494Z", "success": true, "metadata": { "tweet_id": "2001657645798024876", "author_username": "username", "text": "Sample post text 53382 for documentation.", "created_at": "Thu Oct 02 09:20:27 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001999095998341221", "in_reply_to_tweet_id": "2007004865909078001", "in_reply_to_username": "sample_user_23211" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplyPostRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "tweetId": "1234567890", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/reply-post-with-media": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Reply Post With Media", "description": "Reply to an existing tweet with media attachments. Creates a tweet in the conversation thread with up to 4 images or 1 video. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionReplyPostWithMedia", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9009315671521078699", "action": "reply", "timestamp": "2025-10-02T09:20:27.494Z", "success": true, "metadata": { "tweet_id": "2001657645798024876", "author_username": "username", "text": "Sample post text 53382 for documentation.", "created_at": "Thu Oct 02 09:20:27 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001999095998341221", "in_reply_to_tweet_id": "2007004865909078001", "in_reply_to_username": "sample_user_23211" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReplyPostWithMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "tweetId": "1234567890", "media": [ { "url": "https://example.com/sample.jpg" } ], "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/delete-post": { "post": { "tags": [ "Post (write)" ], "summary": "[WRITE] Delete Post", "description": "Delete a tweet posted by the authenticated user.", "operationId": "postInteractionDeletePost", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1001316498357235765", "action": "delete_tweet", "timestamp": "2025-10-02T09:22:28.825Z", "success": true, "metadata": { "tweet_id": "2001123465058274004" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/like-post": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Favorite Post", "description": "Like a tweet on behalf of an authenticated user.", "operationId": "postInteractionLikePost", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1005712991926020128", "action": "like", "timestamp": "2025-10-02T09:18:49.958Z", "success": true, "metadata": { "tweet_id": "2001389486280316874" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/unlike-post": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Unfavorite Post", "description": "Unlike a tweet on behalf of an authenticated user.", "operationId": "postInteractionUnlikePost", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1005712991926020128", "action": "unlike", "timestamp": "2025-10-02T09:19:03.251Z", "success": true, "metadata": { "tweet_id": "2001389486280316874" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/retweet": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Retweet", "description": "Retweet a tweet on behalf of an authenticated user. This endpoint allows you to programmatically retweet any public tweet using the user's authentication token.", "operationId": "postInteractionRetweet", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001647162612562218", "action": "retweet", "timestamp": "2025-10-02T09:19:22.847Z", "success": true, "metadata": { "retweet_id": "2007867017347717558", "original_tweet_id": "2009965152053811932", "text": "Sample post text 04891 for documentation." } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/delete-retweet": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Delete Retweet", "description": "Remove a retweet (unretweet) on behalf of an authenticated user. This endpoint allows you to programmatically undo a retweet using the user's authentication token.", "operationId": "postInteractionDeleteRetweet", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1005712991926020128", "action": "unretweet", "timestamp": "2025-10-02T09:19:33.666Z", "success": true, "metadata": { "original_tweet_id": "2009965152053811932", "text": "Sample post text 42472 for documentation." } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/bookmark": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Bookmark", "description": "Add a tweet to your bookmarks for later viewing.", "operationId": "postInteractionBookmark", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1005712991926020128", "action": "bookmark", "timestamp": "2025-10-02T09:19:56.815Z", "success": true, "metadata": { "tweet_id": "2001389486280316874" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/delete-bookmark": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Delete Bookmark", "description": "Remove a tweet from your bookmarks.", "operationId": "postInteractionDeleteBookmark", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1005712991926020128", "action": "unbookmark", "timestamp": "2025-10-02T09:20:07.266Z", "success": true, "metadata": { "tweet_id": "2001389486280316874" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetActionRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "tweetId": "1234567890" } } } } } }, "/tw-v2/interaction/follow": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Follow", "description": "Follow a user account.", "operationId": "postInteractionFollow", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1001672369752484968", "action": "follow", "timestamp": "2025-10-05T06:53:46.202Z", "success": true, "metadata": { "user_id": "1001672369752484968" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "userId": "1234567890" } } } } } }, "/tw-v2/interaction/unfollow": { "post": { "tags": [ "Interaction (account action)" ], "summary": "[ACCOUNT ACTION] Unfollow", "description": "Unfollow a user account.", "operationId": "postInteractionUnfollow", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "1001672369752484968", "action": "unfollow", "timestamp": "2025-10-05T06:53:54.233Z", "success": true, "metadata": { "user_id": "1001672369752484968" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "userId": "1234567890" } } } } } }, "/tw-v2/interaction/notifications": { "get": { "tags": [ "Interaction (account action)" ], "summary": "[AUTHENTICATED READ] Notifications", "description": "Retrieve the authenticated user's notifications timeline on the platform. Returns notifications including likes, retweets, mentions, and follows.", "operationId": "getInteractionNotifications", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationPageResponse" }, "example": { "data": [ { "id": "F1jG7mhWwAAAAAAB15VmQrFiaySXms5dAAA", "type": "device_follow_tweet_notification_entry", "timestamp": "2025-10-05T06:39:17.402Z", "message": "Sample post text 53528 for documentation.", "users": [ { "id": "100151062666878842", "username": "sample_user_44649", "name": "Sample User 44649", "followerCount": 117834, "isBlueVerified": true } ], "url": "/2/notifications/device_follow.json", "icon": "bell_icon" }, { "id": "F1jG7mhWwAAAAAAB15VmQrFiaySWMQX0Luk", "type": "generic_magic_rec_first_degree_tweet_recent", "timestamp": "2025-10-04T22:40:41.212Z", "message": "Sample post text 73354 for documentation.", "users": [ { "id": "10014752", "username": "sample_user_73927", "name": "Sample User 73927", "followerCount": 317001, "isBlueVerified": true } ], "tweets": [ { "id": "2009453333471715800", "text": "Sample post text 50778 for documentation.", "author": { "id": "20027198", "username": "sample_user_73927" }, "type": "quote" } ], "url": "https://x.com/sample_user_68005/status/2009512428773061595", "icon": "recommendation_icon" }, { "id": "F1jG7mhWwAAAAAAB15VmQrFiaySWc3a7cAA", "type": "generic_magic_rec_first_degree_tweet_recent", "timestamp": "2025-10-04T22:40:41.211Z", "message": "Sample post text 43575 for documentation.", "users": [ { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "followerCount": 226995885, "isBlueVerified": true } ], "tweets": [ { "id": "2001389518663911394", "text": "Sample post text 24893 for documentation.", "author": { "id": "20089310", "username": "sample_user_96991" }, "type": "tweet" } ], "url": "https://x.com/sample_user_51247/status/2001728280874107908", "icon": "recommendation_icon" }, { "id": "F1jG7mhWwAAAAAAB15VmQrFiaySWc3a8AAA", "type": "favorite_notification_entry", "timestamp": "2025-10-04T19:22:03.210Z", "message": "Sample post text 85791 for documentation.", "users": [ { "id": "123456789", "username": "user123", "name": "Sample User 08211", "followerCount": 5432, "isBlueVerified": false } ], "tweets": [ { "id": "2001775356878954654", "text": "Sample post text 08370 for documentation.", "author": { "id": "2001005139481102956", "username": "your_username" }, "type": "tweet" } ], "url": "https://example.com/link-94089/profile-41921/your_username/status/2009078023935564305", "icon": "favorite_icon" }, { "id": "F1jG7mhWwAAAAAAB15VmQrFiaySWjvKlAAA", "type": "retweet_notification_entry", "timestamp": "2025-10-04T18:15:42.209Z", "message": "Sample post text 88014 for documentation.", "users": [ { "id": "987654321", "username": "anotheruser", "name": "Sample User 52010", "followerCount": 12345, "isBlueVerified": true } ], "tweets": [ { "id": "2001298886742910077", "text": "Sample post text 08279 for documentation.", "author": { "id": "2001226944052982843", "username": "your_username" }, "type": "tweet" } ], "url": "https://example.com/link-94089/profile-41921/your_username/status/2008988692782157135", "icon": "retweet_icon" } ], "pagination": { "nextCursor": "DAACDAABCgABF1jG7mhWwAAIAAIAAAABCAAD15VmQggABLFiayQACwACAAAAC0Faa2p5cE4zWGpZAAA", "prevCursor": null } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "timelineType", "in": "query", "required": false, "description": "Type of notifications to retrieve: 'All', 'Verified', or 'Mentions' (default: 'All')", "schema": { "type": "string", "enum": [ "All", "Verified", "Mentions" ], "default": "All" }, "example": "All" }, { "name": "count", "in": "query", "required": false, "description": "Number of results to return per page (min: 1, max: 100, default: 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "example": 20 }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/user-analytics": { "get": { "tags": [ "Interaction (account action)" ], "summary": "[AUTHENTICATED READ] User Analytics", "description": "Get detailed analytics for a user including engagement rates and growth metrics.", "operationId": "getInteractionUserAnalytics", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FlexibleDataResponse" }, "example": { "data": { "__typename": "User", "verified_follower_count": "0", "relationship_counts": { "followers": 0 }, "organic_metrics_time_series": [ { "metric_values": [ { "metric_value": 1, "metric_type": "Engagements" }, { "metric_type": "Impressions" }, { "metric_type": "ProfileVisits" }, { "metric_value": 1, "metric_type": "Follows" }, { "metric_type": "Replies" }, { "metric_type": "Likes" }, { "metric_type": "Retweets" }, { "metric_type": "Bookmark" }, { "metric_type": "Share" }, { "metric_type": "UrlClicks" }, { "metric_type": "CreateTweet" }, { "metric_type": "CreateQuote" }, { "metric_type": "Unfollows" }, { "metric_type": "CreateReply" } ], "timestamp": { "iso8601_time": "2025-09-28T00:00:00Z" } }, { "metric_values": [ { "metric_type": "Engagements" }, { "metric_value": 15, "metric_type": "Impressions" }, { "metric_type": "ProfileVisits" }, { "metric_type": "Follows" }, { "metric_type": "Replies" }, { "metric_type": "Likes" }, { "metric_type": "Retweets" }, { "metric_type": "Bookmark" }, { "metric_type": "Share" }, { "metric_type": "UrlClicks" }, { "metric_value": 6, "metric_type": "CreateTweet" }, { "metric_type": "CreateQuote" }, { "metric_type": "Unfollows" }, { "metric_type": "CreateReply" } ], "timestamp": { "iso8601_time": "2025-10-06T00:00:00Z" } }, { "metric_values": [ { "metric_value": 8, "metric_type": "Engagements" }, { "metric_value": 27, "metric_type": "Impressions" }, { "metric_type": "ProfileVisits" }, { "metric_type": "Follows" }, { "metric_value": 3, "metric_type": "Replies" }, { "metric_type": "Likes" }, { "metric_type": "Retweets" }, { "metric_type": "Bookmark" }, { "metric_type": "Share" }, { "metric_type": "UrlClicks" }, { "metric_value": 11, "metric_type": "CreateTweet" }, { "metric_type": "CreateQuote" }, { "metric_type": "Unfollows" }, { "metric_value": 1, "metric_type": "CreateReply" } ], "timestamp": { "iso8601_time": "2025-10-07T00:00:00Z" } } ], "id": "VXNlcjoxNzk2ODA4NjQ0NzI3ODg5OTIw" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "toTime", "in": "query", "required": false, "description": "End time for analytics period in ISO 8601 format (default: current time)", "schema": { "type": "string", "format": "date-time" }, "example": "2026-01-01T00:00:00.000Z" }, { "name": "fromTime", "in": "query", "required": false, "description": "Start time for analytics period in ISO 8601 format (default: 30 days ago)", "schema": { "type": "string", "format": "date-time" }, "example": "2026-01-01T00:00:00.000Z" }, { "name": "granularity", "in": "query", "required": false, "description": "Time granularity for metrics: Daily, Weekly, or Monthly (default: Daily)", "schema": { "type": "string", "enum": [ "Daily", "Weekly", "Monthly" ], "default": "Daily" }, "example": "Daily" }, { "name": "showVerifiedFollowers", "in": "query", "required": false, "description": "Include verified follower metrics (default: true)", "schema": { "type": "boolean", "default": true }, "example": true }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/list/details": { "get": { "tags": [ "List" ], "summary": "Details", "description": "Get detailed information about a specific list including metadata, member count, and configuration settings.", "operationId": "getListDetails", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListResponse" }, "example": { "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": "" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "listId", "in": "query", "required": true, "description": "Unique list ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" } ] } }, "/tw-v2/list/tweets": { "get": { "tags": [ "List" ], "summary": "Tweets", "description": "Retrieve tweets from a specific list. Returns a paginated timeline of tweets posted by list members.", "operationId": "getListTweets", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetPageResponse" }, "example": { "data": [ { "id": "5003666593753562724", "conversationId": "5003666593753562724", "text": "Sample post text 47487 for documentation.", "displayTextRange": [ 0, 99 ], "author": { "id": "10030086", "username": "sample_user_92303", "name": "Sample User 92303", "bio": "Sample profile bio for Sample User 92303.", "location": "Sample City 731", "website": "https://example.com/link-94089/profile-29900/profile-84577", "pinnedTweetIds": [ "2001104869074971439" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-84577.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-84577.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": 579, "name": "Media & News", "icon_name": "IconBriefcaseStroke" } ], "restId": "7001747894951294611" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 732200, "followingCount": 68, "tweetCount": 106693, "listedCount": 10796, "mediaCount": 48095, "favoritesCount": 2077, "createdAt": "2009-02-10T20:27:09.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 3, "retweetCount": 1, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 2017, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-06903", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [ "sample_topic_28432" ], "mentions": [], "urls": [ "https://example.com/link-94089/profile-29900/profile-84577/articles/25/10/01/lowest-price-ever-apple-watch-se-2-gps-cellular-plunges-to-189?utm_source=rss&utm_source=rss&utm_medium=Sendible&utm_campaign=RSS" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:00:19.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5002700188573944140", "conversationId": "5002700188573944140", "text": "Sample post text 61992 for documentation.", "displayTextRange": [ 0, 228 ], "author": { "id": "1002551196", "username": "sample_user_43386", "name": "Sample User 43386", "bio": "Sample profile bio for Sample User 43386.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-43386", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-43386.jpg", "banner": "https://example.com/images/sample-banner-43386.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": "9003376833339981228" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 44695, "followingCount": 119, "tweetCount": 20993, "listedCount": 346, "mediaCount": 6810, "favoritesCount": 3363, "createdAt": "2014-10-28T19:12:08.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 67, "retweetCount": 2, "replyCount": 4, "quoteCount": 0, "bookmarkCount": 4, "viewCount": 3029, "media": [ { "id": "2101294277563509231", "key": "16_2101294277563509231", "type": "animated_gif", "url": "https://example.com/link-94089/profile-29900/media/sample-media-15925.jpg", "displayUrl": "pic.x.com/Y6VkHNCcUB", "expandedUrl": "https://x.com/sample_user_87470/status/2001653444623278148/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-36256.jpg", "width": 300, "height": 168, "aspectRatio": [ 25, 14 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 300, "height": 168, "resize": "fit" }, "medium": { "width": 300, "height": 168, "resize": "fit" }, "large": { "width": 300, "height": 168, "resize": "fit" }, "original": { "width": 300, "height": 168, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-15925.jpg" } ], "durationMillis": 0 }, "altText": "Interested Ooo GIF by reactionseditor", "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T04:21:19.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAABCgABG2O7GFy__6EKAAIbYtF0ilZR4ggAAwAAAAIAAA", "prevCursor": "DAABCgABG2O7GFzAJxEKAAIbY6949VfR8QgAAwAAAAEAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "listId", "in": "query", "required": true, "description": "Unique list ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/list/members": { "get": { "tags": [ "List" ], "summary": "Members", "description": "Get a paginated list of members in a list.", "operationId": "getListMembers", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "1001377066190895470", "username": "sample_user_48642", "name": "Sample User 48642", "bio": "Sample profile bio for Sample User 48642.", "location": "Sample City 542", "website": "https://example.com/link-94089/profile-48642", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-48642.jpg", "banner": "https://example.com/images/sample-banner-48642.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 713, "name": "Science & Technology", "icon_name": "IconBriefcaseStroke" } ], "restId": "9007345758374466923" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 37853, "followingCount": 87, "tweetCount": 1656, "listedCount": 147, "mediaCount": 992, "favoritesCount": 393, "createdAt": "2020-12-06T09:16:03.000Z" }, { "id": "1001195967100888949", "username": "sample_user_49704", "name": "Sample User 49704", "bio": "Sample profile bio for Sample User 49704.", "location": "Sample City 607", "website": "https://example.com/link-94089/profile-49704", "pinnedTweetIds": [ "2001153472998808038" ], "avatar": "https://example.com/images/sample-avatar-49704.jpg", "banner": "https://example.com/images/sample-banner-49704.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": "9001676952187062752" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 124948, "followingCount": 641, "tweetCount": 34363, "listedCount": 450, "mediaCount": 3455, "favoritesCount": 28085, "createdAt": "2020-11-16T18:47:49.000Z" }, { "id": "1006019540063597456", "username": "sample_user_45996", "name": "Sample User 45996", "bio": "Sample profile bio for Sample User 45996.", "location": "Sample City 571", "website": "https://example.com/link-94089/profile-45996", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-45996.jpg", "banner": "https://example.com/images/sample-banner-45996.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": 579, "name": "Media & News", "icon_name": "IconBriefcaseStroke" } ], "restId": "9008748692919896982" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 357943, "followingCount": 69, "tweetCount": 3066, "listedCount": 1312, "mediaCount": 2601, "favoritesCount": 302, "createdAt": "2020-05-17T03:26:36.000Z" }, { "id": "1008624169743411771", "username": "sample_user_83388", "name": "Sample User 83388", "bio": "Sample profile bio for Sample User 83388.", "location": "Sample City 977", "website": null, "pinnedTweetIds": [ "2001608834125699716" ], "avatar": "https://example.com/images/sample-avatar-83388.jpg", "banner": "https://example.com/images/sample-banner-83388.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": 213, "followingCount": 421, "tweetCount": 1099, "listedCount": 6, "mediaCount": 9, "favoritesCount": 37851, "createdAt": "2020-05-05T01:06:08.000Z" }, { "id": "1001414382728409110", "username": "sample_user_63977", "name": "Sample User 63977", "bio": "Sample profile bio for Sample User 63977.", "location": "Sample City 571", "website": "https://example.com/link-94089/profile-63977", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-63977.jpg", "banner": "https://example.com/images/sample-banner-63977.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 713, "name": "Science & Technology", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001307381843710349" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 39545, "followingCount": 772, "tweetCount": 5216, "listedCount": 410, "mediaCount": 2215, "favoritesCount": 11413, "createdAt": "2020-02-11T09:20:34.000Z" }, { "id": "1003355534716832658", "username": "sample_user_42484", "name": "Sample User 42484", "bio": "Sample profile bio for Sample User 42484.", "location": "Sample City 770", "website": "https://example.com/link-94089/profile-42484", "pinnedTweetIds": [ "2001386327694894592" ], "avatar": "https://example.com/images/sample-avatar-42484.jpg", "banner": "https://example.com/images/sample-banner-42484.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": 1042, "name": "Content Creator", "icon_name": "IconBriefcaseStroke" } ], "restId": "9004530849146898679" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 389720, "followingCount": 67, "tweetCount": 28241, "listedCount": 1454, "mediaCount": 7195, "favoritesCount": 26228, "createdAt": "2020-02-06T16:54:28.000Z" }, { "id": "1009397119424885118", "username": "sample_user_18208", "name": "Sample User 18208", "bio": "Sample profile bio for Sample User 18208.", "location": "Sample City 761", "website": "https://example.com/link-94089/profile-18208", "pinnedTweetIds": [ "2001321190359525009" ], "avatar": "https://example.com/images/sample-avatar-18208.jpg", "banner": "https://example.com/images/sample-banner-18208.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9001474610074185194" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 15016, "followingCount": 121, "tweetCount": 4222, "listedCount": 148, "mediaCount": 794, "favoritesCount": 27471, "createdAt": "2019-11-02T10:17:49.000Z" }, { "id": "1007900999325565169", "username": "sample_user_67143", "name": "Sample User 67143", "bio": "Sample profile bio for Sample User 67143.", "location": null, "website": "https://example.com/link-94089/profile-67143", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-67143.jpg", "banner": "https://example.com/images/sample-banner-67143.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9001142318554816452" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 38885, "followingCount": 6, "tweetCount": 1750, "listedCount": 77, "mediaCount": 1500, "favoritesCount": 465, "createdAt": "2018-11-21T12:30:37.000Z" }, { "id": "1001608161914478950", "username": "sample_user_75075", "name": "Sample User 75075", "bio": "Sample profile bio for Sample User 75075.", "location": null, "website": "https://example.com/link-94089/profile-75075", "pinnedTweetIds": [ "2001719622190642711" ], "avatar": "https://example.com/images/sample-avatar-75075.jpg", "banner": "https://example.com/images/sample-banner-75075.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9004855988032100659" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 24451, "followingCount": 54, "tweetCount": 3393, "listedCount": 139, "mediaCount": 1706, "favoritesCount": 2272, "createdAt": "2018-05-28T08:14:14.000Z" }, { "id": "100170382866418244", "username": "sample_user_04500", "name": "Sample User 04500", "bio": "Sample profile bio for Sample User 04500.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-04500.jpg", "banner": "https://example.com/images/sample-banner-04500.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 11016, "followingCount": 11, "tweetCount": 1890, "listedCount": 85, "mediaCount": 1642, "favoritesCount": 124, "createdAt": "2016-12-31T10:56:50.000Z" }, { "id": "100104769408295386", "username": "sample_user_82076", "name": "Sample User 82076", "bio": "Sample profile bio for Sample User 82076.", "location": "Sample City 935", "website": "https://example.com/link-94089/profile-82076", "pinnedTweetIds": [ "2001720936737188630" ], "avatar": "https://example.com/images/sample-avatar-82076.jpg", "banner": "https://example.com/images/sample-banner-82076.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": "9002034422326052721" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 82064, "followingCount": 658, "tweetCount": 6079, "listedCount": 420, "mediaCount": 2257, "favoritesCount": 56324, "createdAt": "2016-12-15T18:15:29.000Z" }, { "id": "100164517631371878", "username": "sample_user_60815", "name": "Sample User 60815", "bio": "Sample profile bio for Sample User 60815.", "location": "Sample City 864", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-60815.jpg", "banner": "https://example.com/images/sample-banner-60815.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 477, "name": "Professional Services", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001291493768653713" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 44463, "followingCount": 688, "tweetCount": 5565, "listedCount": 399, "mediaCount": 381, "favoritesCount": 10382, "createdAt": "2016-06-15T17:32:50.000Z" }, { "id": "100120800761164587", "username": "sample_user_74958", "name": "Sample User 74958", "bio": "Sample profile bio for Sample User 74958.", "location": "Sample City 713", "website": "https://example.com/link-94089/profile-74958", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-74958.jpg", "banner": "https://example.com/images/sample-banner-74958.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": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001096154588409175" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 3526, "followingCount": 108, "tweetCount": 11743, "listedCount": 99, "mediaCount": 4120, "favoritesCount": 4007, "createdAt": "2016-03-17T03:19:52.000Z" }, { "id": "1008598533", "username": "sample_user_72834", "name": "Sample User 72834", "bio": "Sample profile bio for Sample User 72834.", "location": "Sample City 666", "website": null, "pinnedTweetIds": [ "2001191049600156204" ], "avatar": "https://example.com/images/sample-avatar-72834.jpg", "banner": "https://example.com/images/sample-banner-72834.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": 579, "name": "Media & News", "icon_name": "IconBriefcaseStroke" } ], "restId": "9008386314877386263" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 55730, "followingCount": 35, "tweetCount": 13978, "listedCount": 406, "mediaCount": 3738, "favoritesCount": 3253, "createdAt": "2015-08-25T09:09:13.000Z" }, { "id": "1001376668", "username": "sample_user_91513", "name": "Sample User 91513", "bio": "Sample profile bio for Sample User 91513.", "location": "Sample City 461", "website": "https://example.com/link-94089/profile-91513", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-91513.jpg", "banner": "https://example.com/images/sample-banner-91513.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": "9009110950052746016" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 74561, "followingCount": 281, "tweetCount": 11492, "listedCount": 426, "mediaCount": 2446, "favoritesCount": 10928, "createdAt": "2015-08-21T13:38:44.000Z" }, { "id": "1001189248", "username": "sample_user_56334", "name": "Sample User 56334", "bio": "Sample profile bio for Sample User 56334.", "location": "Sample City 571", "website": "https://example.com/link-94089/profile-56334", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-56334.jpg", "banner": "https://example.com/images/sample-banner-56334.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "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": 1661116, "followingCount": 32, "tweetCount": 1586809, "listedCount": 6176, "mediaCount": 2347, "favoritesCount": 12, "createdAt": "2015-06-05T16:05:20.000Z" }, { "id": "1005700248", "username": "sample_user_45135", "name": "Sample User 45135", "bio": "Sample profile bio for Sample User 45135.", "location": "Sample City 406", "website": "https://example.com/link-94089/profile-45135", "pinnedTweetIds": [ "2002605252296781749" ], "avatar": "https://example.com/images/sample-avatar-45135.jpg", "banner": "https://example.com/images/sample-banner-45135.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [ { "id": 1017, "name": "Artist", "icon_name": "IconBriefcaseStroke" } ], "restId": "9007767866564839760" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 34088, "followingCount": 2786, "tweetCount": 13098, "listedCount": 256, "mediaCount": 3053, "favoritesCount": 29228, "createdAt": "2015-04-10T04:29:30.000Z" }, { "id": "1004362531", "username": "sample_user_92170", "name": "Sample User 92170", "bio": "Sample profile bio for Sample User 92170.", "location": "Sample City 461", "website": "https://example.com/link-94089/profile-92170", "pinnedTweetIds": [ "2001763814391669055" ], "avatar": "https://example.com/images/sample-avatar-92170.jpg", "banner": "https://example.com/images/sample-banner-92170.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": 1042, "name": "Content Creator", "icon_name": "IconBriefcaseStroke" } ], "restId": "9007745242166234251" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 1302339, "followingCount": 162, "tweetCount": 8405, "listedCount": 2469, "mediaCount": 5428, "favoritesCount": 4524, "createdAt": "2014-12-19T03:19:51.000Z" }, { "id": "1002551196", "username": "sample_user_43386", "name": "Sample User 43386", "bio": "Sample profile bio for Sample User 43386.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-43386", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-43386.jpg", "banner": "https://example.com/images/sample-banner-43386.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": "9003376833339981228" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 44695, "followingCount": 119, "tweetCount": 20993, "listedCount": 346, "mediaCount": 6810, "favoritesCount": 3363, "createdAt": "2014-10-28T19:12:08.000Z" }, { "id": "1002900576", "username": "sample_user_19582", "name": "Sample User 19582", "bio": "Sample profile bio for Sample User 19582.", "location": "Sample City 639", "website": "https://example.com/link-94089/profile-19582", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-19582.jpg", "banner": "https://example.com/images/sample-banner-19582.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "9003805638829627220" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 4451, "followingCount": 19, "tweetCount": 2628, "listedCount": 59, "mediaCount": 1357, "favoritesCount": 177, "createdAt": "2014-09-16T04:15:26.000Z" } ], "pagination": { "nextCursor": "4611686021239802754|1973626787078340586", "prevCursor": "-1|1973626787078340609" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "listId", "in": "query", "required": true, "description": "Unique list ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/list/followers": { "get": { "tags": [ "List" ], "summary": "Followers", "description": "Get a paginated list of users following a specific list. Returns user objects with complete profile information.", "operationId": "getListFollowers", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserPageResponse" }, "example": { "data": [ { "id": "1005847322855090100", "username": "sample_user_46821", "name": "Sample User 46821", "bio": "Sample profile bio for Sample User 46821.", "location": "Sample City 875", "website": "https://example.com/link-94089/profile-46821", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-46821.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [ { "id": 478, "name": "Advertising & Marketing Agency", "icon_name": "IconBriefcaseStroke" } ], "restId": "9004679994812961609" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 114, "followingCount": 272, "tweetCount": 383, "listedCount": 0, "mediaCount": 84, "favoritesCount": 135, "createdAt": "2024-03-21T07:55:54.000Z" }, { "id": "10085411", "username": "sample_user_73359", "name": "Sample User 73359", "bio": "", "location": "Sample City 250", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-73359.jpg", "banner": "https://example.com/images/sample-banner-73359.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 378, "followingCount": 2939, "tweetCount": 46, "listedCount": 0, "mediaCount": 0, "favoritesCount": 3455, "createdAt": "2009-03-31T14:42:27.000Z" }, { "id": "100166586607221168", "username": "sample_user_86518", "name": "Sample User 86518", "bio": "", "location": null, "website": null, "pinnedTweetIds": [ "2003548940864932993" ], "avatar": "https://example.com/images/sample-avatar-86518.jpg", "banner": "https://example.com/images/sample-banner-86518.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "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": 28, "followingCount": 93, "tweetCount": 40, "listedCount": 0, "mediaCount": 8, "favoritesCount": 2290, "createdAt": "2017-09-14T12:03:14.000Z" }, { "id": "1001476910277136971", "username": "sample_user_71130", "name": "Sample User 71130", "bio": "Sample profile bio for Sample User 71130.", "location": "Sample City 626", "website": null, "pinnedTweetIds": [ "2002316677909137509" ], "avatar": "https://example.com/images/sample-avatar-71130.jpg", "banner": "https://example.com/images/sample-banner-71130.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 263, "followingCount": 3398, "tweetCount": 3180, "listedCount": 0, "mediaCount": 1547, "favoritesCount": 2023, "createdAt": "2024-12-13T16:36:27.000Z" }, { "id": "1009488546", "username": "sample_user_56809", "name": "Sample User 56809", "bio": "", "location": "Sample City 344", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-56809.jpg", "banner": "https://example.com/images/sample-banner-56809.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": false, "defaultProfileImage": false, "followerCount": 62, "followingCount": 374, "tweetCount": 261, "listedCount": 0, "mediaCount": 6, "favoritesCount": 499, "createdAt": "2013-05-02T02:19:44.000Z" }, { "id": "1001431270044262184", "username": "sample_user_49053", "name": "Sample User 49053", "bio": "Sample profile bio for Sample User 49053.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-49053.jpg", "banner": "https://example.com/images/sample-banner-49053.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 2, "followingCount": 14, "tweetCount": 4, "listedCount": 0, "mediaCount": 1, "favoritesCount": 111, "createdAt": "2023-06-29T09:45:50.000Z" }, { "id": "1002177007207710907", "username": "sample_user_65488", "name": "Sample User 65488", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-65488.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 3, "followingCount": 41, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 1, "createdAt": "2023-06-22T09:42:50.000Z" }, { "id": "1008299721448135558", "username": "sample_user_12404", "name": "Sample User 12404", "bio": "Sample profile bio for Sample User 12404.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-12404.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "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": 0, "followingCount": 315, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 23, "createdAt": "2020-02-18T07:47:13.000Z" }, { "id": "10042251", "username": "sample_user_35696", "name": "Sample User 35696", "bio": "", "location": "Sample City 367", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-35696.jpg", "banner": null, "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": 131, "followingCount": 1196, "tweetCount": 9559, "listedCount": 8, "mediaCount": 379, "favoritesCount": 24466, "createdAt": "2009-06-17T18:15:25.000Z" }, { "id": "100199341", "username": "sample_user_21607", "name": "Sample User 21607", "bio": "Sample profile bio for Sample User 21607.", "location": "Sample City 597", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-21607.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 74, "followingCount": 790, "tweetCount": 54, "listedCount": 0, "mediaCount": 4, "favoritesCount": 138, "createdAt": "2011-05-23T17:35:30.000Z" }, { "id": "1002632407906071892", "username": "sample_user_83760", "name": "Sample User 83760", "bio": "Sample profile bio for Sample User 83760.", "location": "Sample City 984", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-83760.jpg", "banner": "https://example.com/images/sample-banner-83760.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 19, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2025-03-19T23:30:13.000Z" }, { "id": "1006700538687198430", "username": "sample_user_29891", "name": "Sample User 29891", "bio": "Sample profile bio for Sample User 29891.", "location": "Sample City 254", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29891.jpg", "banner": "https://example.com/images/sample-banner-29891.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 0, "followingCount": 942, "tweetCount": 17, "listedCount": 0, "mediaCount": 1, "favoritesCount": 96, "createdAt": "2022-04-06T13:37:01.000Z" }, { "id": "100109090", "username": "sample_user_77838", "name": "Sample User 77838", "bio": "Sample profile bio for Sample User 77838.", "location": "Sample City 542", "website": "https://example.com/link-94089/profile-77838", "pinnedTweetIds": [ "2003963824275179675" ], "avatar": "https://example.com/images/sample-avatar-77838.jpg", "banner": "https://example.com/images/sample-banner-77838.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [ { "id": 940, "name": "Musician", "icon_name": "IconBriefcaseStroke" } ], "restId": "9001626199835771365" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 2616, "followingCount": 25, "tweetCount": 478, "listedCount": 10, "mediaCount": 53, "favoritesCount": 96, "createdAt": "2010-05-07T18:46:10.000Z" }, { "id": "100762707", "username": "sample_user_65115", "name": "Sample User 65115", "bio": "", "location": "Sample City 363", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-65115.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 57, "followingCount": 534, "tweetCount": 54, "listedCount": 0, "mediaCount": 0, "favoritesCount": 149, "createdAt": "2012-03-09T21:17:34.000Z" }, { "id": "1001739187", "username": "sample_user_24922", "name": "Sample User 24922", "bio": "Sample profile bio for Sample User 24922.", "location": "Sample City 571", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-24922.jpg", "banner": "https://example.com/images/sample-banner-24922.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": null, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 139, "followingCount": 412, "tweetCount": 125, "listedCount": 0, "mediaCount": 0, "favoritesCount": 914, "createdAt": "2014-09-21T15:08:47.000Z" }, { "id": "1004075800693477309", "username": "sample_user_32434", "name": "Sample User 32434", "bio": "Sample profile bio for Sample User 32434.", "location": null, "website": "https://example.com/link-94089/profile-32434", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-32434.jpg", "banner": "https://example.com/images/sample-banner-32434.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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 5, "followingCount": 7, "tweetCount": 8, "listedCount": 0, "mediaCount": 0, "favoritesCount": 2, "createdAt": "2025-09-17T22:32:32.000Z" }, { "id": "1001477371562798814", "username": "sample_user_17372", "name": "Sample User 17372", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-17372.jpg", "banner": null, "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": 2, "followingCount": 52, "tweetCount": 4, "listedCount": 0, "mediaCount": 0, "favoritesCount": 160, "createdAt": "2020-04-07T15:46:55.000Z" }, { "id": "100147625367253458", "username": "sample_user_53304", "name": "Sample User 53304", "bio": "Sample profile bio for Sample User 53304.", "location": "Sample City 384", "website": "https://example.com/link-94089/profile-53304", "pinnedTweetIds": [ "2001627032652925231" ], "avatar": "https://example.com/images/sample-avatar-53304.jpg", "banner": "https://example.com/images/sample-banner-53304.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Creator", "category": [], "restId": "9003768798407128655" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 729, "followingCount": 767, "tweetCount": 25194, "listedCount": 3, "mediaCount": 746, "favoritesCount": 15311, "createdAt": "2018-04-24T14:32:23.000Z" }, { "id": "10088848", "username": "sample_user_21251", "name": "Sample User 21251", "bio": "", "location": "Sample City 787", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-21251.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": true, "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": 27, "followingCount": 222, "tweetCount": 36, "listedCount": 0, "mediaCount": 0, "favoritesCount": 109, "createdAt": "2007-05-25T15:31:04.000Z" }, { "id": "100126183", "username": "sample_user_07119", "name": "Sample User 07119", "bio": "Sample profile bio for Sample User 07119.", "location": "Sample City 178", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-07119.jpg", "banner": "https://example.com/images/sample-banner-07119.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 871, "followingCount": 2454, "tweetCount": 1595, "listedCount": 10, "mediaCount": 102, "favoritesCount": 5504, "createdAt": "2011-05-07T17:34:56.000Z" } ], "pagination": { "nextCursor": "1843347950502702997|1973626801934565354", "prevCursor": "-1|1973626801934565377" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "listId", "in": "query", "required": true, "description": "Unique list ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/list/create": { "post": { "tags": [ "List" ], "summary": "[ACCOUNT ACTION] Create", "description": "Create a list for the authenticated Twitter/X account.", "operationId": "postListCreate", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListResponse" }, "example": { "data": { "id": "9004718786321977501", "name": "Market Watch", "description": "Accounts to monitor for market updates", "mode": "private", "memberCount": 0, "subscriberCount": 0, "createdAt": "2026-06-22T10:12:00.000Z", "owner": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "avatar": "https://example.com/images/sample-avatar-96991.jpg", "verified": false, "isBlueVerified": true, "isProtected": false }, "bannerUrl": null, "defaultBannerMedia": null, "facepileUrls": [], "slug": "", "uri": "" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateListRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "name": "Research list" } } } } } }, "/tw-v2/list/add-member": { "post": { "tags": [ "List" ], "summary": "[ACCOUNT ACTION] Add Member", "description": "Add a user to one of the authenticated account's lists.", "operationId": "postListAddMember", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "10017528", "action": "add_to_list", "timestamp": "2025-10-02T09:21:14.693Z", "success": true, "metadata": { "user_id": "10017528", "list_id": "3001357893980619073" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMemberRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "listId": "1234567890", "userId": "1234567890" } } } } } }, "/tw-v2/list/remove-member": { "post": { "tags": [ "List" ], "summary": "[ACCOUNT ACTION] Remove Member", "description": "Remove a user from one of the authenticated account's lists.", "operationId": "postListRemoveMember", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "10017528", "action": "remove_from_list", "timestamp": "2025-10-02T09:21:27.949Z", "success": true, "metadata": { "user_id": "10017528", "list_id": "3001357893980619073" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListMemberRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "listId": "1234567890", "userId": "1234567890" } } } } } }, "/tw-v2/profile/update": { "post": { "tags": [ "Profile (account action)" ], "summary": "[ACCOUNT ACTION] Update", "description": "Update display profile fields for the authenticated Twitter/X account.", "operationId": "postProfileUpdate", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User", "bio": "Building with TweetAPI", "location": "Bangkok", "website": "https://example.com", "avatar": "https://example.com/images/sample-avatar-96991.jpg", "banner": "https://example.com/images/sample-banner-96991.jpg", "verified": false, "isBlueVerified": true, "isProtected": false, "followerCount": 226995885, "followingCount": 1218, "tweetCount": 86745, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProfileRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "name": "Research list" } } } } } }, "/tw-v2/profile/avatar": { "post": { "tags": [ "Profile (account action)" ], "summary": "[ACCOUNT ACTION] Avatar", "description": "Update the profile picture for the authenticated Twitter/X account using an image URL or base64 image payload.", "operationId": "postProfileAvatar", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "avatar": "https://example.com/images/profile-avatar.jpg", "banner": "https://example.com/images/sample-banner-96991.jpg", "verified": false, "isBlueVerified": true, "isProtected": false, "followerCount": 226995885, "followingCount": 1218, "tweetCount": 86745, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProfileMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "media": { "url": "https://example.com/sample.jpg" } } } } } } }, "/tw-v2/profile/banner": { "post": { "tags": [ "Profile (account action)" ], "summary": "[ACCOUNT ACTION] Banner", "description": "Update the profile banner for the authenticated Twitter/X account using an image URL or base64 image payload.", "operationId": "postProfileBanner", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "avatar": "https://example.com/images/sample-avatar-96991.jpg", "banner": "https://example.com/images/profile-banner.jpg", "verified": false, "isBlueVerified": true, "isProtected": false, "followerCount": 226995885, "followingCount": 1218, "tweetCount": 86745, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProfileMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "media": { "url": "https://example.com/sample.jpg" } } } } } } }, "/tw-v2/profile/remove-banner": { "post": { "tags": [ "Profile (account action)" ], "summary": "[ACCOUNT ACTION] Remove Banner", "description": "Remove the profile banner from the authenticated X account.", "operationId": "postProfileRemoveBanner", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserResponse" }, "example": { "data": { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "Sample profile bio for Sample User 96991.", "location": null, "website": null, "avatar": "https://example.com/images/sample-avatar-96991.jpg", "banner": null, "verified": false, "isBlueVerified": true, "isProtected": false, "followerCount": 226995885, "followingCount": 1218, "tweetCount": 86745, "createdAt": "2009-06-02T20:12:29.000Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveProfileBannerRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN" } } } } } }, "/tw-v2/profile/privacy": { "post": { "tags": [ "Profile (account action)" ], "summary": "[ACCOUNT ACTION] Privacy", "description": "Change the authenticated X account between public and private.", "operationId": "postProfilePrivacy", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyResponse" }, "example": { "data": { "isPrivate": true } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProfilePrivacyRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "isPrivate": true } } } } } }, "/tw-v2/community/details": { "get": { "tags": [ "Community" ], "summary": "Details", "description": "Get detailed information about a specific community including metadata, member count, and settings.", "operationId": "getCommunityDetails", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityResponse" }, "example": { "data": { "id": "9001746993033726229", "name": "Sample User 80101", "description": "Sample profile bio for Sample User 64708.", "memberCount": 29961, "moderatorCount": 0, "adminCount": 1, "createdAt": "2023-06-22T20:26:51.277Z", "rules": [ { "id": "Q29tbXVuaXR5UnVsZToxNjcxOTc4Mjk4MzE2ODI0NTg5", "name": "be nice and respectful", "description": "", "order": 0, "createdAt": "" }, { "id": "Q29tbXVuaXR5UnVsZToxNjcxOTc4NDAyNzcxODY5Njk2", "name": "stay on topic", "description": "Sample description for documentation 20706.", "order": 1, "createdAt": "" }, { "id": "Q29tbXVuaXR5UnVsZToxNjcxOTc4NDc0MjU5NDg4Nzgz", "name": "no spamming", "description": "", "order": 2, "createdAt": "" }, { "id": "Q29tbXVuaXR5UnVsZToxOTMwNjk1OTY1NzU0OTkxMDcx", "name": "no links", "description": "", "order": 3, "createdAt": "" }, { "id": "Q29tbXVuaXR5UnVsZToxNjcxOTc4NTY1NDg1NjAwNzkw", "name": "lmao", "description": "", "order": 4, "createdAt": "" } ], "isPrivate": false, "isMember": false, "isModerator": false, "isAdmin": false, "isBanned": false, "canPost": true, "bannerUrl": "https://example.com/images/sample-banner-64708.jpg", "avatarUrl": null, "joinRequestsEnabled": false, "pinnedTweetId": null } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "communityId", "in": "query", "required": true, "description": "Unique community ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" } ] } }, "/tw-v2/community/tweets": { "get": { "tags": [ "Community" ], "summary": "Tweets", "description": "Retrieve tweets from a specific community. Returns a paginated timeline of community tweets with configurable sorting.", "operationId": "getCommunityTweets", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TweetPageResponse" }, "example": { "data": [ { "id": "5006667037470870963", "conversationId": "5006667037470870963", "text": "Sample post text 36780 for documentation.", "displayTextRange": [ 0, 23 ], "author": { "id": "1001803218216296533", "username": "sample_user_57219", "name": "Sample User 57219", "bio": "Sample profile bio for Sample User 57219.", "location": "Sample City 343", "website": null, "pinnedTweetIds": [ "2001722005987525364" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-55473.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-55473.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": "7005089460967755889" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 6365, "followingCount": 1393, "tweetCount": 791, "listedCount": 17, "mediaCount": 471, "favoritesCount": 1492, "createdAt": "2021-02-21T06:26:16.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 264, "retweetCount": 31, "replyCount": 10, "quoteCount": 12, "bookmarkCount": 42, "viewCount": 96574, "media": [ { "id": "2101746875490153094", "key": "13_2101746875490153094", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-20997.jpg", "displayUrl": "pic.x.com/QIdAtAgDh8", "expandedUrl": "https://x.com/sample_user_24419/status/2006047531480951464/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-77164.jpg", "width": 718, "height": 1008, "aspectRatio": [ 359, 504 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 484, "height": 680, "resize": "fit" }, "medium": { "width": 718, "height": 1008, "resize": "fit" }, "large": { "width": 718, "height": 1008, "resize": "fit" }, "original": { "width": 718, "height": 1008, "resize": "fit" } }, "duration": 6, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-83584.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-03082.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-21962.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-20997.jpg" } ], "durationMillis": 6266 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": "2004323655856908632", "sourceUserId": "2107850470394562381", "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "zxx", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-09-30T17:38:50.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5009832845589304885", "conversationId": "5009832845589304885", "text": "Sample post text 74039 for documentation.", "displayTextRange": [ 0, 96 ], "author": { "id": "1003588989524708874", "username": "sample_user_79306", "name": "Sample User 79306", "bio": "Sample profile bio for Sample User 79306.", "location": null, "website": null, "pinnedTweetIds": [ "2001534739851947993" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-14221.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-14221.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4021, "followingCount": 4282, "tweetCount": 26814, "listedCount": 11, "mediaCount": 1229, "favoritesCount": 26174, "createdAt": "2024-10-02T15:59:52.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 8, "retweetCount": 0, "replyCount": 8, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 57, "media": [ { "id": "2101088986934120067", "key": "3_2101088986934120067", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-95515.jpg", "displayUrl": "pic.x.com/z03r2zwKpw", "expandedUrl": "https://x.com/sample_user_78186/status/2004781308872389299/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-95515.jpg", "width": 915, "height": 637, "aspectRatio": [ 915, 637 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 473, "resize": "fit" }, "medium": { "width": 915, "height": 637, "resize": "fit" }, "large": { "width": 915, "height": 637, "resize": "fit" }, "original": { "width": 915, "height": 637, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 0, "width": 915, "height": 512 }, { "x": 116, "y": 0, "width": 637, "height": 637 }, { "x": 155, "y": 0, "width": 559, "height": 637 }, { "x": 275, "y": 0, "width": 319, "height": 637 }, { "x": 0, "y": 0, "width": 915, "height": 637 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_79992", "sample_user_88713" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T03:15:17.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAABCgABG2O7RcJ__-kKAAIbYrso_1sA1ggAAwAAAAIAAA", "prevCursor": "DAABCgABG2O7RcKAJxEKAAIbY5du5xohyggAAwAAAAEAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "communityId", "in": "query", "required": true, "description": "Unique community ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" }, { "name": "sortBy", "in": "query", "required": false, "description": "Optional sort order for results (Relevance, Recency). Defaults to Relevance.", "schema": { "type": "string", "enum": [ "Relevance", "Recency" ], "default": "Relevance" }, "example": "Relevance" } ] } }, "/tw-v2/community/members": { "get": { "tags": [ "Community" ], "summary": "Members", "description": "Get a paginated list of members in a community.", "operationId": "getCommunityMembers", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityMemberPageResponse" }, "example": { "data": [ { "user": { "id": "1001300684922181103", "username": "sample_user_74663", "name": "Sample User 74663", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-74663.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "admin" }, { "user": { "id": "1001614043969352200", "username": "sample_user_11537", "name": "Sample User 11537", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-11537.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1006881864", "username": "sample_user_91652", "name": "Sample User 91652", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-91652.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1001614324543022820", "username": "sample_user_56999", "name": "Sample User 56999", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-56999.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1001918311246846424", "username": "sample_user_82330", "name": "Sample User 82330", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-82330.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "100166193", "username": "sample_user_59191", "name": "Sample User 59191", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-59191.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1009532614", "username": "sample_user_93558", "name": "Sample User 93558", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-93558.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "100138632", "username": "sample_user_42838", "name": "Sample User 42838", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-42838.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "100298980741684771", "username": "sample_user_25732", "name": "Sample User 25732", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-25732.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1001647614104902607", "username": "sample_user_30602", "name": "Sample User 30602", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-30602.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1009527697209503175", "username": "sample_user_67050", "name": "Sample User 67050", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-67050.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "1001608994051746461", "username": "sample_user_91719", "name": "Sample User 91719", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-91719.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "100945783", "username": "sample_user_47942", "name": "Sample User 47942", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-47942.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "10022459", "username": "sample_user_64730", "name": "Sample User 64730", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-64730.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" }, { "user": { "id": "100630165867873382", "username": "sample_user_32994", "name": "Sample User 32994", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-32994.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 0, "followingCount": 0, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": null }, "role": "member" } ], "pagination": { "nextCursor": "CycRAAAAAAwABAwKmwzBVQo+vQntzVWRlAABCm07AAABiO6fNA4ADJorCj69f/////////8KbTt//////////wAIP8AAAAACAAAA", "prevCursor": null } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "communityId", "in": "query", "required": true, "description": "Unique community ID", "schema": { "$ref": "#/components/schemas/SnowflakeId" }, "example": "1234567890" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/community/search": { "get": { "tags": [ "Community" ], "summary": "Search", "description": "Search for communities by keyword. Returns a list of communities matching the search query with basic information like name, member count, and topic.", "operationId": "getCommunitySearch", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunitySearchResponse" }, "example": { "data": [ { "id": "1001577312306161651", "name": "Sample User 64708", "memberCount": 45230, "topic": "Technology", "isNsfw": false, "bannerUrl": "https://example.com/images/sample-banner-64708.jpg", "defaultBannerUrl": null, "membersFacepile": [ "https://example.com/link-94089/profile-29900/media/sample-media-80101.jpg", "https://example.com/link-94089/profile-29900/media/sample-media-80101.jpg", "https://example.com/link-94089/profile-29900/media/sample-media-80101.jpg" ] }, { "id": "9009824028838147488", "name": "Web Development", "memberCount": 28150, "topic": "Technology", "isNsfw": false, "bannerUrl": "https://example.com/images/sample-banner-24361.jpg", "defaultBannerUrl": null, "membersFacepile": [ "https://example.com/link-94089/profile-29900/media/sample-media-83853.jpg", "https://example.com/link-94089/profile-29900/media/sample-media-83853.jpg" ] } ], "nextCursor": "DAACDAABCgABF_R4_5_____9CAADRDEqP84wPCAKAAIX9Hj_n-gQAAgAAwAAAAIAAA" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search query string to find communities", "schema": { "type": "string", "minLength": 1 }, "example": "open source intelligence" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/interaction/create-community-post": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Create Community Post", "description": "Post a new tweet to a specific community. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionCreateCommunityPost", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001194536271850978", "action": "create_community_post", "timestamp": "2025-10-05T13:51:42.315Z", "success": true, "metadata": { "tweet_id": "2001438562501155293", "author_username": "username", "text": "Sample post text 40338 for documentation.", "created_at": "Sun Oct 05 13:51:42 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2004727433890397114" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityPostRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "communityId": "1234567890", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/create-community-post-with-media": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Create Community Post With Media", "description": "Post a new tweet with media attachments to a specific community. Supports text content up to 280 characters for non-premium users (or 25,000 for premium users) and up to 4 images or 1 video.", "operationId": "postInteractionCreateCommunityPostWithMedia", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001658339092464914", "action": "create_community_post", "timestamp": "2025-10-05T13:57:08.672Z", "success": true, "metadata": { "tweet_id": "2009208775500310958", "author_username": "username", "text": "Sample post text 87088 for documentation.", "created_at": "Sun Oct 05 13:57:08 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001792974440559044" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityPostWithMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "communityId": "1234567890", "media": [ { "url": "https://example.com/sample.jpg" } ], "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/reply-community-post": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Reply Community Post", "description": "Reply to an existing tweet within a community. Creates a reply in the conversation thread with community context. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionReplyCommunityPost", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001326996141924217", "action": "reply_community_post", "timestamp": "2025-10-05T14:32:18.491Z", "success": true, "metadata": { "tweet_id": "2004163263812844894", "author_username": "username", "text": "Sample post text 67773 for documentation.", "created_at": "Sun Oct 05 14:32:18 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2001476679306571130", "in_reply_to_tweet_id": "2001498809095981665", "in_reply_to_username": "sample_user_84274" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityReplyRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "tweetId": "1234567890", "communityId": "1234567890", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/reply-community-post-with-media": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Reply Community Post With Media", "description": "Reply to an existing tweet within a community with media attachments. Creates a reply in the conversation thread with community context and up to 4 images or 1 video. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionReplyCommunityPostWithMedia", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9001066221055049613", "action": "reply_community_post", "timestamp": "2025-10-05T14:37:05.823Z", "success": true, "metadata": { "tweet_id": "2003315268649698936", "author_username": "username", "text": "Sample post text 77733 for documentation.", "created_at": "Sun Oct 05 14:37:05 +0000 2025", "url": "https://example.com/link-94089/profile-41921/username/status/2008723404410089970", "in_reply_to_tweet_id": "2001498809095981665", "in_reply_to_username": "sample_user_84274" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityReplyWithMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "tweetId": "1234567890", "communityId": "1234567890", "media": [ { "url": "https://example.com/sample.jpg" } ], "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/create-community-quote": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Create Community Quote", "description": "Quote tweet another tweet inside a specific community with your own commentary. Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionCreateCommunityQuote", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9006044199826832216", "action": "create_community_quote", "timestamp": "2026-04-16T10:30:42.315Z", "success": true, "metadata": { "tweet_id": "2001754635199832526", "author_username": "username", "text": "Sample post text 93445 for documentation.", "created_at": "Wed Apr 16 10:30:42 +0000 2026", "url": "https://example.com/link-94089/profile-41921/username/status/2001386620640114868", "quoted_tweet_id": "1234567890", "quoted_tweet_url": "https://example.com/link-94089/profile-41921/username/status/2001362066" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityQuoteRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "attachmentUrl": "https://x.com/sample_user/status/1234567890", "communityId": "1234567890", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/create-community-quote-with-media": { "post": { "tags": [ "Community" ], "summary": "[WRITE] Create Community Quote With Media", "description": "Quote tweet another tweet inside a specific community with your own commentary and media attachments (images or video). Supports text content up to 280 characters for non-premium users, or 25,000 characters for premium users.", "operationId": "postInteractionCreateCommunityQuoteWithMedia", "security": [ { "TweetApiKey": [] } ], "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9002678350904613166", "action": "create_community_quote_with_media", "timestamp": "2026-04-16T10:30:42.315Z", "success": true, "metadata": { "tweet_id": "2001292875488652844", "author_username": "username", "text": "Sample post text 93445 for documentation.", "created_at": "Wed Apr 16 10:30:42 +0000 2026", "url": "https://example.com/link-94089/profile-41921/username/status/2001444823882833836", "quoted_tweet_id": "1234567890", "quoted_tweet_url": "https://example.com/link-94089/profile-41921/username/status/2001362066" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "content-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityQuoteWithMediaRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "text": "Hello from TweetAPI", "attachmentUrl": "https://x.com/sample_user/status/1234567890", "communityId": "1234567890", "media": [ { "url": "https://example.com/sample.jpg" } ], "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/join-community": { "post": { "tags": [ "Community" ], "summary": "[ACCOUNT ACTION] Join Community", "description": "Join a community. Returns community details including name, description, member count, and your role after joining.", "operationId": "postInteractionJoinCommunity", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9009992521909111324", "action": "join_community", "timestamp": "2025-01-15T10:30:00.000Z", "success": true, "metadata": { "community_id": "4001417600827390613", "community_name": "Example Community", "community_description": "A community for sharing ideas and discussions on various topics", "member_count": 12500, "role": "Member" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityMembershipRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "communityId": "1234567890" } } } } } }, "/tw-v2/interaction/leave-community": { "post": { "tags": [ "Community" ], "summary": "[ACCOUNT ACTION] Leave Community", "description": "Leave a community. Returns community details including name, description, and member count after leaving.", "operationId": "postInteractionLeaveCommunity", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "9876543210987654321", "action": "leave_community", "timestamp": "2025-01-15T14:45:00.000Z", "success": true, "metadata": { "community_id": "9876543210987654321", "community_name": "Sample Community", "community_description": "A community for general discussions and networking", "member_count": 5432, "role": "NonMember" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommunityMembershipRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "communityId": "1234567890" } } } } } }, "/tw-v2/space/by-id": { "get": { "tags": [ "Space" ], "summary": "By Id", "description": "Retrieve detailed information about a platform Space (audio room) by its ID. Returns comprehensive data including title, state, creator, participants, topics, and engagement stats.", "operationId": "getSpaceById", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpaceResponse" }, "example": { "data": { "id": "1MnxnPmLRQBGO", "title": "Sample title 28260", "state": "Ended", "mediaKey": "28_1991353658102149130", "createdAt": 1763610684292, "scheduledStart": 1763647200000, "startedAt": 1763647259862, "endedAt": 1763651150919, "updatedAt": 1763651153433, "creator": { "id": "100808552685023961", "username": "sample_user_52875", "name": "Sample User 52875", "bio": "Sample profile bio for Sample User 52875.", "location": "Sample City 616", "website": "https://example.com/link-94089/profile-52875", "pinnedTweetIds": [ "2001469974746050344" ], "avatar": "https://example.com/images/sample-avatar-52875.jpg", "banner": "https://example.com/images/sample-banner-52875.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": "9003039634550660445" }, "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_06517", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-61212.jpg" }, "description": "Sample description for documentation 12050.", "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": "100808552685023961", "username": "sample_user_52875", "displayName": "Web", "avatarUrl": "https://example.com/images/sample-avatar-52875.jpg", "isVerified": true, "isBlueVerified": true, "isMutedByAdmin": false, "isMutedByGuest": true, "startedAt": 1763610684292 }, { "periscopeUserId": "1zYKbMkApPlQe", "twitterUserId": "1005805144763258361", "username": "sample_user_43988", "displayName": "Dro", "avatarUrl": "https://example.com/images/sample-avatar-43988.jpg", "isVerified": true, "isBlueVerified": true, "isMutedByAdmin": false, "isMutedByGuest": true, "startedAt": 1763610684292 }, { "periscopeUserId": "1YLEJOpJWzVQN", "twitterUserId": "100134997510273069", "username": "sample_user_98911", "displayName": "Nice", "avatarUrl": "https://example.com/images/sample-avatar-98911.jpg", "isVerified": true, "isBlueVerified": true, "isMutedByAdmin": false, "isMutedByGuest": true, "startedAt": 1763610684292 } ], "speakers": [ { "periscopeUserId": "1DLKBnxebLmKJ", "twitterUserId": "1001228024693567030", "username": "sample_user_12035", "displayName": "Ant", "avatarUrl": "https://example.com/images/sample-avatar-12035.jpg", "isVerified": true, "isBlueVerified": true, "isMutedByAdmin": false, "isMutedByGuest": true, "startedAt": 1763649253456 }, { "periscopeUserId": "1PmKqJMmgBxjo", "twitterUserId": "1001260066", "username": "sample_user_84668", "displayName": "Shield", "avatarUrl": "https://example.com/images/sample-avatar-84668.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": "9001809547494863432", "name": "NFTs" }, { "id": "900512550799709430", "name": "Cryptocurrencies" }, { "id": "900183888543249348", "name": "Entertainment" } ], "tweetId": "2008198802728870650", "mentionedUserIds": [ "1001260066" ] } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "spaceId", "in": "query", "required": true, "description": "Unique Space ID (e.g., '1MnxnPmLRQBGO')", "schema": { "type": "string", "minLength": 1 }, "example": "1MnxnPmLRQBGO" } ] } }, "/tw-v2/space/stream-url": { "get": { "tags": [ "Space" ], "summary": "Stream Url", "description": "Get the audio stream URL for a platform Space. Returns an HLS stream URL that can be used to listen to the Space audio. The mediaKey can be obtained from the Space details endpoint.", "operationId": "getSpaceStreamUrl", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpaceStreamResponse" }, "example": { "data": { "hlsUrl": "https://example.com/link-94089/link-90411", "status": "LIVE_PUBLIC", "streamType": "HLS", "shareUrl": "https://x.com/i/broadcasts/1MnxnPmLRQBGO" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "mediaKey", "in": "query", "required": true, "description": "Media key of the Space (obtained from the space by-id endpoint's mediaKey field)", "schema": { "type": "string", "minLength": 1 }, "example": "28_1234567890" } ] } }, "/tw-v2/search": { "get": { "tags": [ "Search" ], "summary": "Search", "description": "Search for tweets, users, or other content on the platform. Supports various search operators and filters.", "operationId": "getSearch", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchResponse" }, "example": { "data": [ { "id": "5008544259011533649", "conversationId": "5008544259011533649", "text": "Sample post text 92982 for documentation.", "displayTextRange": [ 0, 106 ], "author": { "id": "10052560", "username": "sample_user_15807", "name": "Sample User 15807", "bio": "Sample profile bio for Sample User 15807.", "location": "Sample City 850", "website": "https://example.com/link-94089/profile-29900/profile-01348", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-01348.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-01348.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": 1035, "followingCount": 1263, "tweetCount": 30315, "listedCount": 22, "mediaCount": 2641, "favoritesCount": 26629, "createdAt": "2009-10-02T04:50:43.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-44694", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [ "sample_topic_32478" ], "mentions": [], "urls": [ "https://example.com/link-94089/link-68849" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:52:05.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001104622824944120", "conversationId": "5001104622824944120", "text": "Sample post text 50780 for documentation.", "displayTextRange": [ 0, 217 ], "author": { "id": "1005062105916925213", "username": "sample_user_63109", "name": "Sample User 63109", "bio": "Sample profile bio for Sample User 63109.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-89086.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4, "followingCount": 59, "tweetCount": 582, "listedCount": 0, "mediaCount": 64, "favoritesCount": 1193, "createdAt": "2024-06-20T19:08:42.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "5002041994614812665", "conversationId": "5002041994614812665", "text": "Sample post text 04487 for documentation.", "displayTextRange": [ 0, 35 ], "author": { "id": "2001412908113892121", "username": "sample_user_11152", "name": "Sample User 11152", "bio": "Sample profile bio for Sample User 11152.", "location": "Sample City 129", "website": "https://example.com/link-94089/profile-11152", "pinnedTweetIds": [ "2001181362332812091" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-20142.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-20142.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": { "label": { "url": { "url": "https://x.com/sample_user_30043", "urlType": "DeepLink" }, "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-72669.jpg" }, "description": "Sample description for documentation 48371.", "userLabelType": "BusinessLabel", "userLabelDisplayType": "Badge" } }, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 9544, "followingCount": 584, "tweetCount": 7091, "listedCount": 67, "mediaCount": 495, "favoritesCount": 12967, "createdAt": "2018-12-23T13:25:26.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1748, "retweetCount": 31, "replyCount": 163, "quoteCount": 25, "bookmarkCount": 65, "viewCount": 117169, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-01T16:22:10.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:52:03.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5007796420291725477", "conversationId": "5007796420291725477", "text": "Sample post text 99298 for documentation.", "displayTextRange": [ 0, 75 ], "author": { "id": "1001658383861514682", "username": "sample_user_33087", "name": "Sample User 33087", "bio": "Sample profile bio for Sample User 33087.", "location": "Sample City 459", "website": "https://example.com/link-94089/profile-29900/profile-13612", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-13612.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-13612.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 50, "followingCount": 145, "tweetCount": 124, "listedCount": 0, "mediaCount": 16, "favoritesCount": 152, "createdAt": "2022-11-30T11:37:54.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 2, "media": [ { "id": "2101766276920726276", "key": "13_2101766276920726276", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-26411.jpg", "displayUrl": "pic.x.com/5lY15cf0LW", "expandedUrl": "https://x.com/sample_user_54529/status/2007262515642831386/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-41472.jpg", "width": 704, "height": 1280, "aspectRatio": [ 11, 20 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 374, "height": 680, "resize": "fit" }, "medium": { "width": 660, "height": 1200, "resize": "fit" }, "large": { "width": 704, "height": 1280, "resize": "fit" }, "original": { "width": 704, "height": 1280, "resize": "fit" } }, "duration": 10, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-48775.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-19404.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-75213.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-26411.jpg" } ], "durationMillis": 9704 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_54259" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:51:56.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001728627922668492", "conversationId": "5001728627922668492", "text": "Sample post text 98863 for documentation.", "displayTextRange": [ 0, 97 ], "author": { "id": "10018922", "username": "sample_user_57040", "name": "Sample User 81794", "bio": "Sample profile bio for Sample User 81794.", "location": "Sample City 026", "website": "https://example.com/link-94089/profile-29900/profile-82353", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-82353.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-82353.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "7001500056746435120" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 117839, "followingCount": 1, "tweetCount": 345074, "listedCount": 767, "mediaCount": 48213, "favoritesCount": 2, "createdAt": "2009-12-23T12:49:16.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [ { "id": "2101027339610739507", "key": "3_2101027339610739507", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-36496.jpg", "displayUrl": "pic.x.com/vXu5qFQfh7", "expandedUrl": "https://x.com/sample_user_32621/status/2008618211196881887/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-36496.jpg", "width": 1000, "height": 523, "aspectRatio": [ 1000, 523 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 356, "resize": "fit" }, "medium": { "width": 1000, "height": 523, "resize": "fit" }, "large": { "width": 1000, "height": 523, "resize": "fit" }, "original": { "width": 1000, "height": 523, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 0, "y": 0, "width": 934, "height": 523 }, { "x": 114, "y": 0, "width": 523, "height": 523 }, { "x": 146, "y": 0, "width": 459, "height": 523 }, { "x": 244, "y": 0, "width": 262, "height": 523 }, { "x": 0, "y": 0, "width": 1000, "height": 523 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [ "sample_topic_39931" ], "mentions": [], "urls": [ "https://example.com/link-94089/link-46395" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "el", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:51:34.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001005184655181759", "conversationId": "5001005184655181759", "text": "Sample post text 05442 for documentation.", "displayTextRange": [ 0, 277 ], "author": { "id": "10024355", "username": "sample_user_88984", "name": "Sample User 01685", "bio": "Sample profile bio for Sample User 01685.", "location": "Sample City 457", "website": "https://example.com/link-94089/profile-29900/profile-47965", "pinnedTweetIds": [ "2001533815161575065" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-47965.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-47965.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": 422951, "followingCount": 972, "tweetCount": 197383, "listedCount": 13852, "mediaCount": 82, "favoritesCount": 32386, "createdAt": "2007-03-07T07:10:46.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 74, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-31353", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [ "sample_user_09601" ], "urls": [ "https://example.com/link-94089/link-02117", "https://example.com/link-94089/link-67150", "https://example.com/link-94089/link-01086" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:51:29.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001312816663801553", "conversationId": "5001312816663801553", "text": "Sample post text 26434 for documentation.", "displayTextRange": [ 0, 225 ], "author": { "id": "100131491", "username": "sample_user_94538", "name": "Sample User 94538", "bio": "Sample profile bio for Sample User 94538.", "location": null, "website": null, "pinnedTweetIds": [ "2007681058566080607" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-04038.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-04038.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": 6343, "followingCount": 4133, "tweetCount": 298306, "listedCount": 113, "mediaCount": 13046, "favoritesCount": 9066, "createdAt": "2012-06-18T10:17:24.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 5, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:51:13.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001639328508943658", "conversationId": "5001639328508943658", "text": "Sample post text 98385 for documentation.", "displayTextRange": [ 0, 84 ], "author": { "id": "1007811404432727143", "username": "sample_user_34928", "name": "Sample User 34928", "bio": "Sample profile bio for Sample User 34928.", "location": null, "website": "https://example.com/link-94089/profile-29900/profile-01741", "pinnedTweetIds": [ "2009119691383140426" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-01741.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-01741.jpg", "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "verifiedType": null, "verifiedSince": null, "isIdentityVerified": false, "isProtected": false, "possiblySensitive": false, "profileInterstitialType": null, "withheldInCountries": [], "professional": { "type": "Business", "category": [ { "id": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "7001074862876998500" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 477, "followingCount": 23, "tweetCount": 47515, "listedCount": 7, "mediaCount": 7050, "favoritesCount": 87, "createdAt": "2021-04-08T04:38:26.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-83558", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [], "urls": [ "https://example.com/link-94089/link-63114" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "in", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:51:11.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5003160039175723396", "conversationId": "5003160039175723396", "text": "Sample post text 04251 for documentation.", "displayTextRange": [ 0, 255 ], "author": { "id": "1001266421076716474", "username": "sample_user_83281", "name": "Sample User 83281", "bio": "Sample profile bio for Sample User 83281.", "location": null, "website": "https://example.com/link-94089/profile-29900/profile-58829", "pinnedTweetIds": [ "2007140337955457470" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-58829.jpg", "banner": null, "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": false, "isTranslator": false, "affiliatesHighlightedLabel": { "label": { "badge": { "url": "https://example.com/link-94089/profile-29900/media/sample-media-61141.jpg" }, "description": "Sample description for documentation 90896.", "longDescription": { "text": "Sample post text 87584 for documentation.", "entities": [ { "fromIndex": 13, "toIndex": 24, "ref": { "type": "TimelineRichTextMention", "screen_name": "sample_user_64672", "mention_results": { "result": { "__typename": "User", "legacy": { "screen_name": "sample_user_64672" }, "rest_id": "700493178" } } } } ] }, "userLabelType": "Sample description for documentation 90896.Label" } }, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 14, "followingCount": 4, "tweetCount": 4461, "listedCount": 0, "mediaCount": 3870, "favoritesCount": 0, "createdAt": "2023-08-25T02:39:53.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [ { "id": "2101057016571585008", "key": "3_2101057016571585008", "type": "photo", "url": "https://example.com/link-94089/profile-29900/media/sample-media-54339.jpg", "displayUrl": "pic.x.com/xH1k7HT2Nr", "expandedUrl": "https://x.com/sample_user_46213/status/2009780368692558740/photo/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-54339.jpg", "width": 1600, "height": 850, "aspectRatio": [ 32, 17 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 361, "resize": "fit" }, "medium": { "width": 1200, "height": 638, "resize": "fit" }, "large": { "width": 1600, "height": 850, "resize": "fit" }, "original": { "width": 1600, "height": 850, "resize": "fit" } }, "duration": null, "bitrate": null, "videoInfo": null, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [ { "x": 82, "y": 0, "width": 1518, "height": 850 }, { "x": 495, "y": 0, "width": 850, "height": 850 }, { "x": 547, "y": 0, "width": 746, "height": 850 }, { "x": 708, "y": 0, "width": 425, "height": 850 }, { "x": 0, "y": 0, "width": 1600, "height": 850 } ] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:59.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "9009199367413034868", "conversationId": "2001573686078201295", "text": "Sample post text 62813 for documentation.", "displayTextRange": [ 14, 121 ], "author": { "id": "1006913218670000037", "username": "sample_user_02212", "name": "Sample User 02212", "bio": "Sample profile bio for Sample User 02212.", "location": "Sample City 655", "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-22710.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-22710.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": false, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 21, "followingCount": 160, "tweetCount": 230, "listedCount": 0, "mediaCount": 71, "favoritesCount": 7010, "createdAt": "2024-05-16T00:06:19.000Z" }, "source": null, "type": "reply", "replyTo": { "tweetId": "2001573686078201295", "userId": "100746678925814491", "username": "sample_user_26682" }, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 4, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_26682" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:32.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001216828988273241", "conversationId": "5001216828988273241", "text": "Sample post text 39862 for documentation.", "displayTextRange": [ 0, 270 ], "author": { "id": "1001262580086398266", "username": "sample_user_37728", "name": "Sample User 37728", "bio": "Sample profile bio for Sample User 37728.", "location": null, "website": "https://example.com/link-94089/profile-29900/profile-36798", "pinnedTweetIds": [ "2001090050844781189" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-36798.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-36798.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 1549, "followingCount": 1205, "tweetCount": 5548, "listedCount": 6, "mediaCount": 167, "favoritesCount": 9138, "createdAt": "2023-06-27T20:17:13.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 1, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_21386" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:28.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5006577516378064115", "conversationId": "5006577516378064115", "text": "Sample post text 32321 for documentation.", "displayTextRange": [ 0, 62 ], "author": { "id": "1007661604825913954", "username": "sample_user_66029", "name": "Sample User 66029", "bio": "Sample profile bio for Sample User 66029.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-41470.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-41470.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": 172, "followingCount": 364, "tweetCount": 12320, "listedCount": 0, "mediaCount": 1703, "favoritesCount": 5710, "createdAt": "2020-11-09T05:05:27.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-41849", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [], "urls": [ "https://example.com/link-94089/link-66818" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:19.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008879394908672067", "conversationId": "5008879394908672067", "text": "Sample post text 57922 for documentation.", "displayTextRange": [ 0, 28 ], "author": { "id": "1001039304929179269", "username": "sample_user_42603", "name": "Sample User 42603", "bio": "Sample profile bio for Sample User 42603.", "location": "Sample City 083", "website": "https://example.com/link-94089/profile-29900/profile-92828", "pinnedTweetIds": [ "2002554639144518643" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-92828.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-92828.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": 1006, "followingCount": 1712, "tweetCount": 138935, "listedCount": 4, "mediaCount": 1956, "favoritesCount": 235206, "createdAt": "2018-08-23T01:56:31.000Z" }, "source": null, "type": "quote", "replyTo": null, "quotedTweet": { "id": "2001642373961442324", "conversationId": "2001642373961442324", "text": "Sample post text 06691 for documentation.", "displayTextRange": [ 0, 15 ], "author": { "id": "1001495759", "username": "sample_user_54259", "name": "Sample User 58027", "bio": "Sample profile bio for Sample User 58027.", "location": null, "website": "https://example.com/link-94089/profile-07928", "pinnedTweetIds": [ "2001642373961442324" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-52220.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-52220.jpg", "profileImageShape": "Square", "verified": false, "isBlueVerified": true, "verifiedType": "Business", "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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 4368218, "followingCount": 3, "tweetCount": 1411, "listedCount": 25012, "mediaCount": 405, "favoritesCount": 1057, "createdAt": "2015-12-06T22:51:08.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 19402, "retweetCount": 2191, "replyCount": 1457, "quoteCount": 3568, "bookmarkCount": 3659, "viewCount": 6710576, "media": [ { "id": "2101132363799776499", "key": "13_2101132363799776499", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-55908.jpg", "displayUrl": "pic.x.com/hy95wDM5nB", "expandedUrl": "https://x.com/sample_user_18536/status/2006083928193889095/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-25395.jpg", "width": 1920, "height": 1080, "aspectRatio": [ 16, 9 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 680, "height": 383, "resize": "fit" }, "medium": { "width": 1200, "height": 675, "resize": "fit" }, "large": { "width": 1920, "height": 1080, "resize": "fit" }, "original": { "width": 1920, "height": 1080, "resize": "fit" } }, "duration": 57, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-57037.jpg" }, { "bitrate": 256000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-33183.jpg" }, { "bitrate": 832000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-26115.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-79733.jpg" }, { "bitrate": 10368000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-55908.jpg" } ], "durationMillis": 57307 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-09-30T17:20:13.000Z", "place": null, "communityId": null, "communityResults": null }, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 0, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "pt", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:19.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5004929151247453424", "conversationId": "5004929151247453424", "text": "Sample post text 14872 for documentation.", "displayTextRange": [ 0, 221 ], "author": { "id": "1003804221844082443", "username": "sample_user_36814", "name": "Sample User 36814", "bio": "Sample profile bio for Sample User 36814.", "location": "Sample City 250", "website": "https://example.com/link-94089/profile-29900/profile-83358", "pinnedTweetIds": [ "2001573279169129162" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-83358.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-83358.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": 560, "followingCount": 691, "tweetCount": 12709, "listedCount": 5, "mediaCount": 380, "favoritesCount": 58607, "createdAt": "2022-03-19T15:52:14.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 3, "media": [ { "id": "2103649693116539206", "key": "13_2103649693116539206", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-00748.jpg", "displayUrl": "pic.x.com/ny4HtYAvdK", "expandedUrl": "https://x.com/sample_user_09075/status/2001696198575947122/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-71662.jpg", "width": 704, "height": 1280, "aspectRatio": [ 11, 20 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 374, "height": 680, "resize": "fit" }, "medium": { "width": 660, "height": 1200, "resize": "fit" }, "large": { "width": 704, "height": 1280, "resize": "fit" }, "original": { "width": 704, "height": 1280, "resize": "fit" } }, "duration": 10, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-89252.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-79058.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-28067.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-00748.jpg" } ], "durationMillis": 10000 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_54259" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:15.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5001554188176192868", "conversationId": "5001554188176192868", "text": "Sample post text 25754 for documentation.", "displayTextRange": [ 0, 60 ], "author": { "id": "10013772", "username": "sample_user_89359", "name": "Sample User 89359", "bio": "Sample profile bio for Sample User 89359.", "location": "Sample City 620", "website": "https://example.com/link-94089/profile-29900/profile-04427", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-04427.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-04427.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": 1055, "name": "Software developer/Programmer/Software engineer", "icon_name": "IconBriefcaseStroke" } ], "restId": "7004504897993851899" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 6438, "followingCount": 5704, "tweetCount": 14659, "listedCount": 52, "mediaCount": 1631, "favoritesCount": 6428, "createdAt": "2009-03-30T17:12:48.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 11, "media": [ { "id": "2109286855737966289", "key": "13_2109286855737966289", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-45213.jpg", "displayUrl": "pic.x.com/z0W9fdvlN2", "expandedUrl": "https://x.com/sample_user_64789/status/2005114975396498810/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-67722.jpg", "width": 1764, "height": 3840, "aspectRatio": [ 147, 320 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 312, "height": 680, "resize": "fit" }, "medium": { "width": 551, "height": 1200, "resize": "fit" }, "large": { "width": 941, "height": 2048, "resize": "fit" }, "original": { "width": 1764, "height": 3840, "resize": "fit" } }, "duration": 9, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-54878.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-67786.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-36467.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-78660.jpg" }, { "bitrate": 10368000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-19864.jpg" }, { "bitrate": 25128000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-45213.jpg" } ], "durationMillis": 9216 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [ "KTA", "XRGE" ], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:10.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5006746930774197474", "conversationId": "5006746930774197474", "text": "Sample post text 55289 for documentation.", "displayTextRange": [ 0, 84 ], "author": { "id": "10013529", "username": "sample_user_68590", "name": "Sample User 68590", "bio": "Sample profile bio for Sample User 68590.", "location": "Sample City 710", "website": "https://example.com/link-94089/profile-68590", "pinnedTweetIds": [ "2001762407330891999" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-78071.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-78071.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": {}, "defaultProfile": true, "defaultProfileImage": false, "followerCount": 45935, "followingCount": 207, "tweetCount": 252427, "listedCount": 2645, "mediaCount": 47782, "favoritesCount": 780, "createdAt": "2009-10-19T03:55:50.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 53, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-86282", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [ "sample_topic_50879" ], "mentions": [], "urls": [ "https://example.com/link-94089/link-93846" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:50:05.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5009136805748812647", "conversationId": "5009136805748812647", "text": "Sample post text 31021 for documentation.", "displayTextRange": [ 0, 154 ], "author": { "id": "100543486", "username": "sample_user_10916", "name": "Sample User 10916", "bio": "Sample profile bio for Sample User 10916.", "location": "Sample City 720", "website": "https://example.com/link-94089/profile-29900/profile-30812", "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-30812.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-30812.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": 580, "name": "Media & News Company", "icon_name": "IconBriefcaseStroke" } ], "restId": "7001622168107980317" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 1683069, "followingCount": 3, "tweetCount": 164941, "listedCount": 247, "mediaCount": 1276, "favoritesCount": 74, "createdAt": "2011-08-08T04:03:40.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 5, "media": [], "poll": null, "card": { "name": "", "url": "https://example.com/link-94089/profile-29900/link-09959", "cardType": "", "type": "summary", "bindingValues": { "title": "", "description": "", "domain": "", "thumbnailImageUrl": null, "thumbnailImageColor": null, "playerUrl": null, "playerWidth": null, "playerHeight": null, "appId": null, "appName": null, "appStarRating": null, "appPriceAmount": null, "appPriceCurrency": null }, "cardPlatform": { "platform": { "device": { "name": "", "version": "" }, "audience": { "name": "" } } }, "vanityUrl": null, "userRefsResults": null }, "hashtags": [], "mentions": [], "urls": [ "https://example.com/link-94089/link-23627" ], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "in", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:49:37.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "9001028373812893919", "conversationId": "2001696744712930648", "text": "Sample post text 39847 for documentation.", "displayTextRange": [ 38, 68 ], "author": { "id": "1004814509", "username": "sample_user_34726", "name": "Sample User 34726", "bio": "Sample profile bio for Sample User 34726.", "location": "Sample City 667", "website": "https://example.com/link-94089/profile-29900/profile-13489", "pinnedTweetIds": [ "2001277289522659615" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-13489.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-13489.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": false, "defaultProfileImage": false, "followerCount": 512, "followingCount": 2959, "tweetCount": 20036, "listedCount": 35, "mediaCount": 720, "favoritesCount": 69982, "createdAt": "2014-01-11T01:13:22.000Z" }, "source": null, "type": "reply", "replyTo": { "tweetId": "2001337828732899823", "userId": "100135036248701661", "username": "sample_user_47333" }, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 1, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_47333", "sample_user_92778", "sample_user_54259" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:49:32.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5008732295651308304", "conversationId": "5008732295651308304", "text": "Sample post text 35140 for documentation.", "displayTextRange": [ 0, 119 ], "author": { "id": "100158755", "username": "sample_user_45981", "name": "Sample User 45981", "bio": "Sample profile bio for Sample User 45981.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-05153.jpg", "banner": null, "profileImageShape": "Circle", "verified": false, "isBlueVerified": false, "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": "7003989198756046936" }, "businessAccount": null, "creatorSubscriptionsCount": 0, "hasHiddenSubscriptions": false, "highlightsInfo": null, "hasGraduatedAccess": true, "isProfileTranslatable": false, "hasCustomTimelines": true, "isTranslator": false, "affiliatesHighlightedLabel": {}, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 69, "followingCount": 162, "tweetCount": 581, "listedCount": 0, "mediaCount": 256, "favoritesCount": 668, "createdAt": "2010-07-18T01:41:14.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 52, "media": [ { "id": "2101084463759148771", "key": "13_2101084463759148771", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-87740.jpg", "displayUrl": "pic.x.com/5YZZvnYZv1", "expandedUrl": "https://x.com/sample_user_15998/status/2009616435460368306/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-31238.jpg", "width": 704, "height": 1280, "aspectRatio": [ 11, 20 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 374, "height": 680, "resize": "fit" }, "medium": { "width": 660, "height": 1200, "resize": "fit" }, "large": { "width": 704, "height": 1280, "resize": "fit" }, "original": { "width": 704, "height": 1280, "resize": "fit" } }, "duration": 10, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-16111.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-80227.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-93406.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-87740.jpg" } ], "durationMillis": 10100 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null }, { "id": "2101141470146145682", "key": "13_2101141470146145682", "type": "video", "url": "https://example.com/link-94089/profile-29900/media/sample-media-81963.jpg", "displayUrl": "pic.x.com/5YZZvnYZv1", "expandedUrl": "https://x.com/sample_user_15998/status/2009616435460368306/video/1", "thumbnailUrl": "https://example.com/link-94089/profile-29900/media/sample-media-13591.jpg", "width": 704, "height": 1280, "aspectRatio": [ 11, 20 ], "sizes": { "thumb": { "width": 150, "height": 150, "resize": "crop" }, "small": { "width": 374, "height": 680, "resize": "fit" }, "medium": { "width": 660, "height": 1200, "resize": "fit" }, "large": { "width": 704, "height": 1280, "resize": "fit" }, "original": { "width": 704, "height": 1280, "resize": "fit" } }, "duration": 10, "bitrate": null, "videoInfo": { "variants": [ { "bitrate": 0, "contentType": "application/x-mpegURL", "url": "https://example.com/link-94089/profile-29900/media/sample-media-80720.jpg" }, { "bitrate": 632000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-43086.jpg" }, { "bitrate": 950000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-99396.jpg" }, { "bitrate": 2176000, "contentType": "video/mp4", "url": "https://example.com/link-94089/profile-29900/media/sample-media-81963.jpg" } ], "durationMillis": 10100 }, "altText": null, "sensitiveMedia": false, "features": { "all": [], "large": [], "medium": [], "small": [], "orig": [ { "faces": [] } ] }, "mediaAvailability": { "status": "Available", "reason": null }, "allowDownload": true, "mediaStats": null, "processingInfo": null, "sourceStatusId": null, "sourceUserId": null, "stickers": null } ], "poll": null, "card": null, "hashtags": [ "sample_topic_32478" ], "mentions": [ "sample_user_54259" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "es", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:49:24.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "5003846751207294437", "conversationId": "5003846751207294437", "text": "Sample post text 95756 for documentation.", "displayTextRange": [ 0, 25 ], "author": { "id": "1006086146937944330", "username": "sample_user_21375", "name": "Sample User 21375", "bio": "Sample profile bio for Sample User 21375.", "location": null, "website": "https://example.com/link-94089/profile-29900/profile-88542", "pinnedTweetIds": [ "2001518738021086670" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-88542.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-88542.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": false, "defaultProfileImage": false, "followerCount": 668, "followingCount": 1029, "tweetCount": 12626, "listedCount": 11, "mediaCount": 3839, "favoritesCount": 72610, "createdAt": "2018-06-25T06:59:47.000Z" }, "source": null, "type": "tweet", "replyTo": null, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 0, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 6, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": true, "lang": "ja", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:49:22.000Z", "place": null, "communityId": null, "communityResults": null }, { "id": "9007428986762710781", "conversationId": "2001696744712930648", "text": "Sample post text 61896 for documentation.", "displayTextRange": [ 24, 52 ], "author": { "id": "1004814509", "username": "sample_user_34726", "name": "Sample User 34726", "bio": "Sample profile bio for Sample User 34726.", "location": "Sample City 667", "website": "https://example.com/link-94089/profile-29900/profile-13489", "pinnedTweetIds": [ "2001277289522659615" ], "avatar": "https://example.com/link-94089/profile-29900/images/sample-avatar-13489.jpg", "banner": "https://example.com/link-94089/profile-29900/images/sample-banner-13489.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": false, "defaultProfileImage": false, "followerCount": 512, "followingCount": 2959, "tweetCount": 20036, "listedCount": 35, "mediaCount": 720, "favoritesCount": 69982, "createdAt": "2014-01-11T01:13:22.000Z" }, "source": null, "type": "reply", "replyTo": { "tweetId": "2001696744712930648", "userId": "100135036248701661", "username": "sample_user_47333" }, "quotedTweet": null, "retweetedTweet": null, "reactionContext": { "isReaction": true, "targetTweetId": "2000000000000000001", "targetTweetUrl": "https://x.com/sample_user_00001/status/2000000000000000001", "targetAuthor": { "id": "1000000000000000001", "username": "sample_user_00001", "name": "Sample User 00001", "avatar": "https://example.com/images/sample-avatar-00001.jpg", "isBlueVerified": true } }, "likeCount": 1, "retweetCount": 0, "replyCount": 0, "quoteCount": 0, "bookmarkCount": 0, "viewCount": 6, "media": [], "poll": null, "card": null, "hashtags": [], "mentions": [ "sample_user_47333", "sample_user_54259" ], "urls": [], "symbols": [], "possiblySensitive": false, "limitedActions": null, "isEdited": false, "editControl": null, "isTranslatable": false, "lang": "en", "translatedText": null, "hasBirdwatchNotes": false, "birdwatchPivot": null, "conversationControl": null, "isPromoted": false, "promotedMetadata": null, "createdAt": "2025-10-02T05:49:06.000Z", "place": null, "communityId": null, "communityResults": null } ], "pagination": { "nextCursor": "DAADDAABCgABG2O7Uf4aIc4KAAIbY7qj5NYQXgAIAAIAAAACCAADAAAAAAgABAAAAAAKAAUbY7tYYkAnEAoABhtju1hiP9jwAAA", "prevCursor": "DAADDAABCgABG2O7Uf4aIc4KAAIbY7qj5NYQXgAIAAIAAAABCAADAAAAAAgABAAAAAAKAAUbY7tYYkAnEAoABhtju1hiP9jwAAA" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "read-only", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "query", "in": "query", "required": true, "description": "Search query string. Supports advanced search operators.", "schema": { "type": "string", "minLength": 1, "maxLength": 512 }, "example": "open source intelligence" }, { "name": "type", "in": "query", "required": true, "description": "Type of search results (Latest, Top, People, Photos, Videos)", "schema": { "type": "string", "enum": [ "Top", "Latest", "People", "Photos", "Videos" ] }, "example": "Latest" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for fetching next page of results. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" } ] } }, "/tw-v2/auth/login": { "post": { "tags": [ "Authentication (credentials)" ], "summary": "[CREDENTIALS] Login", "description": "Authenticate a platform account and retrieve session cookies for use with interaction endpoints. A successful response consumes 50 request units. Rate limited to 60 requests per minute.", "operationId": "postAuthLogin", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginResponse" }, "example": { "status": "success", "data": { "cookies": { "auth_token": "YOUR_AUTH_TOKEN", "ct0": "YOUR_CT0_TOKEN", "twid": "YOUR_TWID_COOKIE", "kdt": "YOUR_KDT_TOKEN", "__cf_bm": "YOUR_CF_BM_COOKIE" }, "user": { "id": "1009530492076271", "username": "exampleUser", "name": "Sample User 82107" }, "timestamp": "2025-11-28T10:41:10.196Z" } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" }, "502": { "$ref": "#/components/responses/LoginProxyFailure" }, "503": { "$ref": "#/components/responses/LoginRuntimeUnavailable" } }, "x-tweetapi-safety": "credential-operation", "x-tweetapi-requires-twitter-auth": false, "x-tweetapi-request-cost": 50, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" }, "example": { "username": "sample_user", "password": "YOUR_PASSWORD", "proxy": "proxy.example.com:8080@username:password", "country": "US" } } } } } }, "/tw-v2/xchat/setup": { "post": { "tags": [ "XChat (encrypted messaging)" ], "summary": "[CREDENTIALS] Setup", "description": "Initialize X Chat (encrypted DMs) for your account. This is a required first step before sending encrypted messages. You must have X Chat already set up in the official app before using this endpoint.", "operationId": "postXchatSetup", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatSetupResponse" }, "example": { "status": "ready", "userId": "1001937475184068444", "publicKeyVersion": "1763729043842", "message": "Sample post text 61903 for documentation." } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "credential-operation", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatSetupRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "userId": "1234567890", "pin": "1234" } } } } } }, "/tw-v2/xchat/conversations": { "post": { "tags": [ "XChat (encrypted messaging)" ], "summary": "[AUTHENTICATED READ] Conversations", "description": "Get a list of all X Chat conversations in your inbox. Returns conversation metadata including participants and timestamps. This endpoint does not require /xchat/setup since it only returns metadata, not decrypted message content.", "operationId": "postXchatConversations", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatConversationsResponse" }, "example": { "conversations": [ { "conversationId": "1234567890:9876543210", "participants": [ { "userId": "9876543210", "name": "Sample User 00001", "screenName": "sample_user_00001" } ], "lastMessageTimestamp": 1769173580397, "type": "one_to_one" }, { "conversationId": "g5001680743694518742", "participants": [ { "userId": "1234567890", "name": "Sample User 00002", "screenName": "sample_user_00002" }, { "userId": "9876543210", "name": "Sample User 00001", "screenName": "sample_user_00001" } ], "lastMessageTimestamp": 1768483844743, "type": "group" } ], "cursor": "50", "graphSnapshotId": "bf0310dd-d428-4de1-9815-435bc90061686" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatConversationsRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN" } } } } } }, "/tw-v2/xchat/send": { "post": { "tags": [ "XChat (encrypted messaging)" ], "summary": "[DM WRITE] Send", "description": "Send an end-to-end encrypted direct message via X Chat. Prerequisite - You must call /xchat/setup first before sending messages.", "operationId": "postXchatSend", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatSendResponse" }, "example": { "messageId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "conversationId": "5003555930970613276:9876543210987654321", "timestamp": 1768479256916, "status": "sent", "recipientId": "9876543210987654321", "mode": "e2e", "retried": true } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "direct-message-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 10, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatSendRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "recipientId": "9876543210", "message": "Hello from TweetAPI" } } } } } }, "/tw-v2/xchat/history": { "post": { "tags": [ "XChat (encrypted messaging)" ], "summary": "[AUTHENTICATED READ] History", "description": "Get decrypted conversation history for an end-to-end encrypted X Chat conversation. Returns messages in decrypted plaintext with metadata. Prerequisite - You must call /xchat/setup first before fetching history.", "operationId": "postXchatHistory", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatHistoryResponse" }, "example": { "messages": [ { "id": "9001544816401953968", "messageId": "72afe3e1-38c7-4b4b-9e45-b90062753a2d", "senderId": "9003955120589863651", "text": "Sample post text 97144 for documentation.", "timestamp": 1736847291525, "conversationKeyVersion": "1768394917884" }, { "id": "9005519788019736223", "messageId": "7b9effa8-5f40-45d8-ba5f-c71ca4852a75", "senderId": "9876543210987654321", "text": "Sample post text 04843 for documentation.", "timestamp": 1736847190973, "conversationKeyVersion": "1768394917884" } ], "hasMore": true, "nextCursor": "9005519788019736223" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatHistoryRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "conversationId": "1234567890-9876543210" } } } } } }, "/tw-v2/xchat/can-dm": { "post": { "tags": [ "XChat (encrypted messaging)" ], "summary": "[AUTHENTICATED READ] Can Dm", "description": "Check if users can receive X Chat encrypted DMs. Returns chat permissions including whether they have X Chat enabled and a public key for encryption. Use this endpoint to verify recipients before attempting to send encrypted messages.", "operationId": "postXchatCanDm", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatCanDmResponse" }, "example": { "users": [ { "id": "1001937475184068444", "status": "Found", "name": "Sample User 35037", "screenName": "sample_user_35037", "avatarUrl": "https://example.com/images/sample-avatar-35037.jpg", "chatPermissions": { "canDm": true, "canDmOnXChat": true, "hasPublicKey": true, "canBeAddedToGroup": false }, "isProtected": false, "isSuspended": false, "isBlueVerified": false, "isVerified": false } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/XChatCanDmRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "userIds": [ "1234567890" ] } } } } } }, "/tw-v2/interaction/send-dm": { "post": { "tags": [ "Direct Messages (legacy)" ], "summary": "[DM WRITE] Send Dm", "description": "Send a direct message to a user with optional media attachment. Supports images, GIFs, and videos with automatic type detection and processing. Maximum 1 media item per DM.", "operationId": "postInteractionSendDm", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmSendResponse" }, "example": { "message": { "id": "9001332935717444612", "conversationId": "1000000000000000001-1000000000000000002", "senderId": "1000000000000000001", "recipientId": "1000000000000000002", "text": "Sample post text 28308 for documentation.", "createdAt": "2024-02-01T14:00:00.000Z", "requestId": "90038499-0000-0000-0000-900385308020", "editCount": 0 }, "users": [ { "id": "1000000000000000001", "username": "user_one", "name": "Sample User 46694", "bio": "Sample description for documentation 43558.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29517.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 100, "followingCount": 50, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-01-01T00:00:00.000Z" }, { "id": "1000000000000000002", "username": "user_two", "name": "Sample User 13614", "bio": "Sample description for documentation 30386.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29600.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 200, "followingCount": 150, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-02-01T00:00:00.000Z" } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "direct-message-write", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendDmRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "conversationId": "1234567890-9876543210", "text": "Hello from TweetAPI", "proxy": "proxy.example.com:8080@username:password" } } } } } }, "/tw-v2/interaction/dm-permissions": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Dm Permissions", "description": "Check if you can send direct messages to specific users. Verifies DM permissions for up to 50 recipient IDs at once.", "operationId": "getInteractionDmPermissions", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmPermissionsResponse" }, "example": { "permissions": [ { "userId": "10016309", "canDm": false, "errorCode": 349 }, { "userId": "10017528", "canDm": false, "errorCode": 349 } ], "users": [ { "id": "10016309", "username": "sample_user_59576", "name": "Sample User 59576", "bio": "Sample profile bio for Sample User 59576.", "location": null, "website": "https://example.com/profile-59576", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-59576.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 40162971, "followingCount": 120, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2009-04-23T21:53:30.000Z" }, { "id": "10017528", "username": "sample_user_96991", "name": "Sample User 96991", "bio": "", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-96991.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 227683330, "followingCount": 1220, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2009-06-02T20:12:29.000Z" } ] } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "recipientIds", "in": "query", "required": true, "description": "Comma-separated list of user IDs to check (max 50 IDs, e.g., '123456789,987654321')", "schema": { "type": "string", "minLength": 1, "pattern": "^\\d+(,\\d+){0,49}$" }, "example": "9876543210" }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/inbox-initial-state": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Inbox Initial State", "description": "Get the initial state of your DM inbox. Returns conversations, messages, user data, and inbox timeline cursors for pagination. Use the returned cursor for polling updates via dm-user-updates endpoint.", "operationId": "getInteractionInboxInitialState", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmInboxResponse" }, "example": { "conversations": [ { "id": "1234567890-9876543210", "type": "ONE_TO_ONE", "participants": [ "1234567890", "9876543210" ], "lastMessageId": "5003095839008393364", "lastMessageTime": "2024-08-04T07:00:14.115Z", "lastReadMessageId": "5001119709765224649", "trusted": true, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false }, { "id": "9876543210-5555555555", "type": "ONE_TO_ONE", "participants": [ "9876543210", "5555555555" ], "lastMessageId": "5007772619049708366", "lastMessageTime": "2024-10-10T17:11:43.250Z", "lastReadMessageId": "0", "trusted": false, "muted": false, "readOnly": false, "lowQuality": true, "nsfw": false, "notificationsDisabled": false } ], "messages": [ { "id": "9001773380324071094", "conversationId": "1234567890-9876543210", "senderId": "1234567890", "recipientId": "9876543210", "text": "Sample post text 69685 for documentation.", "createdAt": "2024-08-04T07:00:14.000Z", "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "editCount": 0 }, { "id": "9002107545067596446", "conversationId": "1234567890-9876543210", "senderId": "9876543210", "recipientId": "1234567890", "text": "Sample post text 99582 for documentation.", "createdAt": "2024-08-04T07:01:30.000Z", "requestId": "b2c3d4e5-f6a7-8901-bcde-f90011496206", "editCount": 0, "replyTo": { "messageId": "9005722626798165465", "text": "Sample post text 69685 for documentation." } }, { "id": "9006924863278004687", "conversationId": "1234567890-9876543210", "senderId": "1234567890", "recipientId": "9876543210", "text": "Sample post text 84623 for documentation.", "createdAt": "2024-08-04T07:05:00.000Z", "requestId": "c3d4e5f6-a7b8-9012-cdef-900145354256", "editCount": 0, "entities": { "urls": [ { "url": "https://example.com/link-82642", "expandedUrl": "https://x.com/sample_user_78339/media/4444444444444444444", "displayUrl": "pic.x.com/example123" } ], "mentions": [], "hashtags": [] }, "attachment": { "type": "photo", "photo": { "id": "9007928766413753864", "url": "https://example.com/media/photo123.jpg", "width": 1200, "height": 800 } } }, { "id": "9001525177757834681", "conversationId": "9876543210-5555555555", "senderId": "5555555555", "recipientId": "9876543210", "text": "Sample post text 21652 for documentation.", "createdAt": "2024-10-10T17:11:43.000Z", "requestId": "d4e5f6a7-b8c9-0123-def1-900162319730", "editCount": 0, "entities": { "urls": [ { "url": "https://example.com/link-11299", "expandedUrl": "https://example.com/link-94089", "displayUrl": "example.com" } ], "mentions": [], "hashtags": [] } } ], "users": [ { "id": "1234567890", "username": "john_doe", "name": "Sample User 21747", "bio": "Sample description for documentation 73203.", "location": "Sample City 459", "website": "https://example.com/profile-29900", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-06597.jpg", "banner": "https://example.com/images/sample-banner-70273.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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 1523, "followingCount": 892, "tweetCount": 456, "listedCount": 12, "mediaCount": 89, "favoritesCount": 3456, "createdAt": "2020-01-15T10:30:00.000Z" }, { "id": "9876543210", "username": "jane_smith", "name": "Sample User 93347", "bio": "Sample description for documentation 01890.", "location": "Sample City 196", "website": "https://example.com/profile-24546", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-50289.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 2341, "followingCount": 567, "tweetCount": 789, "listedCount": 23, "mediaCount": 145, "favoritesCount": 5678, "createdAt": "2019-03-20T14:22:00.000Z" } ], "inboxTimelines": { "trusted": { "status": "AT_END", "min_entry_id": "9001287423245354173" }, "untrusted": { "status": "HAS_MORE", "min_entry_id": "9002002559038635925" }, "untrustedLowQuality": { "status": "HAS_MORE", "min_entry_id": "9001584235130441450" } }, "cursor": "GRwm5ILd5ZzonfM2FtiF3umk5p_zNiUCAAA", "lastSeenEventId": "9001414306093561866" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/inbox-timeline-trusted": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Inbox Timeline Trusted", "description": "Get paginated trusted conversations timeline. Use the cursor from inbox-initial-state or previous response to fetch next page of trusted DM conversations.", "operationId": "getInteractionInboxTimelineTrusted", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmTimelineResponse" }, "example": { "conversations": [ { "id": "1000000000000000001-1000000000000000002", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "1000000000000000002" ], "lastMessageId": "5001707222994272980", "lastMessageTime": "2024-01-15T10:30:00.000Z", "lastReadMessageId": "5001234266107326422", "trusted": true, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false, "minEntryId": "5001479058437675928", "maxEntryId": "5002571843532004892" }, { "id": "1000000000000000001-1000000000000000003", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "1000000000000000003" ], "lastMessageId": "5005300471952788022", "lastMessageTime": "2024-01-15T11:00:00.000Z", "lastReadMessageId": "5005969340899589160", "trusted": true, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false, "minEntryId": "5001134570415305042", "maxEntryId": "5006568201408666421" } ], "messages": [ { "id": "9006176755606125751", "conversationId": "1000000000000000001-1000000000000000002", "senderId": "1000000000000000002", "recipientId": "1000000000000000001", "text": "Sample post text 33662 for documentation.", "createdAt": "2024-01-15T10:30:00.000Z", "requestId": "90014876-0000-0000-0000-900107645799", "editCount": 0 }, { "id": "9007522213851919025", "conversationId": "1000000000000000001-1000000000000000003", "senderId": "1000000000000000003", "recipientId": "1000000000000000001", "text": "Sample post text 49691 for documentation.", "createdAt": "2024-01-15T11:00:00.000Z", "requestId": "90055057-0000-0000-0000-900107557965", "editCount": 0 } ], "users": [ { "id": "1000000000000000001", "username": "user_one", "name": "Sample User 46694", "bio": "Sample description for documentation 43558.", "location": null, "website": "https://example.com/profile-29900", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29517.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 100, "followingCount": 50, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-01-01T00:00:00.000Z" }, { "id": "1000000000000000002", "username": "user_two", "name": "Sample User 13614", "bio": "Sample description for documentation 30386.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29600.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 200, "followingCount": 150, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-02-01T00:00:00.000Z" } ], "status": "HAS_MORE", "cursor": "2000000000000000002" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "cursor", "in": "query", "required": true, "description": "Cursor for pagination. Get from inbox-initial-state or previous response.", "schema": { "$ref": "#/components/schemas/Cursor" }, "example": "NEXT_CURSOR" }, { "name": "filterLowQuality", "in": "query", "required": false, "description": "Filter out low quality conversations (default false)", "schema": { "type": "boolean", "default": false }, "example": false }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/inbox-timeline-untrusted": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Inbox Timeline Untrusted", "description": "Get paginated untrusted/filtered conversations timeline. Use the cursor from inbox-initial-state or previous response to fetch next page of untrusted DM conversations (message requests).", "operationId": "getInteractionInboxTimelineUntrusted", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmTimelineResponse" }, "example": { "conversations": [ { "id": "1000000000000000001-5004585823510272994", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "3000000000000000001" ], "lastMessageId": "5001670586752529915", "lastMessageTime": "2024-01-20T08:15:00.000Z", "lastReadMessageId": "0", "trusted": false, "muted": false, "readOnly": false, "lowQuality": true, "nsfw": false, "notificationsDisabled": false, "minEntryId": "5005457424925332938", "maxEntryId": "5009892784880439614" }, { "id": "1000000000000000001-5001428740009130829", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "3000000000000000002" ], "lastMessageId": "5003538100870035077", "lastMessageTime": "2024-01-20T09:30:00.000Z", "lastReadMessageId": "0", "trusted": false, "muted": false, "readOnly": false, "lowQuality": true, "nsfw": false, "notificationsDisabled": false, "minEntryId": "5006944595623460814", "maxEntryId": "5001102949690647185" } ], "messages": [ { "id": "9001694137895488171", "conversationId": "1000000000000000001-5004506354069604738", "senderId": "9008873284235934057", "recipientId": "1000000000000000001", "text": "Sample post text 82899 for documentation.", "createdAt": "2024-01-20T08:15:00.000Z", "requestId": "90014876-0000-0000-0000-900130475010", "editCount": 0 }, { "id": "9001307642169108004", "conversationId": "1000000000000000001-5002427105908339698", "senderId": "9005894147850226903", "recipientId": "1000000000000000001", "text": "Sample post text 64427 for documentation.", "createdAt": "2024-01-20T09:30:00.000Z", "editCount": 0, "entities": { "urls": [ { "url": "https://example.com/link-82642", "expandedUrl": "https://example.com/invite", "displayUrl": "example.com/invite" } ], "mentions": [], "hashtags": [] } } ], "users": [ { "id": "1006283874534263200", "username": "spam_user_one", "name": "Sample User 05071", "bio": "Sample profile bio for Sample User 05071.", "location": null, "website": "https://example.com/profile-05071", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-05071.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 10, "followingCount": 5000, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2024-01-15T00:00:00.000Z" }, { "id": "1003534757121356123", "username": "spam_user_two", "name": "Sample User 38838", "bio": "Sample profile bio for Sample User 38838.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-38838.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 5, "followingCount": 8000, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2024-01-18T00:00:00.000Z" } ], "status": "HAS_MORE", "cursor": "4000000000000000002" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "cursor", "in": "query", "required": true, "description": "Cursor for pagination. Get from inbox-initial-state or previous response.", "schema": { "$ref": "#/components/schemas/Cursor" }, "example": "NEXT_CURSOR" }, { "name": "filterLowQuality", "in": "query", "required": false, "description": "Filter out low quality conversations (default false)", "schema": { "type": "boolean", "default": false }, "example": false }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/conversation": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Conversation", "description": "Get messages from a specific DM conversation. Returns conversation details, messages, and user data. Supports pagination with cursor for loading message history.", "operationId": "getInteractionConversation", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmConversationResponse" }, "example": { "messages": [ { "id": "9006733400162260391", "conversationId": "1000000000000000001-1000000000000000002", "senderId": "1000000000000000002", "recipientId": "1000000000000000001", "text": "Sample post text 08364 for documentation.", "createdAt": "2024-01-25T10:00:00.000Z", "requestId": "90064759-0000-0000-0000-900116921965", "editCount": 0 }, { "id": "9003042327307850361", "conversationId": "1000000000000000001-1000000000000000002", "senderId": "1000000000000000002", "recipientId": "1000000000000000001", "text": "Sample post text 21631 for documentation.", "createdAt": "2024-01-25T10:15:00.000Z", "requestId": "90018442-0000-0000-0000-900157893048", "editCount": 0, "entities": { "urls": [ { "url": "https://example.com/link-11299", "expandedUrl": "https://x.com/sample_user_78339/media/5000000000000000002", "displayUrl": "pic.x.com/example456" } ], "mentions": [], "hashtags": [] }, "attachment": { "type": "photo", "photo": { "id": "9001495456570568196", "url": "https://example.com/dm/photo.jpg", "width": 800, "height": 600 } } } ], "users": [ { "id": "1000000000000000001", "username": "user_one", "name": "Sample User 46694", "bio": "Sample description for documentation 43558.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29517.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 100, "followingCount": 50, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-01-01T00:00:00.000Z" }, { "id": "1000000000000000002", "username": "user_two", "name": "Sample User 13614", "bio": "Sample description for documentation 30386.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29600.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 200, "followingCount": 150, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-02-01T00:00:00.000Z" } ], "conversationInfo": { "id": "1000000000000000001-1000000000000000002", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "1000000000000000002" ], "lastMessageId": "5001599980572161174", "lastMessageTime": "2024-01-25T10:15:00.000Z", "lastReadMessageId": "5001407820428757794", "trusted": true, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false }, "hasMore": false } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "conversationId", "in": "query", "required": true, "description": "Conversation ID. For 1-on-1 conversations: 'userId1-userId2' (e.g., '123456789-987654321'). For group conversations: single conversation ID (e.g., '1234567890')", "schema": { "type": "string", "minLength": 1, "pattern": "^(\\d+-\\d+|\\d+|g\\d+)$" }, "example": "1234567890-9876543210" }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor for loading older messages. Obtained from previous response.", "schema": { "type": "string" }, "example": "NEXT_CURSOR" }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/dm-user-updates": { "get": { "tags": [ "Direct Messages (legacy)" ], "summary": "[AUTHENTICATED READ] Dm User Updates", "description": "Poll for new DM updates and changes. Use the cursor from inbox-initial-state or previous dm-user-updates response to check for new messages, conversations, and updates. Ideal for real-time DM monitoring.", "operationId": "getInteractionDmUserUpdates", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DmUpdatesResponse" }, "example": { "messages": [ { "id": "9003983800335676473", "conversationId": "1000000000000000001-1000000000000000002", "senderId": "1000000000000000002", "recipientId": "1000000000000000001", "text": "Sample post text 05814 for documentation.", "createdAt": "2024-01-30T11:30:00.000Z", "requestId": "90064759-0000-0000-0000-900257883985", "editCount": 0 }, { "id": "9001391839799285341", "conversationId": "1000000000000000002-5002247610892258097", "senderId": "9001569368885517319", "recipientId": "1000000000000000002", "text": "Sample post text 80540 for documentation.", "createdAt": "2024-01-30T12:00:00.000Z", "requestId": "90018442-0000-0000-0000-900134183329", "editCount": 0, "entities": { "urls": [ { "url": "https://example.com/link-72694", "expandedUrl": "https://example.com/investment", "displayUrl": "example.com/investment" } ], "mentions": [], "hashtags": [] } } ], "conversations": [ { "id": "1000000000000000001-1000000000000000002", "type": "ONE_TO_ONE", "participants": [ "1000000000000000001", "1000000000000000002" ], "lastMessageId": "5005463647063278908", "lastMessageTime": "2024-01-30T11:30:00.000Z", "lastReadMessageId": "5001284882584811901", "trusted": true, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false }, { "id": "1000000000000000002-5007338668997589419", "type": "ONE_TO_ONE", "participants": [ "1000000000000000002", "3000000000000000001" ], "lastMessageId": "5001777349635958333", "lastMessageTime": "2024-01-30T12:00:00.000Z", "lastReadMessageId": "0", "trusted": false, "muted": false, "readOnly": false, "lowQuality": false, "nsfw": false, "notificationsDisabled": false } ], "users": [ { "id": "1000000000000000001", "username": "user_one", "name": "Sample User 46694", "bio": "Sample description for documentation 43558.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29517.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 100, "followingCount": 50, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-01-01T00:00:00.000Z" }, { "id": "1000000000000000002", "username": "user_two", "name": "Sample User 13614", "bio": "Sample description for documentation 30386.", "location": null, "website": null, "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-29600.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 200, "followingCount": 150, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2020-02-01T00:00:00.000Z" }, { "id": "1006283874534263200", "username": "spam_user_one", "name": "Sample User 05071", "bio": "Sample profile bio for Sample User 05071.", "location": null, "website": "https://example.com/profile-05071", "pinnedTweetIds": [], "avatar": "https://example.com/images/sample-avatar-05071.jpg", "banner": null, "profileImageShape": null, "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": false, "isProfileTranslatable": false, "hasCustomTimelines": false, "isTranslator": false, "affiliatesHighlightedLabel": null, "defaultProfile": false, "defaultProfileImage": false, "followerCount": 10, "followingCount": 5000, "tweetCount": 0, "listedCount": 0, "mediaCount": 0, "favoritesCount": 0, "createdAt": "2024-01-15T00:00:00.000Z" } ], "cursor": "GRwm5ILd5ZzonfM2FoLE3cGWpLzzNiUEAAA", "lastSeenEventId": "9001536030064760316", "minEntryId": "9007599858500427158", "maxEntryId": "9001583205518383921" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "authenticated-read", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "parameters": [ { "name": "authToken", "in": "query", "required": true, "description": "Account authentication token (auth_token cookie value)", "schema": { "$ref": "#/components/schemas/AuthToken" }, "example": "YOUR_AUTH_TOKEN" }, { "name": "cursor", "in": "query", "required": true, "description": "Update cursor from inbox-initial-state or previous dm-user-updates response. Required for polling.", "schema": { "$ref": "#/components/schemas/Cursor" }, "example": "NEXT_CURSOR" }, { "name": "proxy", "in": "query", "required": false, "description": "Optional proxy in format 'host:port@user:pass'", "schema": { "$ref": "#/components/schemas/Proxy" }, "example": "proxy.example.com:8080@username:password" } ] } }, "/tw-v2/interaction/accept-conversation": { "post": { "tags": [ "Direct Messages (legacy)" ], "summary": "[ACCOUNT ACTION] Accept Conversation", "description": "Accept an untrusted DM conversation (message request). Moves the conversation from the untrusted inbox to the trusted inbox, allowing future messages from the sender. This is the equivalent of clicking \"Accept\" on a message request in the web UI.", "operationId": "postInteractionAcceptConversation", "security": [ { "TweetApiKey": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActionResponse" }, "example": { "data": { "id": "123456789-987654321", "action": "accept_conversation", "timestamp": "2026-04-01T14:00:00.000Z", "success": true, "metadata": { "conversation_id": "123456789-987654321" } } } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/ServerError" } }, "x-tweetapi-safety": "account-action", "x-tweetapi-requires-twitter-auth": true, "x-tweetapi-request-cost": 1, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptConversationRequest" }, "example": { "authToken": "YOUR_AUTH_TOKEN", "conversationId": "1234567890-9876543210" } } } } } } }, "components": { "securitySchemes": { "TweetApiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "API key from the TweetAPI dashboard. Keep this value private." } }, "responses": { "BadRequest": { "description": "Request validation failed or the upstream request was invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 400, "message": "Request validation failed" } } } }, "Unauthorized": { "description": "The TweetAPI key or caller-supplied Twitter authentication token is missing or invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 401, "message": "No API key provided" } } } }, "Forbidden": { "description": "The authenticated account is not permitted to perform the operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 403, "message": "Forbidden" } } } }, "NotFound": { "description": "The requested resource or route was not found.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 404, "message": "Not found" } } } }, "TooManyRequests": { "description": "The per-minute rate limit or plan request allowance was exceeded. The response does not currently include Retry-After or X-RateLimit headers.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 429, "message": "Rate limit quota exceeded" } } } }, "ServerError": { "description": "TweetAPI or an upstream dependency failed to process the request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 500, "message": "Internal Server Error" } } } }, "LoginProxyFailure": { "description": "The login request could not be completed through the provided proxy.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 502, "message": "Login proxy request failed" } } } }, "LoginRuntimeUnavailable": { "description": "The login runtime or token provider is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "statusCode": 503, "message": "Login runtime is temporarily unavailable" } } } } }, "schemas": { "ErrorResponse": { "type": "object", "description": "Error envelope returned by customer-facing /tw-v2 routes.", "required": [ "statusCode", "message" ], "properties": { "statusCode": { "type": "integer", "format": "int32" }, "message": { "type": "string" } }, "additionalProperties": false }, "SnowflakeId": { "type": "string", "pattern": "^\\d+$", "example": "1234567890" }, "Cursor": { "type": "string", "minLength": 1, "description": "Opaque pagination cursor returned by a previous response." }, "AuthToken": { "type": "string", "minLength": 1, "writeOnly": true, "example": "YOUR_AUTH_TOKEN", "description": "Caller-supplied auth_token cookie value. Treat it as a secret." }, "Proxy": { "type": "string", "pattern": "^[^:@]+:\\d+@[^:]+:.+$", "writeOnly": true, "example": "proxy.example.com:8080@username:password" }, "Pagination": { "type": "object", "required": [ "nextCursor", "prevCursor" ], "properties": { "nextCursor": { "type": "string", "nullable": true }, "prevCursor": { "type": "string", "nullable": true } }, "additionalProperties": false }, "TweetTranslationRequest": { "type": "object", "required": [ "tweetId", "dstLang" ], "properties": { "tweetId": { "$ref": "#/components/schemas/SnowflakeId" }, "dstLang": { "type": "string", "minLength": 2, "maxLength": 5 } } }, "CreateListRequest": { "type": "object", "required": [ "authToken", "name" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "name": { "type": "string", "minLength": 1, "maxLength": 25 }, "description": { "type": "string", "maxLength": 100, "default": "" }, "isPrivate": { "type": "boolean", "default": true } } }, "ListMemberRequest": { "type": "object", "required": [ "authToken", "listId", "userId" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "listId": { "$ref": "#/components/schemas/SnowflakeId" }, "userId": { "$ref": "#/components/schemas/SnowflakeId" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "ReplyOption": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "type": "string", "enum": [ "everyone", "accounts_you_follow", "accounts_you_follow_and_followed", "mentioned_accounts", "verified_accounts", "regions" ] }, "regions": { "type": "array", "minItems": 1, "items": { "type": "string", "enum": [ "NAM", "EAS", "AFR", "SEA", "SAM", "EUR", "AUS", "SAS", "WES", "CAS" ] } } }, "description": "regions is required only when mode is regions and is rejected for every other mode." }, "TweetMediaInput": { "oneOf": [ { "type": "object", "required": [ "media_id" ], "properties": { "media_id": { "$ref": "#/components/schemas/SnowflakeId" } }, "additionalProperties": false }, { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp", "image/gif", "video/mp4", "video/quicktime", "video/mpeg", "video/x-m4v", "video/x-ms-wmv", "video/x-msvideo", "video/webm" ] } }, "additionalProperties": false }, { "type": "object", "required": [ "data", "type" ], "properties": { "data": { "type": "string", "format": "byte", "writeOnly": true }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp", "image/gif", "video/mp4", "video/quicktime", "video/mpeg", "video/x-m4v", "video/x-ms-wmv", "video/x-msvideo", "video/webm" ] } }, "additionalProperties": false } ] }, "ProfileMediaInput": { "oneOf": [ { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp" ] } }, "additionalProperties": false }, { "type": "object", "required": [ "data", "type" ], "properties": { "data": { "type": "string", "format": "byte", "writeOnly": true }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp" ] } }, "additionalProperties": false } ] }, "DmMediaInput": { "oneOf": [ { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp", "image/gif", "video/mp4", "video/quicktime", "video/mpeg", "video/x-m4v", "video/x-ms-wmv", "video/x-msvideo", "video/webm" ] } } }, { "type": "object", "required": [ "data", "type" ], "properties": { "data": { "type": "string", "format": "byte", "writeOnly": true }, "type": { "type": "string", "enum": [ "image/jpeg", "image/jpg", "image/png", "image/webp", "image/gif", "video/mp4", "video/quicktime", "video/mpeg", "video/x-m4v", "video/x-ms-wmv", "video/x-msvideo", "video/webm" ] } } } ] }, "PostBaseRequest": { "type": "object", "required": [ "authToken", "text", "proxy" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "text": { "type": "string", "minLength": 1, "maxLength": 25000 }, "proxy": { "$ref": "#/components/schemas/Proxy" }, "disableLinkPreview": { "type": "boolean", "default": false } } }, "CreatePostRequest": { "allOf": [ { "$ref": "#/components/schemas/PostBaseRequest" }, { "type": "object", "properties": { "replyOption": { "$ref": "#/components/schemas/ReplyOption" } } } ] }, "CreatePostWithMediaRequest": { "allOf": [ { "$ref": "#/components/schemas/CreatePostRequest" }, { "type": "object", "required": [ "media" ], "properties": { "media": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/TweetMediaInput" } } } } ] }, "CreatePostQuoteRequest": { "allOf": [ { "$ref": "#/components/schemas/CreatePostRequest" }, { "type": "object", "required": [ "attachmentUrl" ], "properties": { "attachmentUrl": { "type": "string", "format": "uri" } } } ] }, "ReplyPostRequest": { "allOf": [ { "$ref": "#/components/schemas/PostBaseRequest" }, { "type": "object", "required": [ "tweetId" ], "properties": { "tweetId": { "$ref": "#/components/schemas/SnowflakeId" } } } ] }, "ReplyPostWithMediaRequest": { "allOf": [ { "$ref": "#/components/schemas/ReplyPostRequest" }, { "type": "object", "required": [ "media" ], "properties": { "media": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/TweetMediaInput" } } } } ] }, "CommunityPostRequest": { "allOf": [ { "$ref": "#/components/schemas/PostBaseRequest" }, { "type": "object", "required": [ "communityId" ], "properties": { "communityId": { "$ref": "#/components/schemas/SnowflakeId" } } } ] }, "CommunityPostWithMediaRequest": { "allOf": [ { "$ref": "#/components/schemas/CommunityPostRequest" }, { "type": "object", "required": [ "media" ], "properties": { "media": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/TweetMediaInput" } } } } ] }, "CommunityReplyRequest": { "allOf": [ { "$ref": "#/components/schemas/CommunityPostRequest" }, { "type": "object", "required": [ "tweetId" ], "properties": { "tweetId": { "$ref": "#/components/schemas/SnowflakeId" } } } ] }, "CommunityReplyWithMediaRequest": { "allOf": [ { "$ref": "#/components/schemas/CommunityReplyRequest" }, { "type": "object", "required": [ "media" ], "properties": { "media": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/TweetMediaInput" } } } } ] }, "CommunityQuoteRequest": { "allOf": [ { "$ref": "#/components/schemas/CommunityPostRequest" }, { "type": "object", "required": [ "attachmentUrl" ], "properties": { "attachmentUrl": { "type": "string", "format": "uri" } } } ] }, "CommunityQuoteWithMediaRequest": { "allOf": [ { "$ref": "#/components/schemas/CommunityQuoteRequest" }, { "type": "object", "required": [ "media" ], "properties": { "media": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/TweetMediaInput" } } } } ] }, "TweetActionRequest": { "type": "object", "required": [ "authToken", "tweetId" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "tweetId": { "$ref": "#/components/schemas/SnowflakeId" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "FollowRequest": { "type": "object", "required": [ "authToken", "userId" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "userId": { "$ref": "#/components/schemas/SnowflakeId" }, "username": { "type": "string", "pattern": "^[A-Za-z0-9_]{1,15}$" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "CommunityMembershipRequest": { "type": "object", "required": [ "authToken", "communityId" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "communityId": { "$ref": "#/components/schemas/SnowflakeId" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "AcceptConversationRequest": { "type": "object", "required": [ "authToken", "conversationId" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "conversationId": { "type": "string", "minLength": 1, "pattern": "^(\\d+-\\d+|\\d+|g\\d+)$" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "SendDmRequest": { "type": "object", "required": [ "authToken", "conversationId", "text", "proxy" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "conversationId": { "type": "string", "minLength": 1, "pattern": "^(\\d+-\\d+|\\d+|g\\d+)$" }, "text": { "type": "string", "minLength": 1, "maxLength": 10000 }, "requestId": { "type": "string", "format": "uuid" }, "media": { "type": "array", "maxItems": 1, "items": { "$ref": "#/components/schemas/DmMediaInput" } }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "UpdateProfileRequest": { "type": "object", "required": [ "authToken" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "name": { "type": "string", "minLength": 1, "maxLength": 50 }, "bio": { "type": "string", "maxLength": 160 }, "location": { "type": "string", "maxLength": 30 }, "website": { "oneOf": [ { "type": "string", "format": "uri" }, { "type": "string", "enum": [ "" ] } ] }, "proxy": { "$ref": "#/components/schemas/Proxy" } }, "anyOf": [ { "required": [ "name" ] }, { "required": [ "bio" ] }, { "required": [ "location" ] }, { "required": [ "website" ] } ] }, "UpdateProfileMediaRequest": { "type": "object", "required": [ "authToken", "media" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "media": { "$ref": "#/components/schemas/ProfileMediaInput" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "RemoveProfileBannerRequest": { "type": "object", "required": [ "authToken" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "UpdateProfilePrivacyRequest": { "type": "object", "required": [ "authToken", "isPrivate" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "isPrivate": { "type": "boolean" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "LoginRequest": { "type": "object", "required": [ "username", "password", "proxy", "country" ], "properties": { "username": { "type": "string", "minLength": 1 }, "password": { "type": "string", "minLength": 1, "writeOnly": true, "example": "YOUR_PASSWORD" }, "twoFactorSecret": { "type": "string", "minLength": 16, "writeOnly": true, "example": "YOUR_TOTP_SECRET" }, "proxy": { "$ref": "#/components/schemas/Proxy" }, "country": { "type": "string", "minLength": 2, "maxLength": 2, "enum": [ "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ] } } }, "XChatBaseRequest": { "type": "object", "required": [ "authToken" ], "properties": { "authToken": { "$ref": "#/components/schemas/AuthToken" }, "proxy": { "$ref": "#/components/schemas/Proxy" } } }, "XChatSetupRequest": { "allOf": [ { "$ref": "#/components/schemas/XChatBaseRequest" }, { "type": "object", "required": [ "userId", "pin" ], "properties": { "userId": { "$ref": "#/components/schemas/SnowflakeId" }, "pin": { "type": "string", "minLength": 4, "maxLength": 6, "pattern": "^\\d+$", "writeOnly": true, "example": "1234" } } } ] }, "XChatSendRequest": { "allOf": [ { "$ref": "#/components/schemas/XChatBaseRequest" }, { "type": "object", "required": [ "recipientId", "message" ], "properties": { "recipientId": { "$ref": "#/components/schemas/SnowflakeId" }, "message": { "type": "string", "minLength": 1, "maxLength": 10000 }, "conversationToken": { "type": "string", "minLength": 1, "writeOnly": true, "example": "YOUR_CONVERSATION_TOKEN" }, "conversationKeyVersion": { "type": "string", "minLength": 1, "writeOnly": true, "example": "YOUR_KEY_VERSION" }, "encryptedConversationKey": { "type": "string", "minLength": 1, "writeOnly": true, "example": "YOUR_ENCRYPTED_CONVERSATION_KEY" } } } ] }, "XChatHistoryRequest": { "allOf": [ { "$ref": "#/components/schemas/XChatBaseRequest" }, { "type": "object", "required": [ "conversationId" ], "properties": { "conversationId": { "type": "string", "minLength": 1 }, "cursor": { "type": "string" }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 } } } ] }, "XChatCanDmRequest": { "allOf": [ { "$ref": "#/components/schemas/XChatBaseRequest" }, { "type": "object", "required": [ "userIds" ], "properties": { "userIds": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/components/schemas/SnowflakeId" } } } } ] }, "XChatConversationsRequest": { "allOf": [ { "$ref": "#/components/schemas/XChatBaseRequest" }, { "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1 }, "graphSnapshotId": { "type": "string", "minLength": 1 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } } ] }, "Media": { "type": "object", "required": [ "id", "type" ], "properties": { "id": { "type": "string" }, "key": { "type": "string" }, "type": { "type": "string", "enum": [ "photo", "video", "animated_gif" ] }, "url": { "type": "string", "format": "uri" }, "displayUrl": { "type": "string" }, "expandedUrl": { "type": "string" }, "thumbnailUrl": { "type": "string", "format": "uri", "nullable": true }, "width": { "type": "integer" }, "height": { "type": "integer" }, "aspectRatio": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "integer" } }, "sizes": { "type": "object", "additionalProperties": true }, "duration": { "type": "number", "nullable": true }, "bitrate": { "type": "integer", "nullable": true }, "videoInfo": { "type": "object", "nullable": true, "additionalProperties": true }, "altText": { "type": "string", "nullable": true }, "sensitiveMedia": { "type": "boolean" }, "features": { "type": "object", "nullable": true, "additionalProperties": true }, "mediaAvailability": { "type": "object", "additionalProperties": true }, "allowDownload": { "type": "boolean" }, "mediaStats": { "type": "object", "nullable": true, "additionalProperties": true }, "processingInfo": { "type": "object", "nullable": true, "additionalProperties": true }, "sourceStatusId": { "type": "string", "nullable": true }, "sourceUserId": { "type": "string", "nullable": true }, "stickers": { "type": "array", "nullable": true, "items": { "type": "object", "additionalProperties": true } } }, "additionalProperties": true }, "User": { "type": "object", "nullable": true, "required": [ "id", "username" ], "properties": { "id": { "type": "string" }, "username": { "type": "string" }, "name": { "type": "string" }, "bio": { "type": "string" }, "location": { "type": "string", "nullable": true }, "website": { "type": "string", "format": "uri", "nullable": true }, "pinnedTweetIds": { "type": "array", "items": { "type": "string" } }, "avatar": { "type": "string", "format": "uri", "nullable": true }, "banner": { "type": "string", "format": "uri", "nullable": true }, "profileImageShape": { "type": "string", "enum": [ "Circle", "Square", null ], "nullable": true }, "verified": { "type": "boolean" }, "isBlueVerified": { "type": "boolean" }, "verifiedType": { "type": "string", "nullable": true }, "verifiedSince": { "type": "string", "format": "date-time", "nullable": true }, "isIdentityVerified": { "type": "boolean" }, "isProtected": { "type": "boolean" }, "possiblySensitive": { "type": "boolean" }, "profileInterstitialType": { "type": "string", "nullable": true }, "withheldInCountries": { "type": "array", "items": { "type": "string" } }, "professional": { "type": "object", "nullable": true, "additionalProperties": true }, "businessAccount": { "type": "object", "nullable": true, "additionalProperties": true }, "creatorSubscriptionsCount": { "type": "integer" }, "hasHiddenSubscriptions": { "type": "boolean" }, "highlightsInfo": { "type": "object", "nullable": true, "additionalProperties": true }, "hasGraduatedAccess": { "type": "boolean" }, "isProfileTranslatable": { "type": "boolean" }, "hasCustomTimelines": { "type": "boolean" }, "isTranslator": { "type": "boolean" }, "affiliatesHighlightedLabel": { "type": "object", "nullable": true, "additionalProperties": true }, "defaultProfile": { "type": "boolean" }, "defaultProfileImage": { "type": "boolean" }, "followerCount": { "type": "integer" }, "followingCount": { "type": "integer" }, "tweetCount": { "type": "integer" }, "listedCount": { "type": "integer" }, "mediaCount": { "type": "integer" }, "favoritesCount": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time", "nullable": true } }, "additionalProperties": true }, "Tweet": { "type": "object", "nullable": true, "required": [ "id", "text" ], "properties": { "id": { "type": "string" }, "conversationId": { "type": "string", "nullable": true }, "text": { "type": "string" }, "displayTextRange": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "integer" } }, "author": { "$ref": "#/components/schemas/User" }, "source": { "type": "string", "nullable": true }, "type": { "type": "string", "enum": [ "tweet", "reply", "quote", "retweet", "thread" ] }, "replyTo": { "type": "object", "nullable": true, "additionalProperties": true }, "quotedTweet": { "$ref": "#/components/schemas/Tweet" }, "reactionContext": { "type": "object", "nullable": true, "additionalProperties": true }, "retweetedTweet": { "$ref": "#/components/schemas/Tweet" }, "likeCount": { "type": "integer" }, "retweetCount": { "type": "integer" }, "replyCount": { "type": "integer" }, "quoteCount": { "type": "integer" }, "bookmarkCount": { "type": "integer" }, "viewCount": { "type": "integer", "nullable": true }, "media": { "type": "array", "nullable": true, "items": { "$ref": "#/components/schemas/Media" } }, "poll": { "type": "object", "nullable": true, "additionalProperties": true }, "card": { "type": "object", "nullable": true, "additionalProperties": true }, "article": { "$ref": "#/components/schemas/Article" }, "hashtags": { "type": "array", "items": { "type": "string" } }, "mentions": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "object", "additionalProperties": true } ] } }, "urls": { "type": "array", "items": { "type": "string" } }, "symbols": { "type": "array", "items": { "type": "string" } }, "possiblySensitive": { "type": "boolean" }, "limitedActions": { "type": "string", "nullable": true }, "hasAIGeneratedMedia": { "type": "boolean" }, "isPaidPromotion": { "type": "boolean" }, "isEdited": { "type": "boolean" }, "editControl": { "type": "object", "nullable": true, "additionalProperties": true }, "isTranslatable": { "type": "boolean" }, "lang": { "type": "string" }, "translatedText": { "type": "string", "nullable": true }, "hasBirdwatchNotes": { "type": "boolean" }, "birdwatchPivot": { "type": "object", "nullable": true, "additionalProperties": true }, "conversationControl": { "type": "object", "nullable": true, "additionalProperties": true }, "isPromoted": { "type": "boolean" }, "promotedMetadata": { "type": "object", "nullable": true, "additionalProperties": true }, "communityId": { "type": "string", "nullable": true }, "communityResults": { "type": "object", "nullable": true, "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time", "nullable": true }, "place": { "type": "object", "nullable": true, "additionalProperties": true } }, "additionalProperties": true }, "Article": { "type": "object", "nullable": true, "required": [ "id", "title", "text", "previewText", "coverImageUrl" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "text": { "type": "string" }, "previewText": { "type": "string" }, "coverImageUrl": { "type": "string", "format": "uri", "nullable": true } } }, "List": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "mode": { "type": "string", "enum": [ "public", "private" ] }, "owner": { "$ref": "#/components/schemas/User" }, "bannerUrl": { "type": "string", "format": "uri", "nullable": true }, "defaultBannerMedia": { "type": "object", "nullable": true, "additionalProperties": true }, "facepileUrls": { "type": "array", "items": { "type": "string", "format": "uri" } }, "memberCount": { "type": "integer" }, "subscriberCount": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time", "nullable": true }, "slug": { "type": "string" }, "uri": { "type": "string" } }, "additionalProperties": true }, "Community": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "bannerUrl": { "type": "string", "format": "uri", "nullable": true }, "avatarUrl": { "type": "string", "nullable": true }, "rules": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "memberCount": { "type": "integer" }, "moderatorCount": { "type": "integer" }, "adminCount": { "type": "integer" }, "isPrivate": { "type": "boolean" }, "pinnedTweetId": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "nullable": true }, "isMember": { "type": "boolean" }, "isAdmin": { "type": "boolean" }, "isModerator": { "type": "boolean" }, "canPost": { "type": "boolean" }, "isBanned": { "type": "boolean" }, "joinRequestsEnabled": { "type": "boolean" } }, "additionalProperties": true }, "CommunityMember": { "type": "object", "required": [ "user", "role" ], "properties": { "user": { "$ref": "#/components/schemas/User" }, "role": { "type": "string", "enum": [ "member", "moderator", "admin" ] }, "joinedAt": { "type": "string", "format": "date-time" }, "invitedBy": { "$ref": "#/components/schemas/User" }, "permissions": { "type": "array", "items": { "type": "string" } }, "contributionStats": { "type": "object", "additionalProperties": true } } }, "CommunitySearchResult": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "memberCount": { "type": "integer" }, "topic": { "type": "string", "nullable": true }, "isNsfw": { "type": "boolean" }, "bannerUrl": { "type": "string", "format": "uri", "nullable": true }, "defaultBannerUrl": { "type": "string", "format": "uri", "nullable": true }, "membersFacepile": { "type": "array", "items": { "type": "string", "format": "uri" } } } }, "Space": { "type": "object", "required": [ "id", "state" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "state": { "type": "string", "enum": [ "Running", "Ended", "Scheduled", "Canceled" ] }, "mediaKey": { "type": "string" }, "createdAt": { "type": "integer", "format": "int64" }, "scheduledStart": { "type": "integer", "format": "int64", "nullable": true }, "startedAt": { "type": "integer", "format": "int64", "nullable": true }, "endedAt": { "type": "integer", "format": "int64", "nullable": true }, "updatedAt": { "type": "integer", "format": "int64", "nullable": true }, "creator": { "$ref": "#/components/schemas/User" }, "totalLiveListeners": { "type": "integer" }, "totalReplayWatched": { "type": "integer" }, "participants": { "type": "object", "additionalProperties": true }, "isAvailableForReplay": { "type": "boolean" }, "isAvailableForClipping": { "type": "boolean" }, "contentType": { "type": "string" }, "narrowCastSpaceType": { "type": "integer" }, "conversationControls": { "type": "integer" }, "disallowJoin": { "type": "boolean" }, "isEmployeeOnly": { "type": "boolean" }, "isLocked": { "type": "boolean" }, "isMuted": { "type": "boolean" }, "noIncognito": { "type": "boolean" }, "maxGuestSessions": { "type": "integer" }, "maxAdminCapacity": { "type": "integer" }, "topics": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "tweetId": { "type": "string", "nullable": true }, "mentionedUserIds": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "UserResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/User" } } }, "UserArrayResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/User" } } } }, "UserPageResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/User" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "TweetPageResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Tweet" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "IdPageResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "type": "string" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "TweetResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Tweet" } } }, "TweetLookupResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "tweets" ], "properties": { "tweets": { "type": "array", "items": { "$ref": "#/components/schemas/Tweet" } } } } } }, "RawTranslationResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "oneOf": [ { "type": "string" }, { "type": "object", "additionalProperties": true } ] } } }, "RelationshipResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "nullable": true, "properties": { "sourceId": { "type": "string" }, "targetId": { "type": "string" }, "following": { "type": "boolean" }, "followedBy": { "type": "boolean" }, "canDm": { "type": "boolean" } }, "additionalProperties": true } } }, "AboutAccountResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "username": { "type": "string" }, "name": { "type": "string" }, "createdAt": { "type": "string", "nullable": true }, "verified": { "type": "boolean" }, "isBlueVerified": { "type": "boolean" }, "isProtected": { "type": "boolean" } }, "additionalProperties": true } } }, "ListResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/List" } } }, "CommunityResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Community" } } }, "CommunityMemberPageResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CommunityMember" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "CommunitySearchResponse": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CommunitySearchResult" } }, "nextCursor": { "type": "string", "nullable": true } } }, "SearchResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/Tweet" }, { "$ref": "#/components/schemas/User" } ] } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "SpaceResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Space" } } }, "SpaceStreamResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "hlsUrl", "status", "streamType", "shareUrl" ], "properties": { "hlsUrl": { "type": "string", "format": "uri" }, "status": { "type": "string" }, "streamType": { "type": "string" }, "shareUrl": { "type": "string", "nullable": true } } } } }, "ActionResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "id", "action", "timestamp", "success" ], "properties": { "id": { "type": "string" }, "action": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "success": { "type": "boolean" }, "message": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": true } } } } }, "PrivacyResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "object", "required": [ "isPrivate" ], "properties": { "isPrivate": { "type": "boolean" } } } } }, "NotificationPageResponse": { "type": "object", "required": [ "data", "pagination" ], "properties": { "data": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "FlexibleDataResponse": { "type": "object", "properties": { "data": { "type": "object", "additionalProperties": true } } }, "LoginResponse": { "type": "object", "required": [ "status", "data" ], "properties": { "status": { "type": "string", "enum": [ "success" ] }, "data": { "type": "object", "required": [ "cookies", "user", "timestamp" ], "properties": { "cookies": { "type": "object", "description": "Sensitive session cookies returned by the login operation.", "additionalProperties": { "type": "string" } }, "user": { "type": "object", "additionalProperties": true }, "timestamp": { "type": "string", "format": "date-time" } } } } }, "Message": { "type": "object", "additionalProperties": true }, "Conversation": { "type": "object", "nullable": true, "additionalProperties": true }, "DmPermissionsResponse": { "type": "object", "required": [ "permissions", "users" ], "properties": { "permissions": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "users": { "type": "array", "items": { "$ref": "#/components/schemas/User" } } } }, "DmSendResponse": { "type": "object", "required": [ "message", "users" ], "properties": { "message": { "$ref": "#/components/schemas/Message" }, "users": { "type": "array", "items": { "$ref": "#/components/schemas/User" } } } }, "DmConversationResponse": { "type": "object", "required": [ "messages", "users", "conversationInfo", "hasMore" ], "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Message" } }, "users": { "type": "array", "items": { "$ref": "#/components/schemas/User" } }, "conversationInfo": { "$ref": "#/components/schemas/Conversation" }, "cursor": { "type": "string" }, "hasMore": { "type": "boolean" } } }, "DmInboxResponse": { "type": "object", "additionalProperties": true }, "DmUpdatesResponse": { "type": "object", "additionalProperties": true }, "DmTimelineResponse": { "type": "object", "additionalProperties": true }, "XChatSetupResponse": { "type": "object", "required": [ "status", "userId", "publicKeyVersion", "message" ], "properties": { "status": { "type": "string", "enum": [ "ready" ] }, "userId": { "type": "string" }, "publicKeyVersion": { "type": "string" }, "message": { "type": "string" } } }, "XChatSendResponse": { "type": "object", "required": [ "messageId", "conversationId", "timestamp", "status", "recipientId", "mode" ], "properties": { "messageId": { "type": "string" }, "conversationId": { "type": "string" }, "timestamp": { "type": "integer", "format": "int64" }, "status": { "type": "string", "enum": [ "sent" ] }, "recipientId": { "type": "string" }, "mode": { "type": "string", "enum": [ "e2e" ] }, "retried": { "type": "boolean" } } }, "XChatHistoryResponse": { "type": "object", "required": [ "messages", "hasMore", "nextCursor" ], "properties": { "messages": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string", "nullable": true } } }, "XChatCanDmResponse": { "type": "object", "required": [ "users" ], "properties": { "users": { "type": "array", "items": { "type": "object", "additionalProperties": true } } } }, "XChatConversationsResponse": { "type": "object", "required": [ "conversations", "cursor", "graphSnapshotId" ], "properties": { "conversations": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "cursor": { "type": "string", "nullable": true }, "graphSnapshotId": { "type": "string", "nullable": true } } } } } }