Twitter / X Profiles

Extract Twitter user data — bio, follower count, following count, recent posts — from usernames or profile URLs

$0.3 / 1k profiles

Extract Twitter user data — bio, follower count, following count, recent posts — from usernames or profile URLs

Endpoint

POST /api/v1/agents/twitter/profiles/run

Parameters

inputs · array · required

List · One per line. You can input profile URLs, handles, or search keywords (e.g. ‘AI researchers’).

maxResults · integer · default: 100

Number · Maximum number of items that you want as output. Use 0 for all.

Response columns

Field	Display name	Type
profileUrl	Profile URL	url
username	Username	text
displayName	Display Name	text
bio	Bio	text
profilePicture	Profile Picture	url
coverImage	Cover Image	url
location	Location	text
followers	Followers	number
following	Following	number
tweets	Tweets	number
likesGiven	Likes Given	number
media	Media	number
listCount	List Count	number
verified	Verified	boolean
graduated	Graduated	boolean
nftAvatar	NFT Avatar	boolean
protected	Protected	boolean
sensitive	Sensitive	boolean
joinedTwitter	Joined Twitter	text
profession	Profession	text
accountType	Account Type	text
type	Type	text

Example

curl

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

Example response

Response

{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "profileUrl": "https://x.com/KingJames",
      "username": "KingJames",
      "displayName": "LeBron James",
      "bio": "EST. AKRON - ST.V/M Class of '03 https://t.co/TrZZrgA5Yt #IPROMISE",
      "profilePicture": "https://pbs.twimg.com/profile_images/1904731639910965248/6bcSSJnG_normal.jpg",
      "coverImage": "https://pbs.twimg.com/profile_banners/23083404/1529843462",
      "location": "Outer Space    ",
      "followers": 48900102,
      "following": 182,
      "tweets": 9698,
      "likesGiven": 162,
      "media": 768,
      "listCount": 43552,
      "verified": true,
      "graduated": true,
      "nftAvatar": false,
      "protected": false,
      "sensitive": false,
      "joinedTwitter": "Fri Mar 06 16:25:53 +0000 2009",
      "profession": null,
      "accountType": null,
      "type": "user"
    }
  ]
}