Twitter API Status Method Reference

Path

/statuses/destroy/id.xml

Requires authentication

Yes (the account owns the existing update).

Charged against rate limit

No.

HTTP method type

POST or DELETE.

Required parameters

id

Provides the record ID for an existing status update owned by the authenticating user. The id parameter is passed as part of the URL request.

Successful output

See the section called “Publishing”.

Path

/statuses/followers.xml

Requires authentication

Yes (authenticating user must be allowed by the author to view a private list of followers).

Charged against rate limit

Yes.

HTTP method type

GET.

Optional parameters

id

Indicates the user ID or username of the Twitter account whose follower list you want to view. The id parameter is passed as part of the URL request: /statuses/followers/id.xml.

page

Indicates which page of 100 users to return. The default is 1 (users most recently created).

Successful output

See the section called “The Follow Network”.

Path

/statuses/friends.xml

Requires authentication

Yes, if the account is private (authenticating user must be allowed by the author to view the list of friends).

Charged against rate limit

Yes.

HTTP method type

GET.

Optional parameters

id

Indicates the user ID or username of the Twitter account whose following list you want to view. The id parameter is passed as part of the URL request: /statuses/friends/id.xml.

page

Indicates which page of 100 users to return. The default is 1 (users most recently followed).

Successful output

See the section called “The Follow Network”.

Path

/statuses/friends_timeline.xml

Requires authentication

Yes.

Charged against rate limit

Yes.

HTTP method type

GET.

Optional parameters

since

Ignores information older than the specified time (which must be within the last 24 hours). The value must be encoded in the format “Mon, 3 Nov 2008 18:39:12 GMT”.

since_id

Returns only the most recent updates (those made since the specified record ID was created).

count

Limits the most recent status updates to the number of records specified. The maximum count is 200, and the default is 20.

page

Indicates which page of 20 items to return. The default is 1 (the most recent status updates).

Successful output

See the section called “The Information Stream”.

Path

/statuses/public_timeline.xml

Requires authentication

No.

Charged against rate limit

No.

HTTP method type

GET.

Successful output

See the section called “The Information Stream”.

Path

/statuses/replies.xml

Requires authentication

Yes (replies are to the authenticating user).

Charged against rate limit

Yes.

HTTP method type

GET.

Optional parameters

since

Ignores information older than the specified time (which must be within the last 24 hours). The value must be encoded in the format “Mon, 3 Nov 2008 18:39:12 GMT”.

since_id

Returns only the most recent updates (those made since the specified record ID was created).

count

Limits the most recent replies to the number of records specified. The maximum count is 200, and the default is 20.

page

Indicates which page of 20 items to return. The maximum value is currently 40, and the default is 1 (the most recent status updates).

Successful output

See the section called “The Information Stream”.

Path

/statuses/show/id.xml

Requires authentication

Yes, if the status update is private (authenticating user must be allowed by the author to view the text).

Charged against rate limit

Yes.

HTTP method type

GET.

Required parameters

id

Provides the record ID for an existing status update owned by the authenticating user. The id parameter is passed as part of the URL request.

Successful output

See the section called “The Information Stream”.

Path

/statuses/update.xml

Requires authentication

Yes (this account owns the status update).

Charged against rate limit

No.

HTTP method type

POST.

Required parameters

status

Indicates the text used to update the authenticating user’s status. This string is limited to 140 characters after URL encoding.

Optional parameters

in_reply_to_status_id

Provides the record ID of an existing status update to which the new update will be attached.

source

Identifies the name of the tool used to publish the tweet (as in “web” or “twitterrific”).

Successful output

See the section called “Publishing”.

Path

/statuses/user_timeline/id.xml

Requires authentication

Yes, if the account is private (authenticating user must be allowed by the author to view the timeline).

Charged against rate limit

Yes.

HTTP method type

GET.

Required parameters

None, if authenticated (Twitter assumes the authenticating user is the id).

Optional parameters

id

Provides the user ID or username for the Twitter account whose timeline you want to view. The id parameter is passed as part of the URL request.

since

Ignores information older than the specified time (which must be within the last 24 hours). The value must be encoded in the format “Mon, 3 Nov 2008 18:39:12 GMT”.

since_id

Returns only the most recent updates (those made since the specified record ID was created).

count

Limits the most recent status updates to the number of records specified. The maximum count is 200, and the default is 20.

page

Indicates which page of 20 items to return. The default is 1 (the most recent status updates).

Successful output

See the section called “The Information Stream”.