Twitter User Info
twitter_user_infoFetch a Twitter / X user's full public profile (counts, verification, professional / Premium attributes, pinned tweet)
Category: twitter•Timeout: 300s• Retryable
Input schema
POST this shape to /api/v1/tasks as the input field when creating a task in a group of type twitter_user_info.
{
"type": "object",
"properties": {
"screenName": {
"type": "string",
"minLength": 1,
"maxLength": 15,
"pattern": "^[A-Za-z0-9_]{1,15}$",
"description": "X handle without the @ prefix (e.g. \"elonmusk\")",
"examples": [
"elonmusk",
"AnthropicAI",
"OpenAI"
]
}
},
"required": [
"screenName"
]
}Output schema
Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Canonical profile URL"
},
"data": {
"type": "object",
"description": "Flattened profile (merged from UserByScreenName result.core/legacy/professional/verification_info/etc.)",
"properties": {
"restId": {
"type": "string",
"description": "Numeric user id"
},
"screenName": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"descriptionEntities": {
"type": "object",
"description": "URLs / hashtags / mentions found inside the bio with their character indices",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "object"
}
},
"hashtags": {
"type": "array",
"items": {
"type": "object"
}
},
"mentions": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"location": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"description": "Profile website (t.co expanded)"
},
"joinedAt": {
"type": "string",
"description": "ISO 8601"
},
"profileImageUrl": {
"type": "string"
},
"profileImageShape": {
"type": "string",
"description": "Circle | Square | Hexagon (Hexagon = NFT-verified)"
},
"profileBannerUrl": {
"type": [
"string",
"null"
]
},
"protected": {
"type": "boolean"
},
"defaultProfile": {
"type": "boolean"
},
"defaultProfileImage": {
"type": "boolean"
},
"followersCount": {
"type": "integer"
},
"normalFollowersCount": {
"type": "integer"
},
"followingCount": {
"type": "integer"
},
"tweetCount": {
"type": "integer"
},
"favouritesCount": {
"type": "integer"
},
"listedCount": {
"type": "integer"
},
"mediaCount": {
"type": "integer"
},
"isVerified": {
"type": "boolean"
},
"isBlueVerified": {
"type": "boolean"
},
"hasGraduatedAccess": {
"type": "boolean"
},
"verifiedSince": {
"type": [
"string",
"null"
]
},
"verifiedReason": {
"type": [
"string",
"null"
]
},
"isIdentityVerified": {
"type": "boolean"
},
"affiliatesHighlightedLabel": {
"type": [
"object",
"null"
],
"description": "The \"affiliate of\" badge X attaches to verified affiliate accounts",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
},
"badgeUrl": {
"type": "string"
}
}
},
"professional": {
"type": [
"object",
"null"
],
"properties": {
"type": {
"type": "string",
"description": "Creator | Business"
},
"category": {
"type": "array",
"items": {
"type": "object"
}
}
}
},
"pinnedTweetIds": {
"type": "array",
"items": {
"type": "string"
}
},
"birthdate": {
"type": [
"object",
"null"
],
"properties": {
"day": {
"type": "integer"
},
"month": {
"type": "integer"
},
"year": {
"type": [
"integer",
"null"
]
},
"visibility": {
"type": "string"
}
}
},
"creatorSubscriptionsCount": {
"type": "integer"
},
"canDm": {
"type": "boolean"
},
"canMediaTag": {
"type": "boolean"
},
"translatorType": {
"type": "string"
},
"possiblySensitive": {
"type": "boolean"
},
"withheldInCountries": {
"type": "array",
"items": {
"type": "string"
}
},
"withheldScope": {
"type": "string"
},
"superFollowEligible": {
"type": "boolean"
},
"businessAccount": {
"type": [
"object",
"null"
]
}
}
}
},
"required": [
"url",
"data"
]
}Ready to run Twitter User Info?
Create a project, approve an executor, and push your first twitter_user_info task.