POST

Post Comments

/v1/twitter/post/comments

Fetch replies and comments on any tweet. Returns an array of posts representing the replies.

Response data is wrapped as {comments: [...], url: "...", count: int}.

Request Parameters

Parameter	Type	Required	Description
post_url	string	Yes	Full tweet URL
limit	int	No	Max results (1-100) (default: 20)

Example

curl -X POST https://query-data-api.notpeople.ai/v1/twitter/post/comments \
  -H "X-API-Key: tw_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://x.com/elonmusk/status/1234567890", "limit": 20}'

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
data.comments	array	Array of comment post objects
data.url	string	Canonical tweet URL
data.count	int	Number of comments returned
comment.post_id	string	Unique tweet ID
comment.user_id	string	Author user ID
comment.username	string	Author handle
comment.name	string	Author display name
comment.text	string	Reply text content
comment.created_at	string	Human-readable timestamp
comment.timestamp	int	Unix timestamp
comment.post_type	string	tweet \| retweet \| reply \| quote
comment.likes_count	int	Number of likes
comment.retweets_count	int	Number of retweets
comment.replies_count	int	Number of replies
comment.views_count	int	Number of views
comment.is_blue_verified	bool	Author verification status
comment.profile_image_url	string	Author profile picture URL
comment.reply_to_post_id	string \| null	ID of the post being replied to
comment.reply_to_user	string \| null	Username of the user being replied to
comment.reply_to_post	object \| null	Full post object being replied to
comment.is_pinned	bool	Whether the comment is pinned
comment.media	array \| null	Attached media [{type, url}]
comment.quoted_post	object \| null	Quoted tweet data if present

Example Response

{
  "success": true,
  "data": {
    "comments": [
      {
        "post_id": "2037089486480564357",
        "user_id": "3439026987",
        "username": "nittrou",
        "name": "Luke Goodridge",
        "text": "@adcock_brett the white house visit will get all the attention...",
        "created_at": "Thu Mar 26 08:49:15 +0000 2026",
        "timestamp": 1774514955,
        "post_type": "reply",
        "likes_count": 0,
        "retweets_count": 0,
        "replies_count": 0,
        "is_blue_verified": true,
        "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
        "views_count": 21,
        "reply_to_post_id": "2037025177297686839",
        "reply_to_user": "adcock_brett",
        "reply_to_post": null,
        "is_pinned": false,
        "media": null,
        "quoted_post": null
      }
    ],
    "url": "https://x.com/adcock_brett/status/2037025177297686839",
    "count": 1
  },
  "usage": {
    "unique_posts": 82,
    "limit": 6000,
    "remaining": 5918
  }
}

Try this endpoint live

Create Free Account