<< Back to Twitter API Documentation

users/lookup

Return up to 100 users worth of extended information, specified by either ID, screen name, or combination of the two. The author's most recent status (if the authenticating user has permission) will be returned inline.

method status | report a bug

URL:

http://api.twitter.com/1/users/lookup.format

Formats: 

xml, json

HTTP Method(s):

GET, POST

Requires Authentication (about authentication):

true (see usage notes)

API rate limited (about rate limiting):

1 call per request

Parameters:

A comma separated list of user IDs and screen names -- these user_id and screen_name lists can both be specified in the same call as well.

• user_id. Specfies the ID of the user to return.
  • Example: http://api.twitter.com/1/users/lookup.xml?user_id=1401881,1401882
• screen_name. Specfies the screen name of the user to return.
  • Example: http://api.twitter.com/1/users/lookup.xml?screen_name=dougw,raffi

Usage Notes:

• Requests for protected users requires for the calling user be following the protected user, otherwise the protected user's inline status will be removed

• The array of users returned is in no particular order with respect to the parameters passed in

• If a requested user is unknown, suspended, or deleted, then that user will not be returned in the results list

Response (about return values): 

          XML example:

<?xml version="1.0" encoding="UTF-8"?>

<users type="array">

   <user> 

<id>1401881</id>

<name>Doug Williams</name>

<screen_name>dougw</screen_name>

<location>San Francisco, CA</location>

<description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>

<profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>

<url>http://www.igudo.com</url>

<protected>false</protected>

<followers_count>1031</followers_count>

<profile_background_color>9ae4e8</profile_background_color>

<profile_text_color>000000</profile_text_color>

<profile_link_color>0000ff</profile_link_color>

<profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>

<profile_sidebar_border_color>87bc44</profile_sidebar_border_color>

<friends_count>293</friends_count>

<created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>

<favourites_count>0</favourites_count>

<utc_offset>-18000</utc_offset>

<time_zone>Eastern Time (US & Canada)</time_zone>

<profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>

<profile_background_tile>false</profile_background_tile>

<statuses_count>3390</statuses_count>

<notifications>false</notifications>

<following>false</following>

<verified>true</verified>

<status>

<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>

<id>1472669360</id>

<text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking you're a cul-de-sac.</text>

<source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>

<truncated>false</truncated>

<in_reply_to_status_id></in_reply_to_status_id>

<in_reply_to_user_id></in_reply_to_user_id>

<favorited>false</favorited>

<in_reply_to_screen_name></in_reply_to_screen_name>

</status>

   </user>

   ...

</users>

Usage examples: 

cURL (about cURL):

          Do you have an example to share in the language of your choice? Please share!

<< Back to Twitter API Documentation