Search
  1. lists/subscribers〔特定のリストの参加者を取得(認証不要)〕
  2. lists/subscribers/create〔指定したリストをフォローする(要認証)〕
  3. lists/subscribers/destroy〔指定したリストのフォローを解除する(要認証)〕
  4. lists/subscribers/show〔指定したユーザーが特定のリストをフォローしているかを調べる(要認証)〕

lists/subscribers
特定のリストの参加者を取得(認証不要)

2009/7/18

認証なしAPI制限対象

HTTP GEThttp://api.twitter.com/1/lists/subscribers.[xml|json]

特定のリストの参加者を取得します。 非公開リストの場合、そのリストの所有者が認証ユーザー自身であればその参加者を取得できます。

パラメーター説明
list_id必須 リストIDを指定。
slug必須 リストIDの代わりにslugでリストを識別することができます。 この場合は、リストの所有者を特定するために、owner_idまたはowner_screen_nameパラメータも併用します。
例)http://api.twitter.com/1/lists/subscribers.xml?slug=lifeline&owner_screen_name=cocoism
例)http://api.twitter.com/1/lists/subscribers.xml?slug=lifeline&owner_id=7948862
cursor任意 結果をページ分けを指定します。1ページあたり20リストが含まれます。 ページの始まりには「-1」を指定します。前後ページは、取得したデータの中にあるnext_cursorまたはprevious_cursor属性で参照できます。
例)http://api.twitter.com/1/lists/subscribers.xml?cursor=12893764510938
include_entities任意 ステータス情報に'entities'を含める場合は、true,t,1のいずれかを指定。
例)http://api.twitter.com/1/lists/subscribers.xml?include_entities=true

取得サンプル(XML/JSON)

subscribers.xml
<?xml version="1.0" encoding="UTF-8"?>
<users_list>
<users type="array">
<user>
  <id>55984769</id>
  <name>つんこ</name>
  <screen_name>pjroomer</screen_name>
  <location>Tokyo, Japan</location>
  <description>てすあか</description>
  <profile_image_url>http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png</profile_image_url>
  <url>http://phpjavascriptroom.com</url>
  <protected>false</protected>
  <followers_count>8</followers_count>
  <profile_background_color>C0DEED</profile_background_color>
  <profile_text_color>ff6699</profile_text_color>
  <profile_link_color>0084B4</profile_link_color>
  <profile_sidebar_fill_color>DDEEF6</profile_sidebar_fill_color>
  <profile_sidebar_border_color>C0DEED</profile_sidebar_border_color>
  <friends_count>188</friends_count>
  <created_at>Sun Jul 12 01:37:21 +0000 2009</created_at>
  <favourites_count>99</favourites_count>
  <utc_offset>32400</utc_offset>
  <time_zone>Tokyo</time_zone>
  <profile_background_image_url>http://a0.twimg.com/images/themes/theme1/bg.png</profile_background_image_url>
  <profile_background_tile>false</profile_background_tile>
  <profile_use_background_image>true</profile_use_background_image>
  <notifications>false</notifications>
  <geo_enabled>true</geo_enabled>
  <verified>false</verified>
  <following>false</following>
  <statuses_count>1425</statuses_count>
  <lang>ja</lang>
  <contributors_enabled>false</contributors_enabled>
  <follow_request_sent>false</follow_request_sent>
  <listed_count>5</listed_count>
  <show_all_inline_media>false</show_all_inline_media>
  <default_profile>false</default_profile>
  <default_profile_image>true</default_profile_image>
  <is_translator>false</is_translator>
  <status>
    <created_at>Wed May 25 08:47:15 +0000 2011</created_at>
    <id>73309139866095617</id>
    <text>あいうえお</text>
    <source><a href="http://twitterapi01.appspot.com" rel="nofollow">Tw API test</a></source>
    <truncated>false</truncated>
    <favorited>false</favorited>
    <in_reply_to_status_id></in_reply_to_status_id>
    <in_reply_to_user_id></in_reply_to_user_id>
    <in_reply_to_screen_name></in_reply_to_screen_name>
    <retweet_count>0</retweet_count>
    <retweeted>false</retweeted>
    <geo/>
    <coordinates/>
    <place/>
    <contributors/>
  </status>
