X (Twitter) API: List account posts

List an account's posts with text, engagement counts, entities, and author details. An unknown handle returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

handle*string

Account handle with or without @, or a full x.com or twitter.com profile URL. Handles contain 1–15 letters, digits, or underscores.

Lengthlength <= 300

count?integer

Requested number of posts. X may return fewer while more results remain; use has_more to determine whether to continue.

Range1 <= value <= 100

Default20

cursor?string

next_cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Lengthlength <= 2000

curl -X GET "https://example.com/v1/x/tweets?handle=nasa" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "tweets": [      {        "id": "1978472698594644405",        "text": "There's space for everybody. ✨",        "is_long_post": false,        "created_at": "Wed Oct 15 18:32:11 +0000 2025",        "lang": "en",        "conversation_id": "1978472698594644405",        "reply_to_tweet_id": null,        "reply_to_handle": null,        "like_count": 2341,        "retweet_count": 412,        "reply_count": 88,        "quote_count": 17,        "bookmark_count": 231,        "view_count": 54752,        "possibly_sensitive": false,        "entities": null,        "author": {          "id": "11348282",          "handle": "NASA",          "name": "NASA",          "verified": false,          "is_blue_verified": true,          "followers_count": 92304095,          "profile_image_url": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg"        },        "is_retweet": false,        "is_quote": false,        "retweeted_tweet": {},        "quoted_tweet": {}      }    ],    "count": 12,    "next_cursor": "DAABCgABGxxxxxxxxxxxLAAA",    "has_more": true,    "handle": "NASA",    "user_id": "11348282",    "requested_count": 20,    "cursor": null,    "usage_note": "Send `next_cursor` to continue the timeline. A page may contain fewer posts than `count` while more results remain, so use `has_more` to determine when the timeline ends. Each post's `id` can be sent to `/v1/x/tweet`."  }}