Follow, search, and get users
API Reference contents
GET followers/ids
GET followers/list
GET friends/ids
GET friends/list
GET friendships/incoming
GET friendships/lookup
GET friendships/no_retweets/ids
GET friendships/outgoing
GET friendships/show
GET users/lookup
GET users/search
GET users/show
GET users/suggestions
GET users/suggestions/:slug
GET users/suggestions/:slug/members
POST friendships/create
POST friendships/destroy
POST friendships/update
POST friendships/destroy¶
Allows the authenticating user to unfollow the user specified in the ID parameter.
Returns the unfollowed user when successful. Returns a string describing the failure condition when unsuccessful.
Actions taken in this method are asynchronous. Changes will be eventually consistent.
Resource URL¶
https://api.twitter.com/1.1/friendships/destroy.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes (user context only) |
Rate limited? | Yes |
Parameters¶
Name | Required | Description | Default Value | Example |
screen_name | optional | The screen name of the user to unfollow. | twitterdev | |
user_id | optional | The ID of the user to unfollow. | 12345 |
Example Request¶
POST https://api.twitter.com/1.1/friendships/destroy.json?user_id=2244994945
Example Response¶
{user-object,
"status": {tweet-object}
}