users/suggestions/:slug

Access the users in a given category of the Twitter suggested user list.

It is recommended that end clients cache this data for no more than one hour.

method status | report a bug

URL:

http://api.twitter.com/1/users/suggestions/slug.format

Formats: 

xml, json

HTTP Method(s):

GET

Requires Authentication (about authentication):

false (see usage notes)

API rate limited (about rate limiting):

1 call per request

Response (about return values): 

          XML example:

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

    <category>

        <name>Twitter</name>

        <slug>twitter</slug>

        <categories type="array"></categories>

        <users type="array">

            <user>

              <id>6253282</id>

              <name>Twitter API</name>

              <screen_name>twitterapi</screen_name>

              <location>San Francisco, CA</location>

              <description>The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.</description>

              <profile_image_url>http://a3.twimg.com/profile_images/689684365/api_normal.png</profile_image_url>

              <url>http://apiwiki.twitter.com</url>

              <protected>false</protected>

              <followers_count>79071</followers_count>

              <profile_background_color>c1dfee</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>11</friends_count>

              <created_at>Wed May 23 06:01:13 +0000 2007</created_at>

              <favourites_count>1</favourites_count>

              <utc_offset>-28800</utc_offset>

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

              <profile_background_image_url>http://a3.twimg.com/profile_background_images/59931895/twitterapi-background-new.png</profile_background_image_url>

              <profile_background_tile>false</profile_background_tile>

              <notifications></notifications>

              <geo_enabled>true</geo_enabled>

              <verified>true</verified>

              <following></following>

              <statuses_count>1543</statuses_count>

              <lang>en</lang>

              <contributors_enabled>true</contributors_enabled>

          </user>

          ...

      </users>

  </category>

Usage examples: 

cURL (about cURL):

curl http://api.twitter.com/1/users/suggestions/twitter.xml

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

<< Back to Twitter API Documentation