Felo API PlatformFelo API Platform

Data API / X / User

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.

Parameters

query

  • userIdstringOptional

    User ID of the user whose timeline to retrieve.

  • includeRepliesbooleanOptional

    Whether to include replies in the results. Defaults to false.

  • includeParentTweetbooleanOptional

    Whether to include the parent tweet when a tweet is a reply. Defaults to false.

  • cursorstringOptional

    Cursor for paginating through results. Leave empty for the first page.

Example request

curl -X GET "https://openapi.felo.ai/v1/beta/twitter/user/tweet_timeline" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

  • statusstringOptional

    Allowed values: success · error

  • codeintegerOptional

    Provider status code.

  • msgstringOptional
  • dataobjectOptional
  • tweetsobject[]Optional
  • pin_tweetOptional
  • has_next_pagebooleanOptional
  • next_cursorOptional