Inbox Timeline Trusted

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

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-trusted?${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-1000000000000000002",
      "type": "ONE_TO_ONE",
      "participants": [
        "1000000000000000001",
        "1000000000000000002"
      ],
      "lastMessageId": "2000000000000000001",
      "lastMessageTime": "2024-01-15T10:30:00.000Z",
      "lastReadMessageId": "2000000000000000001",
      "trusted": true,
      "muted": false,
      "readOnly": false,
      "lowQuality": false,
      "nsfw": false,
      "notificationsDisabled": false,
      "minEntryId": "2000000000000000001",
      "maxEntryId": "2000000000000000001"
    },
    {
      "id": "1000000000000000001-1000000000000000003",
      "type": "ONE_TO_ONE",
      "participants": [
        "1000000000000000001",
        "1000000000000000003"
      ],
      "lastMessageId": "2000000000000000002",
      "lastMessageTime": "2024-01-15T11:00:00.000Z",
      "lastReadMessageId": "2000000000000000002",
      "trusted": true,
      "muted": false,
      "readOnly": false,
      "lowQuality": false,
      "nsfw": false,
      "notificationsDisabled": false,
      "minEntryId": "2000000000000000002",
      "maxEntryId": "2000000000000000002"
    }
  ],
  "messages": [
    {
      "id": "2000000000000000001",
      "conversationId": "1000000000000000001-1000000000000000002",
      "senderId": "1000000000000000002",
      "recipientId": "1000000000000000001",
      "text": "Hello, how are you?",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "requestId": "00000000-0000-0000-0000-000000000001",
      "editCount": 0
    },
    {
      "id": "2000000000000000002",
      "conversationId": "1000000000000000001-1000000000000000003",
      "senderId": "1000000000000000003",
      "recipientId": "1000000000000000001",
      "text": "Thanks for your message!",
      "createdAt": "2024-01-15T11:00:00.000Z",
      "requestId": "00000000-0000-0000-0000-000000000002",
      "editCount": 0
    }
  ],
  "users": [
    {
      "id": "1000000000000000001",
      "username": "user_one",
      "name": "User One",
      "bio": "Sample bio for user one",
      "location": null,
      "website": "https://example.com",
      "pinnedTweetIds": [],
      "avatar": "https://example.com/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": 100,
      "followingCount": 50,
      "tweetCount": 0,
      "listedCount": 0,
      "mediaCount": 0,
      "favoritesCount": 0,
      "createdAt": "2020-01-01T00:00:00.000Z"
    },
    {
      "id": "1000000000000000002",
      "username": "user_two",
      "name": "User Two",
      "bio": "Sample bio for user two",
      "location": null,
      "website": null,
      "pinnedTweetIds": [],
      "avatar": "https://example.com/avatar2.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"
}