Skip to main content
POST
/
twitter
/
timeline
/
for-you
For You Timeline
curl --request POST \
  --url https://api.apitwitter.com/twitter/timeline/for-you \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "cookie": "<string>",
  "proxy": "<string>",
  "count": 20,
  "cursor": "<string>"
}
'
{
  "data": {
    "tweets": [
      {
        "id": "2031042859114369256",
        "text": "Example tweet from For You timeline",
        "created_at": "Mon Mar 09 16:22:07 +0000 2026",
        "author": {
          "id": "44196397",
          "userName": "elonmusk",
          "name": "Elon Musk",
          "screen_name": "elonmusk",
          "followers_count": 236242950,
          "friends_count": 1292,
          "statuses_count": 98757,
          "favourites_count": 215441,
          "listed_count": 167614,
          "description": "",
          "location": "",
          "profile_image_url_https": "",
          "profile_image_url": "",
          "profile_banner_url": "https://pbs.twimg.com/profile_banners/44196397/1739948056",
          "verified": false,
          "is_blue_verified": true,
          "created_at": "",
          "can_dm": false
        },
        "likeCount": 25604,
        "retweetCount": 3699,
        "replyCount": 1335,
        "viewCount": 1325114,
        "isRetweet": false,
        "isReply": false
      }
    ],
    "has_next_page": true,
    "next_cursor": "DAABCgABHC..."
  },
  "source": "for_you"
}

Authorizations

​
X-API-Key
string
header
required

Your API key

Body

application/json
​
cookie
string
required

Twitter auth cookie

​
proxy
string
required

Proxy URL to use for the request (HTTP or SOCKS5)

​
count
integer
default:20

Number of tweets to return, 1-100 (default: 20)

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor for the next page

Response

Timeline tweets

​
status
string

Response status

Example:

"success"

​
msg
string

Response message

​
data
any

Response data