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

> Extract Threads posts and user profiles by username, hashtag, or keyword, including engagement metrics

`$3.7 / 1k posts`

Extract Threads posts and user profiles by username, hashtag, or keyword, including engagement metrics

## Endpoint

`POST /api/v1/agents/threads/posts/run`

## Parameters

<ParamField body="inputs" type="array" required>
  **List** · One per line. For User mode: usernames (without @). For Hashtag/Search: keywords or hashtags.
</ParamField>

<ParamField body="maxResults" type="integer" default={200}>
  **Number** · Posts per user or keyword. Use 0 for all (minimum: 10).
</ParamField>

<ParamField body="mode" type="string" default="user">
  **Dropdown** · What to scrape. User pulls a profile's post history; By Hashtag pulls posts under a hashtag; Full-text Search ranks by relevance/recency across all of Threads.

  **Options:** `user`, `keyword`, `search`

  *Legend: `user` = User Profile (post history), `keyword` = By Hashtag, `search` = Full-text Search*
</ParamField>

<ParamField body="startDate" type="date">
  **Date picker** · Earliest post date. Only applies to Hashtag / Search modes.
</ParamField>

<ParamField body="endDate" type="date">
  **Date picker** · Latest post date. Only applies to Hashtag / Search modes.
</ParamField>

<ParamField body="searchFilter" type="string" default="top">
  **Dropdown** · Sort order. Only applies to Search mode.

  **Options:** `top`, `recent`

  *Legend: `top` = Top (popular), `recent` = Most recent*
</ParamField>

## Response columns

| Field             | Display name     | Type    |
| ----------------- | ---------------- | ------- |
| `postUrl`         | Post URL         | url     |
| `postText`        | Post Text        | text    |
| `posted`          | Posted           | text    |
| `username`        | Username         | text    |
| `displayName`     | Display Name     | text    |
| `verified`        | Verified         | boolean |
| `profileUrl`      | Profile URL      | url     |
| `followers`       | Followers        | number  |
| `bio`             | Bio              | text    |
| `profileTags`     | Profile Tags     | text    |
| `likes`           | Likes            | number  |
| `replies`         | Replies          | number  |
| `reposts`         | Reposts          | number  |
| `quotes`          | Quotes           | number  |
| `shares`          | Shares           | number  |
| `views`           | Views            | number  |
| `pinned`          | Pinned           | boolean |
| `isRepost`        | Is Repost        | boolean |
| `isQuote`         | Is Quote         | boolean |
| `isReply`         | Is Reply         | boolean |
| `paidPartnership` | Paid Partnership | boolean |
| `hasMedia`        | Has Media        | boolean |
| `mediaType`       | Media Type       | text    |
| `replyTo`         | Reply To         | text    |
| `replyControl`    | Reply Control    | text    |
| `fediverse`       | Fediverse        | boolean |
| `edited`          | Edited           | boolean |
| `gif`             | GIF              | boolean |
| `avatar`          | Avatar           | url     |
| `mediaUrl`        | Media URL        | url     |
| `mentions`        | Mentions         | text    |
| `urls`            | URLs             | text    |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/threads/posts/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "mode": "user",
      "usernames": [
        "zuck"
      ],
      "keywords": [
        "AI"
      ],
      "searchFilter": "top",
      "maxResults": 10
    }
  }'
  ```

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

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/threads/posts/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "mode": "user",
      "usernames": [
          "zuck"
      ],
      "keywords": [
          "AI"
      ],
      "searchFilter": "top",
      "maxResults": 10
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "postUrl": "https://www.threads.com/@zuck/post/DXt5n9UlLl-",
      "postText": "As part of our philanthropic work to help cure all diseases, our team @biohub is announcing the Virtual Biology Initiative -- a new effort to build the imaging tools, molecular tools, and open data infrastructure needed to build AI models that can reason about cells.",
      "posted": "2026-04-29T13:26:07+00:00",
      "username": "zuck",
      "displayName": "Mark Zuckerberg",
      "verified": true,
      "profileUrl": "https://www.threads.com/@zuck",
      "followers": 5458126,
      "bio": "Mostly superintelligence and MMA takes",
      "profileTags": [
        "AI Threads",
        "UFC Threads",
        "AI",
        "MMA",
        "memes"
      ],
      "likes": 1279,
      "replies": 271,
      "reposts": 99,
      "quotes": 5,
      "shares": 38,
      "views": 90483,
      "pinned": false,
      "isRepost": false,
      "isQuote": false,
      "isReply": false,
      "paidPartnership": false,
      "hasMedia": false,
      "mediaType": "text",
      "replyTo": null,
      "replyControl": "everyone",
      "fediverse": true,
      "edited": false,
      "gif": false,
      "avatar": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/550174606_17925811725103224_8363667901743352243_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gFdwia7eFeeYAYmbUQSLwU8h_LP9syst1w7-O23tcyh_0Lr5C-O0CKTDsL7VZf4_zQ&_nc_ohc=YhOTPFVMMdwQ7kNvwEhGf7H&_nc_gid=2Mw30dwluaNW_22SHeDF9A&edm=APs17CUBAAAA&ccb=7-5&oh=00_Af5LrRXWb9MWdCTw7M1lGY7kZV5NRBF_aswyZiOxdcI9ww&oe=69FA5EFE&_nc_sid=10d13b",
      "mediaUrl": null,
      "mentions": [
        "biohub"
      ],
      "urls": []
    }
  ]
}
```