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.

$0.2 / 1k tweets Extract tweets from Twitter by keyword, URL, list, or profile, with content, date, and engagement metrics

​
Endpoint

POST /api/v1/agents/twitter/tweets/run

​
Parameters

​
inputs
array
required
List · One per line. You can input tweet/profile URLs, handles, or search keywords (e.g. ‘AI research’, ‘product launch’). Use the date filters below for time ranges.
​
maxResults
integer
default:100
Number · Maximum number of tweets to return. Use 0 for all.
​
sort
string
default:"Latest"
Dropdown · Sort order for search results. Default is ‘Latest’.Options: Top, Latest, Latest + TopLegend: Top = Top Tweets, Latest = Latest Tweets, Latest + Top = Latest + Top Tweets
​
verifiedOnly
boolean
Toggle · Only return tweets from verified (blue-check) accounts.
​
minimumRetweets
integer
Number · Minimum number of retweets a tweet must have.
​
minimumReplies
integer
Number · Minimum number of replies a tweet must have.
​
startDate
date
Date picker · Only tweets posted on or after this date.
​
endDate
date
Date picker · Only tweets posted on or before this date.

​
Response columns

FieldDisplay nameType
tweetUrlTweet URLurl
tweetTextTweet Texttext
postedPostedtext
languageLanguagetext
authorNameAuthor Nametext
authorHandleAuthor Handletext
authorAvatarAuthor Avatarurl
authorFollowersAuthor Followersnumber
authorBlueCheckAuthor Blue Checkboolean
likesLikesnumber
retweetsRetweetsnumber
repliesRepliesnumber
quotesQuotesnumber
viewsViewsnumber
bookmarksBookmarksnumber
isReplyIs Replyboolean
isQuoteIs Quoteboolean
isRetweetIs Retweetboolean
sensitiveSensitiveboolean
typeTypetext

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/twitter/tweets/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "tweetsDesired": 10,
    "maxResults": 10,
    "inputs": [
      "https://x.com/elonmusk",
      "https://x.com/MrBeast",
      "https://x.com/KingJames",
      "https://x.com/taylorswift13",
      "https://x.com/sundarpichai",
      "https://x.com/satyanadella",
      "https://x.com/sama",
      "https://x.com/jensenhuang",
      "https://x.com/tim_cook",
      "https://x.com/BarackObama"
    ]
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "tweetUrl": "https://x.com/satyanadella/status/2050251014691840015",
      "tweetText": "Agent 365 is now generally available!\n\nWe\u2019re extending the systems customers already use for identity, security, governance, and management to every AI agent and their interactions across the enterprise. https://t.co/7skXvhIwYB",
      "posted": "Fri May 01 16:28:28 +0000 2026",
      "language": "en",
      "authorName": "Satya Nadella",
      "authorHandle": "satyanadella",
      "authorAvatar": "https://pbs.twimg.com/profile_images/1221837516816306177/_Ld4un5A_normal.jpg",
      "authorFollowers": 4391082,
      "authorBlueCheck": true,
      "likes": 674,
      "retweets": 107,
      "replies": 78,
      "quotes": 14,
      "views": 67142,
      "bookmarks": 91,
      "isReply": false,
      "isQuote": false,
      "isRetweet": false,
      "sensitive": false,
      "type": "tweet"
    }
  ]
}