</user>
</users>
<next_cursor>0</next_cursor>
<previous_cursor>0</previous_cursor>
</users_list>
subscribers.json
json[users]['0']['profile_background_color']=C0DEED
json[users]['0']['protected']=
json[users]['0']['default_profile_image']=1
json[users]['0']['profile_background_image_url']=http://a0.twimg.com/images/themes/theme1/bg.png
json[users]['0']['followers_count']=8
json[users]['0']['location']=Tokyo, Japan
json[users]['0']['name']=つんこ
json[users]['0']['notifications']=
json[users]['0']['profile_image_url']=http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png
json[users]['0']['id_str']=55984769
json[users]['0']['is_translator']=
json[users]['0']['default_profile']=
json[users]['0']['utc_offset']=32400
json[users]['0']['profile_text_color']=ff6699
json[users]['0']['url']=http://phpjavascriptroom.com
json[users]['0']['follow_request_sent']=
json[users]['0']['friends_count']=188
json[users]['0']['profile_sidebar_fill_color']=DDEEF6
json[users]['0']['description']=てすあか
json[users]['0']['screen_name']=pjroomer
json[users]['0']['lang']=ja
json[users]['0']['profile_background_tile']=
json[users]['0']['created_at']=Sun Jul 12 01:37:21 +0000 2009
json[users]['0']['status']['in_reply_to_screen_name']=
json[users]['0']['status']['in_reply_to_user_id_str']=
json[users]['0']['status']['contributors']=
json[users]['0']['status']['retweeted']=
json[users]['0']['status']['truncated']=
json[users]['0']['status']['id_str']=73309139866095617
json[users]['0']['status']['text']=あいうえお
json[users]['0']['status']['in_reply_to_status_id']=
json[users]['0']['status']['created_at']=Wed May 25 08:47:15 +0000 2011
json[users]['0']['status']['place']=
json[users]['0']['status']['in_reply_to_user_id']=
json[users]['0']['status']['id']=7.33091398661E+16
json[users]['0']['status']['source']=Tw API test
json[users]['0']['status']['favorited']=
json[users]['0']['status']['in_reply_to_status_id_str']=
json[users]['0']['status']['coordinates']=
json[users]['0']['status']['geo']=
json[users]['0']['status']['retweet_count']=0
json[users]['0']['contributors_enabled']=
json[users]['0']['verified']=
json[users]['0']['show_all_inline_media']=
json[users]['0']['geo_enabled']=1
json[users]['0']['favourites_count']=99
json[users]['0']['profile_link_color']=0084B4
json[users]['0']['id']=55984769
json[users]['0']['listed_count']=5
json[users]['0']['profile_sidebar_border_color']=C0DEED
json[users]['0']['time_zone']=Tokyo
json[users]['0']['statuses_count']=1425
json[users]['0']['following']=
json[users]['0']['profile_use_background_image']=1
json[next_cursor]=0
json[previous_cursor]=0
json[next_cursor_str]=0
json[previous_cursor_str]=0

lists/subscribers/create
指定したリストをフォローする(要認証)

2009/7/18

要認証API制限なし

HTTP POSThttp://api.twitter.com/1/lists/subscribers/create.[xml|json]

認証ユーザーが指定したリストをフォローします。 成功すると、フォローしたリストの情報が返ります。 既にフォローしているリストをフォローしようとしてもエラーにはなりません。

パラメーター説明
list_id必須 フォローするリストIDを指定。
例)http://api.twitter.com/1/lists/subscribers/create.xml?list_id=7948862

取得サンプル(XML/JSON)

