Inbox Timeline Untrusted

GET/tw-v2/interaction/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).

Parameters

Parameter	Type	Required	Description
authToken	string	required	Twitter authentication token (auth_token cookie value)
cursor	string	required	Cursor for pagination. Get from inbox-initial-state or previous response.
filterLowQuality	boolean	optional	Filter out low quality conversations (default false)
proxy	string	optional	Optional proxy in format 'host:port@user:pass'

Code Examples

const params = new URLSearchParams({
  authToken: 'YOUR_AUTH_TOKEN',
  cursor: '1234567890'
});

const response = await fetch(`https://api.tweetapi.com/tw-v2/interaction/inbox-timeline-untrusted?${params}`, {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);

Response

Success Response (200 OK)

200

{
  "conversations": [
    {
      "id": "1000000000000000001-3000000000000000001",
      "type": "ONE_TO_ONE",
      "participants": [
        "1000000000000000001",
        "3000000000000000001"
      ],
      "lastMessageId": "4000000000000000001",
      "lastMessageTime": "2024-01-20T08:15:00.000Z",
      "lastReadMessageId": "0",
      "trusted": false,
      "muted": false,
      "readOnly": false,
      "lowQuality": true,
      "nsfw": false,
      "notificationsDisabled": false,
      "minEntryId": "4000000000000000001",
      "maxEntryId": "4000000000000000001"
    },
    {
      "id": "1000000000000000001-3000000000000000002",
      "type": "ONE_TO_ONE",
      "participants": [
        "1000000000000000001",
        "3000000000000000002"
      ],
      "lastMessageId": "4000000000000000002",
      "lastMessageTime": "2024-01-20T09:30:00.000Z",
      "lastReadMessageId": "0",
      "trusted": false,
      "muted": false,
      "readOnly": false,
      "lowQuality": true,
      "nsfw": false,
      "notificationsDisabled": false,
      "minEntryId": "4000000000000000002",
      "maxEntryId": "4000000000000000002"
    }
  ],
  "messages": [
    {
      "id": "4000000000000000001",
      "conversationId": "1000000000000000001-3000000000000000001",
      "senderId": "3000000000000000001",
      "recipientId": "1000000000000000001",
      "text": "Hello! Check out this amazing opportunity!",
      "createdAt": "2024-01-20T08:15:00.000Z",
      "requestId": "00000000-0000-0000-0000-000000000003",
      "editCount": 0
    },
    {
      "id": "4000000000000000002",
      "conversationId": "1000000000000000001-3000000000000000002",
      "senderId": "3000000000000000002",
      "recipientId": "1000000000000000001",
      "text": "Exclusive invitation to join our group!",
      "createdAt": "2024-01-20T09:30:00.000Z",
      "editCount": 0,
      "entities": {
        "urls": [
          {
            "url": "https://t.co/example123",
            "expandedUrl": "https://example.com/invite",
            "displayUrl": "example.com/invite"
          }
        ],
        "mentions": [],
        "hashtags": []
      }
    }
  ],
  "users": [
    {
      "id": "3000000000000000001",
      "username": "spam_user_one",
      "name": "Spam User One",
      "bio": "Get rich quick! Join now!",
      "location": null,
      "website": "https://example.com/spam",
      "pinnedTweetIds": [],
      "avatar": "https://example.com/spam_avatar1.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": "3000000000000000002",
      "username": "spam_user_two",
      "name": "Spam User Two",
      "bio": "Investment opportunities! Click link!",
      "location": null,
      "website": null,
      "pinnedTweetIds": [],
      "avatar": "https://example.com/spam_avatar2.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"
}