GET /statuses/user_timeline

Returns a collection of the most recent Tweets posted by the user indicated by the screen_name or user_id parameters.

User timelines belonging to protected users may only be requested when the authenticated user either “owns” the timeline or is an approved follower of the owner.

The timeline returned is the equivalent of the one seen when you view a user’s profile on twitter.com.

This method can only return up to 3,200 of a user’s most recent Tweets. Native retweets of other statuses by the user is included in this total, regardless of whether include_rts is set to false when requesting this resource.

See Working with Timelines for instructions on traversing timelines.

See Embeddable Timelines, Embeddable Tweets, and GET statuses/oembed for tools to render Tweets according to Display Requirements.

Parameters

user_id
integer
optional

screen_name
string
optional

since_id
integer
optional

count
integer
optional

max_id
integer
optional

trim_user
boolean
optional

exclude_replies
boolean
optional

contributor_details
boolean
optional

include_rts
boolean
optional

Response (Default)

200

id
integer

The id

title
string

The title

users
array

The users

Example
{
  "id": 1,
  "title": "String",
  "users": [
    {
      "profile_sidebar_fill_color": "String",
      "profile_sidebar_border_color": "String"
    }
  ]
}