create.xml
<?xml version="1.0" encoding="UTF-8"?>
<list>
  <id>43044556</id>
  <name>lifeline</name>
  <full_name>@cocoism/lifeline</full_name>
  <slug>lifeline</slug>
  <description>ライフラインに関する情報を発信しているアカウント。</description>
  <subscriber_count>1</subscriber_count>
  <member_count>6</member_count>
  <uri>/cocoism/lifeline</uri>
  <following>true</following>
  <mode>public</mode>
  <user>
    <id>7948862</id>
    <name>つんつ</name>
    <screen_name>cocoism</screen_name>
    <location>カワタマ or オモサン</location>
    <description>青山でWeb系のお仕事してます。デザイナーズレストランははるか昔に卒業済。芋焼酎と焼鳥が大好きで居心地のいい呑み屋でおやじ談義するのがライフワーク。最近は日本酒をお勉強中。家では大人しく猛犬チワワのママしてます。iPhone4/Xperia所有。</description>
    <profile_image_url>http://a0.twimg.com/profile_images/1202496271/usa_normal.png</profile_image_url>
    <url>http://phpjavascriptroom.com/</url>
    <protected>false</protected>
    <followers_count>612</followers_count>
    <profile_background_color>8350a1</profile_background_color>
    <profile_text_color>ff6699</profile_text_color>
    <profile_link_color>f2afcf</profile_link_color>
    <profile_sidebar_fill_color>8350a1</profile_sidebar_fill_color>
    <profile_sidebar_border_color>8350a1</profile_sidebar_border_color>
    <friends_count>534</friends_count>
    <created_at>Sat Aug 04 05:52:33 +0000 2007</created_at>
    <favourites_count>443</favourites_count>
    <utc_offset>32400</utc_offset>
    <time_zone>Tokyo</time_zone>
    <profile_background_image_url>http://a1.twimg.com/profile_background_images/187449144/02.png</profile_background_image_url>
    <profile_background_tile>true</profile_background_tile>
    <profile_use_background_image>true</profile_use_background_image>
    <notifications>false</notifications>
    <geo_enabled>true</geo_enabled>
    <verified>false</verified>
    <following>false</following>
    <statuses_count>5019</statuses_count>
    <lang>ja</lang>
    <contributors_enabled>false</contributors_enabled>
    <follow_request_sent>false</follow_request_sent>
    <listed_count>52</listed_count>
    <show_all_inline_media>true</show_all_inline_media>
    <default_profile>false</default_profile>
    <default_profile_image>false</default_profile_image>
    <is_translator>false</is_translator>
  </user>
</list>
create.json
json[user]['default_profile']=
json[user]['profile_background_color']=8350a1
json[user]['protected']=
json[user]['default_profile_image']=
json[user]['profile_background_image_url']=http://a1.twimg.com/profile_background_images/187449144/02.png
json[user]['followers_count']=612
json[user]['location']=カワタマ or オモサン
json[user]['name']=つんつ
json[user]['notifications']=
json[user]['profile_image_url']=http://a0.twimg.com/profile_images/1202496271/usa_normal.png
json[user]['id_str']=7948862
json[user]['is_translator']=
json[user]['utc_offset']=32400
json[user]['profile_text_color']=ff6699
json[user]['url']=http://phpjavascriptroom.com/
json[user]['follow_request_sent']=
json[user]['friends_count']=534
json[user]['profile_sidebar_fill_color']=8350a1
json[user]['description']=青山でWeb系のお仕事してます。デザイナーズレストランははるか昔に卒業済。芋焼酎と焼鳥が大好きで居心地のいい呑み屋でおやじ談義するのがライフワーク。最近は日本酒をお勉強中。家では大人しく猛犬チワワのママしてます。iPhone4/Xperia所有。
json[user]['screen_name']=cocoism
json[user]['lang']=ja
json[user]['profile_background_tile']=1
json[user]['created_at']=Sat Aug 04 05:52:33 +0000 2007
json[user]['contributors_enabled']=
json[user]['verified']=
json[user]['show_all_inline_media']=1
json[user]['geo_enabled']=1
json[user]['favourites_count']=443
json[user]['profile_link_color']=f2afcf
json[user]['id']=7948862
json[user]['listed_count']=52
json[user]['profile_sidebar_border_color']=8350a1
json[user]['time_zone']=Tokyo
json[user]['statuses_count']=5019
json[user]['following']=
json[user]['profile_use_background_image']=1
json[name]=lifeline
json[id_str]=43044556
json[uri]=/cocoism/lifeline
json[mode]=public
json[description]=ライフラインに関する情報を発信しているアカウント。
json[slug]=lifeline
json[member_count]=6
json[id]=43044556
json[subscriber_count]=1
json[full_name]=@cocoism/lifeline
json[following]=1

