Get Started
User Endpoint
Tweet Endpoint
List Endpoint
Batch Get User Info By UserIds
Batch get user info by user ids. Pricing:
- Single user request: 18 credits per user
- Bulk request (100+ users): 10 credits per user
Note: For cost optimization, we recommend batching requests when fetching multiple user profiles.
curl --request GET \
--url https://api.twitterapi.io/twitter/user/batch_info_by_ids \
--header 'X-API-Key: <api-key>'
{
"users": [
{
"type": "user",
"userName": "<string>",
"url": "<string>",
"id": "<string>",
"name": "<string>",
"isBlueVerified": true,
"profilePicture": "<string>",
"coverPicture": "<string>",
"description": "<string>",
"location": "<string>",
"followers": 123,
"following": 123,
"canDm": true,
"createdAt": "<string>",
"fastFollowersCount": 123,
"favouritesCount": 123,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 123,
"statusesCount": 123,
"withheldInCountries": [
"<string>"
],
"affiliatesHighlightedLabel": {},
"possiblySensitive": true,
"pinnedTweetIds": [
"<string>"
],
"isAutomated": true,
"automatedBy": "<string>",
"unavailable": true,
"message": "<string>",
"unavailableReason": "<string>",
"profile_bio": {
"description": "<string>",
"entities": {
"description": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
},
"url": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
}
}
}
}
],
"status": "success",
"msg": "<string>"
}
Authorizations
Query Parameters
The user ids to get.eg. 1234567890,1234567891,1234567892. Use comma to separate multiple user ids
Response
Array of user infos
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
Status of the request.success or error
success
, error
Message of the request.error message
curl --request GET \
--url https://api.twitterapi.io/twitter/user/batch_info_by_ids \
--header 'X-API-Key: <api-key>'
{
"users": [
{
"type": "user",
"userName": "<string>",
"url": "<string>",
"id": "<string>",
"name": "<string>",
"isBlueVerified": true,
"profilePicture": "<string>",
"coverPicture": "<string>",
"description": "<string>",
"location": "<string>",
"followers": 123,
"following": 123,
"canDm": true,
"createdAt": "<string>",
"fastFollowersCount": 123,
"favouritesCount": 123,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 123,
"statusesCount": 123,
"withheldInCountries": [
"<string>"
],
"affiliatesHighlightedLabel": {},
"possiblySensitive": true,
"pinnedTweetIds": [
"<string>"
],
"isAutomated": true,
"automatedBy": "<string>",
"unavailable": true,
"message": "<string>",
"unavailableReason": "<string>",
"profile_bio": {
"description": "<string>",
"entities": {
"description": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
},
"url": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
}
}
}
}
],
"status": "success",
"msg": "<string>"
}