POST

Get Post

/v1/threads/post

Fetch a single Threads post with full metadata by providing the post URL. Optionally include view count or receive results via webhook.

Request Parameters

Parameter	Type	Required	Description
post_url	string	Yes	Full Threads post URL
webhook_url	string	No	URL to receive results via POST callback
with_views	bool	No	Include view count (adds extra request) (default: false)

Example

curl -X POST https://query-data-api.notpeople.ai/v1/threads/post \
  -H "X-API-Key: th_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://www.threads.net/@zuck/post/DWVrNYoCGm9", "with_views": true}'

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
metadata.url	string	Post URL queried
metadata.found	bool	Whether the post was found
metadata.elapsed_ms	int	Request duration in milliseconds
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
view_count	int	Number of views (when with_views=true)
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": {
    "url": "https://www.threads.net/@zuck/post/DWVrNYoCGm9",
    "found": true,
    "elapsed_ms": 4657
  },
  "data": {
    "pk": "3861182291334687165",
    "id": "3861182291334687165_68309819417",
    "graph_id": "18451573138107670",
    "code": "DWVrNYoCGm9",
    "text": "The old adage - only as good as the input.",
    "taken_at": 1774508819,
    "post_type": "post",
    "username": "the7bees7knees7",
    "full_name": "PJLW",
    "user_id": "68309819417",
    "is_verified": false,
    "profile_pic_url": "https://scontent.cdninstagram.com/.../photo.jpg",
    "reply_to_user": null,
    "reply_to_post": null,
    "quoted_post": null,
    "like_count": 37,
    "view_count": 516,
    "reply_count": 2,
    "repost_count": 4,
    "quote_count": 1,
    "share_count": 0,
    "is_pinned": false,
    "media_type": 19,
    "media": [],
    "video_url": null,
    "image_url": null
  },
  "usage": {
    "unique_posts": 84,
    "limit": 6000,
    "remaining": 5916
  }
}

Try this endpoint live

Create Free Account