lists/subscribers/destroy
指定したリストのフォローを解除する(要認証)

2009/7/18

要認証API制限なし

HTTP POSThttp://api.twitter.com/1/lists/subscribers/destroy.[xml|json]

認証ユーザーが、自分がフォローしているリストのフォローを解除します。

パラメーター説明
list_id必須 フォローを解除するリストIDを指定。
例)http://api.twitter.com/1/lists/subscribers/destroy.xml?list_id=7948862

取得サンプル(XML/JSON)

destroy.xml
▼フォロー解除に成功した場合
<?xml version="1.0" encoding="UTF-8"?>
<list>
  <id>43044556</id>
  <name>lifeline</name>
  <full_name>@cocoism/lifeline</full_name>
  <slug>lifeline</slug>
  <description>ライフラインに関する情報を発信しているアカウント。</description>
  <subscriber_count>0</subscriber_count>
  <member_count>6</member_count>
  <uri>/cocoism/lifeline</uri>
  <following>false</following>
  <mode>public</mode>
  <user>
    <id>7948862</id>
    <name>つんつ</name>
    <screen_name>cocoism</screen_name>
    <location>カワタマ or オモサン</location>
    <description>青山でWeb系のお仕事してます。デザイナーズレストランははるか昔に卒業済。芋焼酎と焼鳥が大好きで居心地のいい呑み屋でおやじ談義するのがライフワーク。最近は日本酒をお勉強中。家では大人しく猛犬チワワのママしてます。iPhone4/Xperia所有。</description>
    <profile_image_url>http://a0.twimg.com/profile_images/1202496271/usa_normal.png</profile_image_url>
    <url>http://phpjavascriptroom.com/</url>
    <protected>false</protected>
    <followers_count>612</followers_count>
    <profile_background_color>8350a1</profile_background_color>
    <profile_text_color>ff6699</profile_text_color>
    <profile_link_color>f2afcf</profile_link_color>
    <profile_sidebar_fill_color>8350a1</profile_sidebar_fill_color>
    <profile_sidebar_border_color>8350a1</profile_sidebar_border_color>
    <friends_count>534</friends_count>
    <created_at>Sat Aug 04 05:52:33 +0000 2007</created_at>
    <favourites_count>443</favourites_count>
    <utc_offset>32400</utc_offset>
    <time_zone>Tokyo</time_zone>
    <profile_background_image_url>http://a1.twimg.com/profile_background_images/187449144/02.png</profile_background_image_url>
    <profile_background_tile>true</profile_background_tile>
    <profile_use_background_image>true</profile_use_background_image>
    <notifications>false</notifications>
    <geo_enabled>true</geo_enabled>
    <verified>false</verified>
    <following>false</following>
    <statuses_count>5019</statuses_count>
    <lang>ja</lang>
    <contributors_enabled>false</contributors_enabled>
    <follow_request_sent>false</follow_request_sent>
    <listed_count>52</listed_count>
    <show_all_inline_media>true</show_all_inline_media>
    <default_profile>false</default_profile>
    <default_profile_image>false</default_profile_image>
    <is_translator>false</is_translator>
  </user>
</list>

▼フォロー解除に失敗した場合
<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <error>You are not subscribed to this list</error>
  <request>/1/lists/subscribers/destroy.xml</request>
