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

inputs · array · required

List · One per line. For User mode: usernames (without @). For Hashtag/Search: keywords or hashtags.

maxResults · integer · default: 200

Number · Posts per user or keyword. Use 0 for all (minimum: 10).

mode · 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

startDate · date

Date picker · Earliest post date. Only applies to Hashtag / Search modes.

endDate · date

Date picker · Latest post date. Only applies to Hashtag / Search modes.

searchFilter · string · default: "top"

Dropdown · Sort order. Only applies to Search mode.

Options: top, recent

Legend: top = Top (popular), recent = Most recent

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

curl

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
  }
}'

Example response

Response

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