Threads Search

Search Threads for posts and users matching a searchQuery, returning post content and user details

$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

query · string · required

Text · Enter keywords, topics, hashtags, or phrases to search for in Threads posts. Example: ‘trump’, ‘artificial intelligence’, ‘#tech’, etc.

sortBy · string · default: "top"

Dropdown · Choose how to sort search results. ‘top’ shows most relevant/popular posts first, ‘recent’ shows newest posts first.

Options: top, recent

fromUser · string

Text · Only posts from this username (e.g. ‘foxnews’, ‘meta’). Leave empty to search all users.

startDate · date

Date picker · Earliest post date. Leave blank for no lower bound.

endDate · date

Date picker · Latest post date. Leave blank for no upper bound.

maxResults · integer · default: 50

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

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

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": []
    }
  ]
}