Twitter / X Posts

Extract tweets from Twitter by keyword, URL, list, or profile, with content, date, and engagement metrics

$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 + Top

Legend: 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

Field	Display name	Type
tweetUrl	Tweet URL	url
tweetText	Tweet Text	text
posted	Posted	text
language	Language	text
authorName	Author Name	text
authorHandle	Author Handle	text
authorAvatar	Author Avatar	url
authorFollowers	Author Followers	number
authorBlueCheck	Author Blue Check	boolean
likes	Likes	number
retweets	Retweets	number
replies	Replies	number
quotes	Quotes	number
views	Views	number
bookmarks	Bookmarks	number
isReply	Is Reply	boolean
isQuote	Is Quote	boolean
isRetweet	Is Retweet	boolean
sensitive	Sensitive	boolean
type	Type	text

Example

curl

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