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

# 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

<ParamField body="inputs" type="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.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Maximum number of tweets to return. Use 0 for all.
</ParamField>

<ParamField body="sort" type="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*
</ParamField>

<ParamField body="verifiedOnly" type="boolean">
  **Toggle** · Only return tweets from verified (blue-check) accounts.
</ParamField>

<ParamField body="minimumRetweets" type="integer">
  **Number** · Minimum number of retweets a tweet must have.
</ParamField>

<ParamField body="minimumReplies" type="integer">
  **Number** · Minimum number of replies a tweet must have.
</ParamField>

<ParamField body="startDate" type="date">
  **Date picker** · Only tweets posted on or after this date.
</ParamField>

<ParamField body="endDate" type="date">
  **Date picker** · Only tweets posted on or before this date.
</ParamField>

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

<CodeGroup>
  ```bash curl theme={null}
  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"
      ]
    }
  }'
  ```

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

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/twitter/tweets/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"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"
      ]
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "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"
    }
  ]
}
```