</hash>
destroy.json
▼フォロー解除に成功した場合
json[user]['default_profile']=
json[user]['profile_background_color']=8350a1
json[user]['protected']=
json[user]['default_profile_image']=
json[user]['profile_background_image_url']=http://a1.twimg.com/profile_background_images/187449144/02.png
json[user]['followers_count']=612
json[user]['location']=カワタマ or オモサン
json[user]['name']=つんつ
json[user]['notifications']=
json[user]['profile_image_url']=http://a0.twimg.com/profile_images/1202496271/usa_normal.png
json[user]['id_str']=7948862
json[user]['is_translator']=
json[user]['utc_offset']=32400
json[user]['profile_text_color']=ff6699
json[user]['url']=http://phpjavascriptroom.com/
json[user]['follow_request_sent']=
json[user]['friends_count']=534
json[user]['profile_sidebar_fill_color']=8350a1
json[user]['description']=青山でWeb系のお仕事してます。デザイナーズレストランははるか昔に卒業済。芋焼酎と焼鳥が大好きで居心地のいい呑み屋でおやじ談義するのがライフワーク。最近は日本酒をお勉強中。家では大人しく猛犬チワワのママしてます。iPhone4/Xperia所有。
json[user]['screen_name']=cocoism
json[user]['lang']=ja
json[user]['profile_background_tile']=1
json[user]['created_at']=Sat Aug 04 05:52:33 +0000 2007
json[user]['contributors_enabled']=
json[user]['verified']=
json[user]['show_all_inline_media']=1
json[user]['geo_enabled']=1
json[user]['favourites_count']=443
json[user]['profile_link_color']=f2afcf
json[user]['id']=7948862
json[user]['listed_count']=52
json[user]['profile_sidebar_border_color']=8350a1
json[user]['time_zone']=Tokyo
json[user]['statuses_count']=5019
json[user]['following']=
json[user]['profile_use_background_image']=1
json[name]=lifeline
json[id_str]=43044556
json[uri]=/cocoism/lifeline
json[mode]=public
json[description]=ライフラインに関する情報を発信しているアカウント。
json[slug]=lifeline
json[member_count]=6
json[id]=43044556
json[subscriber_count]=0
json[full_name]=@cocoism/lifeline
json[following]=

▼フォロー解除に失敗した場合
json[error]=You are not subscribed to this list
json[request]=/1/lists/subscribers/destroy.json

lists/subscribers/show
指定したユーザーが特定のリストをフォローしているかを調べる(要認証)

2009/7/18

要認証API制限対象

HTTP GEThttp://api.twitter.com/1/lists/subscribers/show.[xml|json]

指定したユーザーが指定したリストをフォローしているかを調べます。

パラメーター説明
list_id必須 リストIDを指定。
例)http://api.twitter.com/1/lists/subscribers/show.xml?list_id=7948862
slug必須 リストIDの代わりにslugでリストを識別することができます。 この場合は、リストの所有者を特定するために、owner_idまたはowner_screen_nameパラメータも併用します。
例)http://api.twitter.com/1/lists/subscribers/show.xml?slug=lifeline&owner_screen_name=cocoism
例)http://api.twitter.com/1/lists/subscribers/show.xml?slug=lifeline&owner_id=7948862
user_id必須 指定したリストをフォローしているか調べるユーザーのユーザーIDを指定。
例)http://api.twitter.com/1/lists/subscribers/show.xml?list_id=25131742&user_id=7948862
screen_name必須 指定したリストをフォローしているか調べるユーザーのスクリーンネームを指定。
例)http://api.twitter.com/1/lists/subscribers/show.xml?list_id=25131742&screen_name=cocoism

取得サンプル(XML/JSON)

