Skip to main content

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.

$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, searchLegend: 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, recentLegend: top = Top (popular), recent = Most recent

​
Response columns

FieldDisplay nameType
postUrlPost URLurl
postTextPost Texttext
postedPostedtext
usernameUsernametext
displayNameDisplay Nametext
verifiedVerifiedboolean
profileUrlProfile URLurl
followersFollowersnumber
bioBiotext
profileTagsProfile Tagstext
likesLikesnumber
repliesRepliesnumber
repostsRepostsnumber
quotesQuotesnumber
sharesSharesnumber
viewsViewsnumber
pinnedPinnedboolean
isRepostIs Repostboolean
isQuoteIs Quoteboolean
isReplyIs Replyboolean
paidPartnershipPaid Partnershipboolean
hasMediaHas Mediaboolean
mediaTypeMedia Typetext
replyToReply Totext
replyControlReply Controltext
fediverseFediverseboolean
editedEditedboolean
gifGIFboolean
avatarAvatarurl
mediaUrlMedia URLurl
mentionsMentionstext
urlsURLstext

​
Example

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