GET friendships/lookup

Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or user_ids provided. Values for connections can be: following, following_requested, followed_by, none, blocking, muting.

Resource URL

https://api.twitter.com/1.1/friendships/lookup.json

Resource Information

Response formats
JSON
Requires authentication?
Yes (user context only)
Rate limited?
Yes
Requests / 15-min window (user auth)
15

Parameters

screen_name optional

A comma separated list of screen names, up to 100 are allowed in a single request.

Example Values: twitterapi,twitter

user_id optional

A comma separated list of user IDs, up to 100 are allowed in a single request.

Example Values: 783214,6253282

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET
https://api.twitter.com/1.1/friendships/lookup.json?screen_name=episod,twitterapi,whiteleaf,andypiper

Example Result

[
  {
    "name": "Taylor Singletary",
    "screen_name": "episod",
    "id": 819797,
    "id_str": "819797",
    "connections": [
      "following",
      "followed_by"
    ]
  },
  {
    "name": "Twitter API",
    "screen_name": "twitterapi",
    "id": 6253282,
    "id_str": "6253282",
    "connections": [
      "following",
      "followed_by"
    ]
  },
  {
    "name": "White Leaf",
    "screen_name": "whiteleaf",
    "id": 22479443,
    "id_str": "22479443",
    "connections": [
      "followed_by",
      "muting"
    ]
  },
  {
    "name": "Andy Piper",
    "screen_name": "andypiper",
    "id": 786491,
    "id_str": "786491",
    "connections": [
      "none"
    ]
  }
]