POST

Get Post

/v1/twitter/post

Fetch a single tweet with full metadata by providing the tweet URL. Optionally receive results via webhook.

Response data is wrapped as {post: {...}, url: "..."} where the post object contains the tweet fields.

Request Parameters

Parameter	Type	Required	Description
post_url	string	Yes	Full tweet URL (e.g. https://x.com/user/status/123)
webhook_url	string	No	URL to receive results via POST callback

Example

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

Response Schema

All responses include success, data, and usage fields.

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

Example Response

{
  "success": true,
  "data": {
    "post": {
      "post_id": "2037025177297686839",
      "user_id": "3222018178",
      "username": "adcock_brett",
      "name": "Brett Adcock",
      "text": "First humanoid robot at the White House",
      "created_at": "Thu Mar 26 04:33:43 +0000 2026",
      "timestamp": 1774499623,
      "post_type": "tweet",
      "likes_count": 572,
      "retweets_count": 32,
      "replies_count": 48,
      "is_blue_verified": true,
      "profile_image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
      "views_count": 20213,
      "reply_to_post_id": null,
      "reply_to_user": null,
      "reply_to_post": null,
      "is_pinned": false,
      "media": [
        { "type": "photo", "url": "https://pbs.twimg.com/media/.../photo.jpg" }
      ],
      "quoted_post": null
    },
    "url": "https://x.com/adcock_brett/status/2037025177297686839"
  },
  "usage": {
    "unique_posts": 82,
    "limit": 6000,
    "remaining": 5918
  }
}

Try this endpoint live

Create Free Account