Twitter / X
Query public users, posts, communities and trends.
Get User Followings
List the accounts a given X user follows, identified by @handle. Returns 200 entries per page with has_next_page and next_cursor. Use this to infer a user's interests, information sources, or professional network — who someone follows is usually a stronger signal of intent than who follows them. For the opposite direction use get_twitter_user_followers. To test a single specific pair without paging through thousands of records, use get_twitter_user_check_follow_relationship.
- Type: stringuser
Name requiredScreen name of the user.
- Type: stringcursor
The cursor to paginate through the results. First page is empty.
- Type: integerpage
Size min:20max:200The number of followings to return per page.
- Type: object · UserFollowingsResponse200
Successful response
- Type: integercode
Integer numbers.
- Type: array object[] · User[]followings
- automatedType: string
By - canType: boolean
Dm - coverType: string
Picture - createdType: string
At - descriptionType: string
- favouritesType: integer
Count Integer numbers.
- followersType: integer
Integer numbers.
- followingType: integer
Integer numbers.
- hasType: boolean
Custom Timelines - idType: string
- isType: boolean
Automated - isType: boolean
Blue Verified - isType: boolean
Translator - locationType: string
- mediaType: integer
Count Integer numbers.
- messageType: string
- nameType: string
- pinnedType: array string[]
Tweet Ids - possiblyType: boolean
Sensitive - profileType: object
_bio - descriptionType: string
- entitiesType: object
- descriptionType: object
- urlsType: array object[]
- displayType: string
_url - expandedType: string
_url - indicesType: array integer[]
- urlType: string
- urlType: object
- urlsType: array object[]
- displayType: string
_url - expandedType: string
_url - indicesType: array integer[]
- urlType: string
- profileType: string
Picture - statusesType: integer
Count Integer numbers.
- typeType: string
- unavailableType: boolean
- unavailableType: string
Reason - urlType: string
- userType: string
Name - verifiedType: string
Type - withheldType: array string[]
In Countries
- Type: booleanhas
_next _page - Type: stringmsg
- Type: stringnext
_cursor - Type: string enumstatusvalues
- success
- error
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl 'https://openapi.felo.ai/v1/beta/twitter/user/followings?userName=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"followings": [
{
"type": "string",
"userName": "string",
"url": "string",
"id": "string",
"name": "string",
"isBlueVerified": true,
"verifiedType": "string",
"profilePicture": "string",
"coverPicture": "string",
"description": "string",
"location": "string",
"followers": 1,
"following": 1,
"canDm": true,
"createdAt": "string",
"favouritesCount": 1,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 1,
"statusesCount": 1,
"withheldInCountries": [
"string"
],
"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": [
1
],
"url": "string"
}
]
},
"url": {
"urls": [
{
"display_url": "string",
"expanded_url": "string",
"indices": [
1
],
"url": "string"
}
]
}
}
}
}
],
"has_next_page": true,
"next_cursor": "string",
"status": "success",
"msg": "string",
"code": 1
}