Timelines (Activity Streams)

GET /api/statuses/public_timeline.as

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 ActivityStream status objects

GET /api/statuses/home_timeline.as

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 ActivityStream status objects

GET /api/statuses/friends_timeline.as

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 ActivityStream status objects

GET /api/statuses/user_timeline.as

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 ActivityStream status objects

GET /api/statuses/mentions.as

GET /api/statuses/mentions_timeline.as

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 ActivityStream status objects

GET /api/statuses/replies.as

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 ActivityStream status objects