POST

Threads Search

/v1/threads/search

Search Threads posts by query string. Filter by top or recent results with configurable limits.

Request Parameters

Parameter	Type	Required	Description
query	string	Yes	Search query string
search_type	string	No	"top" or "recent" (default: top)
limit	int	No	Max results (1-100) (default: 20)

Example

curl -X POST https://query-data-api.notpeople.ai/v1/threads/search \
  -H "X-API-Key: th_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "technology", "search_type": "top", "limit": 10}'

Response Schema

All responses include success, data, and usage fields.

Field	Type	Description
metadata.url	string	Search URL used
metadata.query	string	Search query string
metadata.search_type	string	Search type used (top or recent)
metadata.posts_found	int	Number of posts returned
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
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": {
    "url": "https://www.threads.com/search?q=technology&serp_type=default",
    "query": "technology",
    "search_type": "top",
    "posts_found": 1,
    "elapsed_ms": 6081,
    "type_breakdown": { "post": 1 },
    "with_media": 0,
    "with_reply_to_post": 0
  },
  "data": [
    {
      "pk": "3861216015158238231",
      "id": "3861216015158238231_64697976210",
      "graph_id": "18078178052120522",
      "code": "DWVy4IYjlwX",
      "text": "Im kind of jealous of the times we had before technology...",
      "taken_at": 1774512839,
      "post_type": "post",
      "username": "fierceflrican",
      "full_name": "MISS FIERCE FL RICAN",
      "user_id": "64697976210",
      "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": 2,
      "reply_count": 0,
      "repost_count": 1,
      "quote_count": 0,
      "share_count": 0,
      "is_pinned": false,
      "media_type": 19,
      "media": [],
      "video_url": null,
      "image_url": null
    }
  ],
  "usage": {
    "unique_posts": 83,
    "limit": 6000,
    "remaining": 5917
  }
}

Try this endpoint live

Create Free Account