Twitter / X
Query public users, posts, communities and trends.
Get User Tweet Timeline
Retrieve a user's own tweets by numeric userId, newest first, matching the order shown on their profile in the X app. Up to 20 tweets per page; pass the returned cursor for more. Optionally include replies and the parent tweet of each reply. Use this to read what an account publishes over time. Time-range filtering is NOT supported here — if you need tweets within a specific time window, use get_twitter_user_mentions (which accepts sinceTime/untilTime) or get_twitter_tweet_advanced_search with date operators in the query. If you only have a @handle, get_twitter_user_last_tweets accepts either handle or ID.
- Type: stringuser
Id User ID of the user whose timeline to retrieve.
- Type: booleaninclude
Replies Whether to include replies in the results. Defaults to false.
- Type: booleaninclude
Parent Tweet Whether to include the parent tweet when a tweet is a reply. Defaults to false.
- Type: stringcursor
Cursor for paginating through results. Leave empty for the first page.
- Type: object · UserTweetsResponse200
User tweet timeline
- Type: integercode
Provider status code.
- Type: objectdata
- pinType: object nullable
_tweet - propertyType: anything
Name
- tweetsType: array object[]
Tweet object returned by TwitterAPI.io.
- propertyType: anything
Name
- propertyType: anything
Name
- Type: booleanhas
_next _page - Type: stringmsg
- Type: string nullablenext
_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/tweet_timeline \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"status": "success",
"code": 1,
"msg": "string",
"data": {
"tweets": [
{
"additionalProperty": "anything"
}
],
"pin_tweet": {
"additionalProperty": "anything"
},
"additionalProperty": "anything"
},
"has_next_page": true,
"next_cursor": "string"
}