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
GET friendships/show¶
Returns detailed information about the relationship between two arbitrary users.
Resource URL¶
https://api.twitter.com/1.1/friendships/show.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes |
Rate limited? | Yes |
Requests / 15-min window (user auth) | 180 |
Requests / 15-min window (app auth) | 15 |
Parameters¶
Name | Required | Description | Default Value | Example |
source_id | optional | The user_id of the subject user. | 3191321 | |
source_screen_name | optional | The screen_name of the subject user. | raffi | |
target_id | optional | The user_id of the target user. | 20 | |
target_screen_name | optional | The screen_name of the target user. | noradio |
Example Request¶
GET https://api.twitter.com/1.1/friendships/show.json?source_screen_name=bert&target_screen_name=ernie
Example Response¶
{
"relationship": {
"target": {
"id_str": "12148",
"id": 12148,
"screen_name": "ernie",
"following": false,
"followed_by": false
},
"source": {
"can_dm": false,
"blocking": null,
"muting": null,
"id_str": "8649302",
"all_replies": null,
"want_retweets": null,
"id": 8649302,
"marked_spam": null,
"screen_name": "bert",
"following": false,
"followed_by": false,
"notifications_enabled": null
}
}
}