Twitter関連Twitter REST API:リスト参加者関連
- lists/subscribers〔特定のリストの参加者を取得(認証不要)〕
- lists/subscribers/create〔指定したリストをフォローする(要認証)〕
- lists/subscribers/destroy〔指定したリストのフォローを解除する(要認証)〕
- lists/subscribers/show〔指定したユーザーが特定のリストをフォローしているかを調べる(要認証)〕
lists/subscribers
特定のリストの参加者を取得(認証不要)
2009/7/18
http://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
http://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
http://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
http://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=…略…