Twitter API の 機能一覧
≪Twitter API の 機能一覧≫※http://watcher.moe-nifty.com/memo/docs/twitterAPI49.txt より
タイムライン関連のAPI
public_timeline
公開(かつ、自分のアイコンを設定済みの)ユーザの最新のステータス(発言)を取得する (最大20件)
http://twitter.com/statuses/public_timeline.format
home_timeline
自分と自分の friend の過去24時間以内に update されたステータス(retweetを含む)から最大20件(count引数使用時は最大200件)を取得する。
http://twitter.com/statuses/home_timeline.format
friends_timeline
自分の friend の過去24時間以内に update されたステータスから最大20件(count引数使用時は最大200件)を取得する。
http://twitter.com/statuses/friends_timeline.format
http://twitter.com/statuses/friends_timeline/id.format
user_timeline
自分の過去24時間以内に update されたステータスから最大20件(count引数使用時は最大200件)を取得する。
http://twitter.com/statuses/user_timeline.format
http://twitter.com/statuses/user_timeline/id.format
replies
自分に対する返信(冒頭が @ユーザ名 で始まるステータス)の一覧を取得する (最大20件)
http://twitter.com/statuses/replies.format
mentions
自分に対する言及(@ユーザ名 が含まれるステータス)の一覧を取得する (最大20件)
http://twitter.com/statuses/mentions.format
retweeted_by_me
自分が投稿した retweet の一覧を取得する (最大20件)
http://twitter.com/statuses/retweeted_by_me.format
retweeted_to_me
自分の friends が投稿した retweet の一覧を取得する (最大20件)
http://twitter.com/statuses/retweeted_to_me.format
retweetes_of_me
自分が投稿した発言のうち(自分以外の)誰かによって retweet されたものの一覧を取得する (最大20件)
http://twitter.com/statuses/retweets_of_me.format
ステータス関連のAPI
show
指定した ID のステータス(1件)を取得する
http://twitter.com/statuses/show/id.format
update
自分のステータスを更新(update)する。引数 status は必須。
http://twitter.com/statuses/update.format
destroy
ステータスを削除する。ステータスIDの指定は必須。
http://twitter.com/statuses/destroy/id.format
retweet
指定したステータスを retweet する。ステータスIDの指定は必須。
http://twitter.com/statuses/retweet/id.format
retweets
指定したステータスを retweet しているユーザの一覧のうち最初の100人分を取得する
http://twitter.com/statuses/retweets/id.format
ユーザ情報関連のAPI
friends
自分の friend の一覧を(各 friend の最新ステータス付きで)取得する
http://twitter.com/statuses/friends.format
followers
自分の follower の一覧を(各 follower の最新ステータス付きで)取得する
http://twitter.com/statuses/followers.format
show
指定ユーザに関する詳細な情報を取得する。
http://twitter.com/users/show/id.format
search
指定条件に一致する Twitter ユーザを検索する。
http://api.twitter.com/1/users/search.format
ダイレクトメッセージ関連のAPI
direct_messages
自分宛てのダイレクトメッセージの一覧を取得する (最大20件)
http://twitter.com/direct_messages.format
sent
自分が送信したダイレクトメッセージの一覧を取得する (最大20件)
http://twitter.com/direct_messages/sent.format
new
ダイレクトメッセージを送信する。宛先と本文の指定は必須。
http://twitter.com/direct_messages/new.format
destroy
ダイレクトメッセージを削除する。メッセージIDの指定は必須。
http://twitter.com/direct_messages/destroy/id.format
フレンド関連のAPI
create
指定ユーザを自分の friend (following) にする
http://twitter.com/friendships/create/id.format
destroy
指定ユーザを自分の friend (following) から外す
http://twitter.com/friendships/destroy/id.format
exists
指定した2ユーザの間の friend 関係を調べる
http://twitter.com/friendships/exists.format
show
指定した2ユーザの間の関係を詳細に調べる
http://twitter.com/friendships/show.format
ソーシャルグラフ関連のAPI
friends/ids
自分の、あるいは指定したユーザが follow しているユーザ(friends)のID一覧(配列)を取得する
http://twitter.com/friends/ids.format
followers/ids
自分を、あるいは指定したユーザを follow しているユーザ(followers)のID一覧(配列)を取得する
http://twitter.com/followers/ids.format
アカウント関連のAPI
verify_credentials
(BASIC認証による)セッションを開始する。認証に成功すると HTTP 200 OK の応答とともに当該ユーザに関する情報(と cookie)が返る。
http://twitter.com/account/verify_credentials.format
end_session
verify_credentials で開始したセッションを終了する(本API実行後、空の cookie が返る)
http://twitter.com/account/end_session.format
update_location
自分の profile の location 欄に表示する情報を更新する
http://twitter.com/account/update_location.format
update_delivery_device
自分の device を設定する
http://twitter.com/account/update_delivery_device.format
update_profile_colors
Twitter 上の自分の profile ページの色を設定する
http://twitter.com/account/update_profile_colors.format
update_profile_image
自分の profile ページの画像(ユーザアイコンとしても使用される)を設定する
http://twitter.com/account/update_profile_image.format
update_profile_background_image
自分の profile ページの背景画像を設定する
http://twitter.com/account/update_profile_background_image.format
rate_limit_status
自分の「API 制限状況」(この1時間以内にあと何回APIを実行できるか)を取得する。本APIの実行自体はAPI制限の対象外である(何回でも実行できる)
http://twitter.com/account/rate_limit_status.format
update_profile
自分の profile (アカウント情報) を変更する
http://twitter.com/account/update_profile.format
お気に入り関連のAPI
favorites
自分または指定したユーザの favorites(お気に入り) に登録されている「発言」のうち、最新のものから最大20件取得する
http://twitter.com/favorites.format
create
指定ステータスを自分の「お気に入り」に登録する。
http://twitter.com/favorites/create/id.format
destroy
指定ステータスを自分の「お気に入り」から外す。
http://twitter.com/favorites/destroy/id.format
「指定デバイス」関連のAPI
follow
指定ユーザ(following)の発言を「指定デバイス」に送信するようにする
http://twitter.com/notifications/follow/id.format
leave
指定ユーザ(following)の発言を「指定デバイス」に送信するのをやめる
http://twitter.com/notifications/leave/id.format
ブロック関連のAPI
create
指定ユーザをブロックする。指定ユーザが friend だった場合、friend から外した上でブロックする
http://twitter.com/blocks/create/id.format
destroy
指定ユーザのブロックを解除する
http://twitter.com/blocks/destroy/id.format
exists
指定したユーザをブロックしているかどうかを調べる。
http://twitter.com/blocks/exists/id.format
blocking
自分がブロックしているユーザの一覧を取得する
http://twitter.com/blocks/blocking.format
blocking/ids
自分がブロックしているユーザのID一覧(配列)を取得する
http://twitter.com/blocks/blocking/ids.format
補助API
test
成功すれば(Twitter が正常に稼動していれば)、"ok" という文字列を http ステータスコード 200 OK で返す
http://twitter.com/help/test.format
spam 報告関連のAPI
report_spam
指定ユーザをスパマーであると報告し、ブロックする
http://twitter.com/report_spam.format
list 関連のAPI
POST lists
list を作成する
http://api.twitter.com/1/user/lists.format
POST list id
指定 list を更新する
http://api.twitter.com/1/user/lists/id.format
GET lists
指定ユーザの list の一覧を取得する。自分自身の list の一覧を取得する場合は、非公開の list も一覧に含まれる
http://api.twitter.com/1/user/lists.format
GET list id
指定ユーザの指定 list に関する情報を取得する。自分自身の list を取得する場合は、非公開の list であっても情報を取得可能である
http://api.twitter.com/1/user/lists/id.format
DELETE list id
指定 list を削除する
http://api.twitter.com/1/user/lists/id.format
GET list statuses
指定した list に登録されているメンバーのみで構成されるタイムラインを取得する
http://api.twitter.com/1/user/lists/list_id/statuses.format
GET list memberships
指定したユーザが登録されている list の一覧を取得する
http://api.twitter.com/1/user/lists/memberships.format
GET list subscriptions
指定したユーザが購読している list の一覧を取得する
http://api.twitter.com/1/user/lists/subscriptions.format
list の登録内容に関する API
GET list members
指定した list に登録されているメンバーの一覧を取得する
http://api.twitter.com/1/user/list_id/members.format
POST list members
指定した list にメンバーを追加する。1つの list に最大500人まで登録できる
http://api.twitter.com/1/user/list_id/members.format
DELETE list members
指定した list からメンバーを削除する
http://api.twitter.com/1/user/list_id/members.format
GET list members id
指定したユーザが、指定した list のメンバーであるかどうかを確認する。
http://api.twitter.com/1/user/list_id/members/id.format
list の購読に関する API
GET list subscribers
指定した list を購読している人の一覧を取得する
http://api.twitter.com/1/user/list_id/subscribers.format
POST list subscribers
指定した list を購読する
http://api.twitter.com/1/user/list_id/subscribers.format
DELETE list subscribers
指定した list の購読を解除する
http://api.twitter.com/1/user/list_id/subscribers.format
GET list subscribers id
指定したユーザが、指定した list の購読者であるかどうかを確認する。
http://api.twitter.com/1/user/list_id/subscribers/id.format
検索関連のAPI
search
指定した検索条件を満たす「発言」を返す。特に件数を指定しない場合は最大15件分の結果を返す
http://search.twitter.com/search.format
trends
いま、Twitter でホットな話題(最大10件)を取得する
http://search.twitter.com/trends.format
trends/current
いま、Twitter でホットな話題(最大10件)を取得する
http://search.twitter.com/trends/current.format
trends/daily
指定した日のホットな話題(最大20件)を取得する
http://search.twitter.com/trends/daily.format
trends/weekly
指定した日を含む週のホットな話題(最大30件)を取得する
http://search.twitter.com/trends/weekly.format
地域情報検索関連のAPI
trends/available
ホットな話題が存在する地域の情報(配列)を取得する
http://api.twitter.com/1/trends/available.format
trends/location
WOEID で指定した地点の付近のホットな情報を取得する (最大10件)
http://api.twitter.com/1/trends/woeid.format
位置情報関連のAPI
geo/reverse_geocode
緯度、経度で指定した場所の geocode を取得する
http://api.twitter.com/1/geo/reverse_geocode.json
geo/id
geo/reverse_geocode で取得した geocode の場所に関する詳細な情報を取得する
http://api.twitter.com/1/geo/id/ID.json
検索条件保存
saved_searches
「(自分の)保存済みの検索条件」を返す
http://twitter.com/saved_searches.format
saved_searches/show
IDで指定した「(自分の)保存済みの検索条件」を返す
http://twitter.com/saved_searches/show/id.format
saved_searches/create
指定した「検索条件」を保存する
http://twitter.com/saved_searches/create.format
saved_searches/destroy
指定した「保存済み検索条件」を破棄する
http://twitter.com/saved_searches/destroy.format
ストリーミングAPI
firehose
public な情報を全て取得する。 (REST API の statuses/public_timeline の「応答」中の status 要素に相当するものがストリームとして流れてくる)
http://stream.twitter.com/1/statuses/firehose.format
gardenhose
public な情報のうち、データマイニング・各種調査用アプリケーション向けにサンプリング・最適化したものを取得する。
http://stream.twitter.com/gardenhose.format
sample
public な情報のうち、ある一定割合のものを取得する (gardenhose の精度の悪いバージョン。要するに、全てのデータが得られる保証はない。データ抜けがある可能性がある)
http://stream.twitter.com/1/statuses/sample.format
birddog
ID で指定したユーザの public な情報を取得する (private 設定しているユーザの情報は取得できない)
http://stream.twitter.com/birddog.format
shadow
ID で指定したユーザの public な情報を取得する (private 設定しているユーザの情報は取得できない) [birddog の規模縮小版]
http://stream.twitter.com/shadow.format
filter
1件以上のフィルターを設定し、絞り込んだ情報(public な情報に限定)を取得する (birddog, shadow の精度の悪い版)
http://stream.twitter.com/1/statuses/filter.format
links
http: または https: を含むステータスをすべて取得する
http://stream.twitter.com/1/statuses/links.format
retweet
retweet されているステータスをすべて取得する
http://stream.twitter.com/1/statuses/retweet.format
0 コメント:
コメントを投稿