Timelines¶
-
GET
/api/statuses/public_timeline.json
¶ Show the most recent notices, including repeats if they exist, from non-protected users.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
Example response: a list of status objects
-
GET
/api/statuses/home_timeline.json
¶ Show the most recent notices, including repeats if they exist, posted by the authenticating user and the users they follow.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
Example response: a list of status objects
-
GET
/api/statuses/friends_timeline.json
¶ Show the most recent notices, including repeats if they exist, posted by the authenticating or specified user and the users they follow.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
- user_id (int) – ID of the user whose timeline to show
- screen_name (string) – handle of the user whose timeline to show
Example response: a list of status objects
-
GET
/api/statuses/user_timeline.json
¶ Show the most recent notices posted by the authenticating or specified user.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
- user_id (int) – ID of the user whose timeline to show
- screen_name (string) – handle of the user whose timeline to show
Example response: a list of status objects
-
GET
/api/statuses/mentions.json
¶ -
GET
/api/statuses/mentions_timeline.json
¶ Show the most recent mentions (notices containing @username) for the authenticating user or specified user.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
- user_id (int) – ID of the user whose timeline to show
- screen_name (string) – handle of the user whose timeline to show
Example response: a list of status objects
-
GET
/api/statuses/replies.json
¶ Show the most recent mentions (notices containing @username) for the authenticating user or specified user.
Query Parameters: - count (int) – number of statuses to try and retrieve
- since_id (int) – returns statuses with an ID greater than (that is, more recent than) the specified ID
- max_id (int) – returns statuses with an ID less than (that is, older than) or equal to the specified ID
- user_id (int) – ID of the user whose timeline to show
- screen_name (string) – handle of the user whose timeline to show
Example response: a list of status objects