Twitter / X
Query public users, posts, communities and trends.
Get User Followers
List the accounts that follow a given X user, identified by @handle, newest follower first. Returns up to 200 per page by default with has_next_page and next_cursor; each entry is a full user object (handle, name, bio, follower count, verification). Use this for audience analysis, mapping a competitor's follower base, or finding influential followers. For the reverse direction (who this user follows) use get_twitter_user_followings. For only the verified subset use get_twitter_user_verified_followers — note that one takes a numeric user_id, not a handle.
Pricing reference
- Metering: Metered result count.
- Reference request estimate: USD 0.00326.
- Minimum cost basis: USD 0.0006.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
- Cost bases do not establish the final customer price, including when zero.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: stringcursor
- Type: stringuser
Name X username (the part after @), for example OpenAI.
- Type: object · ResponseAd3D19335Ae4_UserFollowersResponse200
User followers
- Type: integercode
Integer numbers.
- Type: array object[]followers
Public profile of an X follower.
- propertyType: anything
Name
- Type: booleanhas
_next _page - Type: stringmsg
- Type: string | nullnext
_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
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/twitter/user/followers \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"followers": [
{
"additionalProperty": "anything"
}
],
"has_next_page": true,
"next_cursor": null,
"status": "success",
"msg": "string",
"code": 1
}