show.xml
▼参加している場合
<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id>55984769</id>
  <name>つんこ</name>
  <screen_name>pjroomer</screen_name>
  <location>Tokyo, Japan</location>
  <description>てすあか</description>
  <profile_image_url>http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png</profile_image_url>
  <url>http://phpjavascriptroom.com</url>
  <protected>false</protected>
  <followers_count>8</followers_count>
  <profile_background_color>C0DEED</profile_background_color>
  <profile_text_color>ff6699</profile_text_color>
  <profile_link_color>0084B4</profile_link_color>
  <profile_sidebar_fill_color>DDEEF6</profile_sidebar_fill_color>
  <profile_sidebar_border_color>C0DEED</profile_sidebar_border_color>
  <friends_count>188</friends_count>
  <created_at>Sun Jul 12 01:37:21 +0000 2009</created_at>
  <favourites_count>99</favourites_count>
  <utc_offset>32400</utc_offset>
  <time_zone>Tokyo</time_zone>
  <profile_background_image_url>http://a0.twimg.com/images/themes/theme1/bg.png</profile_background_image_url>
  <profile_background_tile>false</profile_background_tile>
  <profile_use_background_image>true</profile_use_background_image>
  <notifications>false</notifications>
  <geo_enabled>true</geo_enabled>
  <verified>false</verified>
  <following>false</following>
  <statuses_count>1425</statuses_count>
  <lang>ja</lang>
  <contributors_enabled>false</contributors_enabled>
  <follow_request_sent>false</follow_request_sent>
  <listed_count>5</listed_count>
  <show_all_inline_media>false</show_all_inline_media>
  <default_profile>false</default_profile>
  <default_profile_image>true</default_profile_image>
  <is_translator>false</is_translator>
  <status>
    <created_at>Wed May 25 08:47:15 +0000 2011</created_at>
    <id>73309139866095617</id>
    <text>あいうえお</text>
    <source><a href="http://twitterapi01.appspot.com" rel="nofollow">Tw API test</a></source>
    <truncated>false</truncated>
    <favorited>false</favorited>
    <in_reply_to_status_id></in_reply_to_status_id>
    <in_reply_to_user_id></in_reply_to_user_id>
    <in_reply_to_screen_name></in_reply_to_screen_name>
    <retweet_count>0</retweet_count>
    <retweeted>false</retweeted>
    <geo/>
    <coordinates/>
    <place/>
    <contributors/>
  </status>
</user>

▼参加していない場合
<?xml version="1.0" encoding="UTF-8"?>
<hash>
  <error>The specified user is not a subscriber of this list</error>
  <request>/1/lists/subscribers/show.xml?format=xml&list_id=43044556&oauth_consumer_key=…略…</request>
</hash>
show.json
▼参加している場合
json[profile_background_color]=C0DEED
json[protected]=
json[is_translator]=
json[default_profile_image]=1
json[profile_background_image_url]=http://a0.twimg.com/images/themes/theme1/bg.png
json[followers_count]=8
json[location]=Tokyo, Japan
json[name]=つんこ
json[notifications]=
json[profile_image_url]=http://a0.twimg.com/sticky/default_profile_images/default_profile_1_normal.png
json[id_str]=55984769
json[contributors_enabled]=
json[utc_offset]=32400
json[profile_text_color]=ff6699
json[url]=http://phpjavascriptroom.com
json[follow_request_sent]=
json[friends_count]=188
json[profile_sidebar_fill_color]=DDEEF6
json[description]=てすあか
json[screen_name]=pjroomer
json[lang]=ja
json[profile_background_tile]=
json[created_at]=Sun Jul 12 01:37:21 +0000 2009

json[status]['in_reply_to_screen_name']=
json[status]['in_reply_to_user_id_str']=
json[status]['contributors']=
json[status]['retweeted']=
json[status]['truncated']=
json[status]['id_str']=73309139866095617
json[status]['text']=あいうえお
json[status]['in_reply_to_status_id']=
json[status]['created_at']=Wed May 25 08:47:15 +0000 2011
json[status]['place']=
json[status]['in_reply_to_user_id']=
json[status]['id']=7.33091398661E+16
json[status]['source']=Tw API test
json[status]['favorited']=
json[status]['in_reply_to_status_id_str']=
json[status]['coordinates']=
json[status]['geo']=
json[status]['retweet_count']=0
json[default_profile]=
json[show_all_inline_media]=
json[verified]=
json[geo_enabled]=1
json[favourites_count]=99
json[profile_link_color]=0084B4
json[id]=55984769
json[listed_count]=5
json[profile_sidebar_border_color]=C0DEED
json[statuses_count]=1425
json[time_zone]=Tokyo
json[following]=
json[profile_use_background_image]=1

▼参加していない場合
json[error]=The specified user is not a subscriber of this list
json[request]=/1/lists/subscribers/show.json?format=json&list_id=43044556&oauth_consumer_key=…略…

関連コンテンツ

Q. このサイトの情報はお役に立ちましたでしょうか?

投票する 投票結果を見る

管理人に【web拍手】を送るweb拍手(1行メッセージも送れます♪)

pagetop

polarized women