POST

User Posts

/v1/twitter/user/posts

Fetch the latest posts from any Twitter user's timeline. Returns tweets, retweets, replies, and quotes with full metadata.

Request Parameters

Parameter	Type	Required	Description
username	string	Yes	Twitter username (without @)
limit	int	No	Max results (1-100) (default: 20)

Example

curl -X POST https://query-data-api.notpeople.ai/v1/twitter/user/posts \
  -H "X-API-Key: tw_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "limit": 10}'

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
metadata.username	string	Username queried
metadata.with_replies	bool	Whether replies were included
metadata.posts_found	int	Number of posts returned
metadata.has_pinned	bool	Whether the user has a pinned post
metadata.elapsed_ms	int	Request duration in milliseconds
pinned_post	object \| null	Pinned post object (same fields as data posts)
post_id	string	Unique tweet ID
user_id	string	Author user ID
username	string	Author handle
name	string	Author display name
text	string	Tweet text content
created_at	string	Human-readable timestamp
timestamp	int	Unix timestamp
post_type	string	tweet \| retweet \| reply \| quote
likes_count	int	Number of likes
retweets_count	int	Number of retweets
replies_count	int	Number of replies
views_count	int	Number of views
is_blue_verified	bool	Author verification status
profile_image_url	string	Author profile picture URL
reply_to_post_id	string \| null	ID of the post being replied to
reply_to_user	string \| null	Username of the user being replied to
reply_to_post	object \| null	Full post object being replied to
is_pinned	bool	Whether the post is pinned
media	array	Attached media [{type, url}]
quoted_post	object \| null	Quoted tweet data if post_type is quote

Example Response

{
  "success": true,
  "metadata": {
    "username": "elonmusk",
    "with_replies": true,
    "posts_found": 1,
    "has_pinned": true,
    "elapsed_ms": 5366
  },
  "pinned_post": {
    "post_id": "2036665153778000143",
    "user_id": "44196397",
    "username": "elonmusk",
    "name": "Elon Musk",
    "text": "Optimus",
    "created_at": "Wed Mar 25 04:43:06 +0000 2026",
    "timestamp": 1774413786,
    "post_type": "tweet",
    "likes_count": 253368,
    "retweets_count": 25824,
    "replies_count": 11426,
    "is_blue_verified": true,
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
    "views_count": 78502620,
    "reply_to_post_id": null,
    "reply_to_user": null,
    "reply_to_post": null,
    "is_pinned": true,
    "media": [
      { "type": "video", "url": "https://pbs.twimg.com/amplify_video_thumb/.../img.jpg" }
    ],
    "quoted_post": null
  },
  "data": [
    {
      "post_id": "2036665153778000143",
      "user_id": "44196397",
      "username": "elonmusk",
      "name": "Elon Musk",
      "text": "Optimus",
      "created_at": "Wed Mar 25 04:43:06 +0000 2026",
      "timestamp": 1774413786,
      "post_type": "tweet",
      "likes_count": 253368,
      "retweets_count": 25824,
      "replies_count": 11426,
      "is_blue_verified": true,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "views_count": 78502620,
      "reply_to_post_id": null,
      "reply_to_user": null,
      "reply_to_post": null,
      "is_pinned": true,
      "media": [
        { "type": "video", "url": "https://pbs.twimg.com/amplify_video_thumb/.../img.jpg" }
      ],
      "quoted_post": null
    }
  ],
  "usage": {
    "unique_posts": 82,
    "limit": 6000,
    "remaining": 5918
  }
}

Try this endpoint live

Create Free Account