Skip to main content
GET
/
v1
/
x
/
users
/
{username}
/
posts
Get user posts
curl --request GET \
  --url https://api.konbiniapi.com/v1/x/users/{username}/posts \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/x/users/KhabyLame/posts",
    "totalItems": 1309,
    "cursor": "0",
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/x/users/KhabyLame/posts",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Note",
        "id": "https://x.com/KhabyLame/status/2024515585569083437",
        "url": "https://x.com/KhabyLame/status/2024515585569083437",
        "entityId": "2024515585569083437",
        "content": "This man hasn't been in my fyp for so long",
        "likeCount": 93210,
        "published": "2026-02-27T20:37:38.000Z",
        "replyCount": 96,
        "viewCount": 10195,
        "repostCount": 3,
        "quoteCount": 0,
        "saveCount": 3,
        "contentFormat": "longform",
        "isEdited": false,
        "attributedTo": {
          "type": "Person",
          "id": "https://x.com/KhabyLame",
          "url": "https://x.com/KhabyLame",
          "entityId": "221838349",
          "preferredUsername": "KhabyLame",
          "name": "Khabane Lame",
          "icon": {
            "type": "Image",
            "url": "https://pbs.twimg.com/amplify_video_thumb/2024515147692195840/img/t8ePmit3Wst1hxAM.jpg",
            "width": 1536,
            "height": 2048
          },
          "isPrivate": false,
          "isVerified": false,
          "isPaidVerified": true,
          "summary": "Let's Go",
          "attachment": [
            {
              "type": "Link",
              "href": "https://t.co/examplelink",
              "rel": "preferred"
            }
          ],
          "followerCount": 372131,
          "followingCount": 8,
          "likeCount": 60,
          "postCount": 267,
          "mediaCount": 242,
          "listedCount": 215,
          "location": "Milan, Italy"
        },
        "inReplyTo": "<string>",
        "quote": {
          "type": "Note",
          "id": "https://x.com/NISMO/status/2024100000000000000",
          "url": "https://x.com/NISMO/status/2024100000000000000",
          "entityId": "2024100000000000000",
          "content": "Ready for race week.",
          "likeCount": 93210,
          "published": "2026-02-18T12:00:00.000Z",
          "replyCount": 96,
          "contentFormat": "longform",
          "attributedTo": {
            "type": "Person",
            "id": "https://x.com/KhabyLame",
            "url": "https://x.com/KhabyLame",
            "entityId": "221838349",
            "preferredUsername": "KhabyLame",
            "name": "Khabane Lame",
            "icon": {
              "type": "Image",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2024515147692195840/img/t8ePmit3Wst1hxAM.jpg",
              "width": 1536,
              "height": 2048
            },
            "isPrivate": false,
            "isVerified": false,
            "isPaidVerified": true,
            "summary": "Let's Go",
            "attachment": [
              {
                "type": "Link",
                "href": "https://t.co/examplelink",
                "rel": "preferred"
              }
            ],
            "followerCount": 372131,
            "followingCount": 8,
            "likeCount": 60,
            "postCount": 267,
            "mediaCount": 242,
            "listedCount": 215,
            "location": "Milan, Italy"
          },
          "image": [
            {
              "type": "Image",
              "url": "https://pbs.twimg.com/amplify_video_thumb/2024515147692195840/img/t8ePmit3Wst1hxAM.jpg",
              "width": 1536,
              "height": 2048
            }
          ],
          "attachment": [
            {
              "type": "Video",
              "url": [
                "https://video.twimg.com/ext_tw_video/123/pu/vid/avc1/example.mp4"
              ],
              "mediaType": "video/mp4",
              "width": 1280,
              "height": 720,
              "bitrate": 950000,
              "duration": 16.266
            }
          ]
        },
        "image": [
          {
            "type": "Image",
            "url": "https://pbs.twimg.com/amplify_video_thumb/2024515147692195840/img/t8ePmit3Wst1hxAM.jpg",
            "width": 1536,
            "height": 2048
          }
        ],
        "attachment": [
          {
            "type": "Video",
            "url": [
              "https://video.twimg.com/ext_tw_video/123/pu/vid/avc1/example.mp4"
            ],
            "mediaType": "video/mp4",
            "width": 1280,
            "height": 720,
            "bitrate": 950000,
            "duration": 16.266
          }
        ],
        "tag": [
          {
            "type": "Tag",
            "name": "learnfromkhaby",
            "href": "https://x.com/Windows"
          }
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.konbiniapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Send your API key in the Authorization header as a Bearer token. Example: Authorization: Bearer <your-api-key>

Path Parameters

​
username
string
required

X username (with or without @ symbol)

Example:

"Austen"

Query Parameters

​
count
integer
default:20

Maximum number of posts to return from the public profile selection (maximum: 100)

Required range: 1 <= x <= 100
Example:

20

Response

Returns public posts from an X user profile

​
data
object
required