POST

User Posts

/v1/threads/user/posts

Fetch the latest posts from any Threads user. Optionally include replies alongside original posts.

Request Parameters

Parameter	Type	Required	Description
username	string	Yes	Threads username
limit	int	No	Max results (1-100) (default: 20)
with_replies	bool	No	Include replies (default: false)

Example

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

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.replies_linked	int	Number of replies with linked parent context
metadata.elapsed_ms	int	Request duration in milliseconds
metadata.type_breakdown	object	Count of posts by type
metadata.with_media	int	Number of posts with media attached
metadata.with_reply_to_post	int	Number of posts with linked reply context
pinned_post	object \| null	Pinned post object (same fields as data posts)
pk	string	Primary key identifier
id	string	Full post ID (pk_userId)
graph_id	string	Graph API ID
code	string	Post shortcode for URL
text	string	Post text content
taken_at	int	Unix timestamp
post_type	string	Post type (post, reply, repost, quote)
username	string	Author handle
full_name	string	Author display name
user_id	string	Author user ID
is_verified	bool	Author verification status
profile_pic_url	string	Author profile picture URL
reply_to_user	string \| null	Username being replied to
reply_to_post	object \| null	Full post object being replied to
quoted_post	object \| null	Quoted post data if applicable
like_count	int	Number of likes
reply_count	int	Number of replies
repost_count	int	Number of reposts
quote_count	int	Number of quotes
share_count	int	Number of shares
is_pinned	bool	Whether the post is pinned
media_type	int	Media type identifier
media	array	Attached media [{type, url, width, height}]
video_url	string \| null	Direct video URL if applicable
image_url	string \| null	Direct image URL if applicable

Example Response

{
  "success": true,
  "metadata": {
    "username": "zuck",
    "with_replies": true,
    "posts_found": 1,
    "has_pinned": false,
    "replies_linked": 0,
    "elapsed_ms": 16322,
    "type_breakdown": { "post": 1 },
    "with_media": 1,
    "with_reply_to_post": 0
  },
  "pinned_post": null,
  "data": [
    {
      "pk": "3849384441660167347",
      "id": "3849384441660167347_63055343223",
      "graph_id": "18096867805968485",
      "code": "DVrwsE5EdSz",
      "text": "Meanwhile at Meta HQ",
      "taken_at": 1773102406,
      "post_type": "post",
      "username": "zuck",
      "full_name": "Mark Zuckerberg",
      "user_id": "63055343223",
      "is_verified": true,
      "profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg",
      "reply_to_user": null,
      "reply_to_post": null,
      "quoted_post": null,
      "like_count": 6979,
      "reply_count": 948,
      "repost_count": 203,
      "quote_count": 62,
      "share_count": 0,
      "is_pinned": false,
      "media_type": 1,
      "media": [
        { "type": "image", "url": "https://scontent.cdninstagram.com/.../photo.webp", "width": 1200, "height": 1600 }
      ],
      "video_url": null,
      "image_url": "https://scontent.cdninstagram.com/.../photo.webp"
    }
  ],
  "usage": {
    "unique_posts": 84,
    "limit": 6000,
    "remaining": 5916
  }
}

Try this endpoint live

Create Free Account