> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField body="query" type="string" required>
  **Text** · Enter keywords, topics, hashtags, or phrases to search for in Threads posts. Example: 'trump', 'artificial intelligence', '#tech', etc.
</ParamField>

<ParamField body="sortBy" type="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`
</ParamField>

<ParamField body="fromUser" type="string">
  **Text** · Only posts from this username (e.g. 'foxnews', 'meta'). Leave empty to search all users.
</ParamField>

<ParamField body="startDate" type="date">
  **Date picker** · Earliest post date. Leave blank for no lower bound.
</ParamField>

<ParamField body="endDate" type="date">
  **Date picker** · Latest post date. Leave blank for no upper bound.
</ParamField>

<ParamField body="maxResults" type="integer" default={50}>
  **Number** · Maximum number of posts to scrape from search results. Use 0 for all (minimum: 10).
</ParamField>

## 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

<CodeGroup>
  ```bash curl theme={null}
  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
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/threads/search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "query": "OpenAI",
      "sortBy": "top",
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "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": []
    }
  ]
}
```