Documentation Index
Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
Use this file to discover all available pages before exploring further.
$4.7 / 1k results
Search Threads for posts and users matching a searchQuery, returning post content and user details
Endpoint
POST /api/v1/agents/threads/search/run
Parameters
Text · Enter keywords, topics, hashtags, or phrases to search for in Threads posts. Example: ‘trump’, ‘artificial intelligence’, ‘#tech’, etc.
Dropdown · Choose how to sort search results. ‘top’ shows most relevant/popular posts first, ‘recent’ shows newest posts first.Options: top, recent
Text · Only posts from this username (e.g. ‘foxnews’, ‘meta’). Leave empty to search all users.
Date picker · Earliest post date. Leave blank for no lower bound.
Date picker · Latest post date. Leave blank for no upper bound.
Number · Maximum number of posts to scrape from search results. Use 0 for all (minimum: 10).
Response columns
| Field | Display name | Type |
|---|
postText | Post Text | text |
postUrl | Post URL | url |
postedAt | Posted At | text |
username | Username | text |
verified | Verified | boolean |
private | Private | boolean |
likes | Likes | number |
replies | Replies | number |
quotes | Quotes | number |
reposts | Reposts | number |
reshares | Reshares | number |
isReply | Is Reply | boolean |
paidPartnership | Paid Partnership | boolean |
hasLiked | Has Liked | boolean |
canReply | Can Reply | boolean |
replyControl | Reply Control | text |
edited | Edited | boolean |
hasAudio | Has Audio | boolean |
mediaType | Media Type | number |
width | Width | number |
height | Height | number |
linkPreviewTitle | Link Preview Title | text |
linkPreviewDisplay | Link Preview Display | text |
avatar | Avatar | url |
image | Image | url |
videoUrl | Video URL | url |
linkPreviewUrl | Link Preview URL | url |
linkPreviewImage | Link Preview Image | url |
allImages | All Images | text |
allVideos | All Videos | text |
Example
curl -X POST https://api.mindcase.co/api/v1/agents/threads/search/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"query": "OpenAI",
"sortBy": "top",
"maxResults": 10
}
}'
Example response
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"postText": "OpenAI announced a major reorganization on Friday as the company\u2019s CEO of AGI deployment, Fidji Simo, takes medical leave to focus on her health. OpenAI president Greg Brockman will handle the product teams in Simo\u2019s absence. Simo\u2019s previous title was CEO of applications.\nhttps://www.wired.com/story/openais-fidji-simo-is-taking-a-leave-of-absence/",
"postUrl": "https://www.threads.com/@wired/post/DWrtQR7j-9Y",
"postedAt": "2026-04-03T20:28:13.000Z",
"username": "wired",
"verified": true,
"private": false,
"likes": 6,
"replies": 2,
"quotes": 0,
"reposts": 0,
"reshares": 0,
"isReply": false,
"paidPartnership": false,
"hasLiked": false,
"canReply": true,
"replyControl": "everyone",
"edited": false,
"hasAudio": false,
"mediaType": 19,
"width": 612,
"height": 612,
"linkPreviewTitle": "OpenAI\u2019s Fidji Simo Is Taking Medical Leave Amid an Executive Shake-Up",
"linkPreviewDisplay": "wired.com",
"avatar": "https://scontent-ams2-1.cdninstagram.com/v/t51.2885-19/358349676_656641892628917_5352642733335602490_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTMuYzIifQ&_nc_ht=scontent-ams2-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gFVAY3A0790q7TEqPJiYqsgznYlaaLpUb0NxwJcg0Qmee3gAPqi3enDzdWTFwOJsug&_nc_ohc=2u-BPS3p6cgQ7kNvwG5L0Ax&_nc_gid=r4Ieky2tQulDqCOQml_P6A&edm=AJhczIQBAAAA&ccb=7-5&oh=00_Af59cu0V8IBCnFNM2OGAYoudOPo5xAAU8i_zBdLVtcRWvw&oe=69FB5EDC&_nc_sid=4a2096",
"image": null,
"videoUrl": null,
"linkPreviewUrl": "https://l.threads.com/?u=https%3A%2F%2Fwww.wired.com%2Fstory%2Fopenais-fidji-simo-is-taking-a-leave-of-absence%2F&e=AUCCLVJINYciVzcCynSEcPvDIhWDqhC9ku2ccWCRcyRGGU-AXKoYIK9npdiN43ReZZDC8JuU6jwt741WC6B_40OaOttHpKfgG8VBvTOnGPHbPb8XeD33rLfzd0F7sUXqsGgri7Y&s=1",
"linkPreviewImage": "https://external-ams2-1.xx.fbcdn.net/emg1/v/t13/223791030671370022?stp=dst-src&url=https%3A%2F%2Fmedia.wired.com%2Fphotos%2F69d0149cf17585df8fd63f56%2F191%3A100%2Fw_1280%2Cc_limit%2FFidji-Leave-of-Absence-Business-2198337396.jpg&utld=wired.com&_nc_gid=r4Ieky2tQulDqCOQml_P6A&_nc_oc=AdpS0pDuzp8bgcdg5EG94RmGRTtLh37Z7pm8koWX8AfqxF1Z7ppLByKm8QqjwRcq9ME&ccb=7-5&oh=06_Q3--AZmLDRVQc5CcWxqtECfT-KZtGoIOEfutWIgzgrtxkYru&oe=69F778BC&_nc_sid=1d65fc&ig_cache_key=ce0a6db67dbe9e4c94c7bc7b97162d90.1-ccb7-5.e",
"allImages": [],
"allVideos": []
}
]
}
