Twitter関連Twitter REST API:保存された検索関連
- saved_searches〔認証ユーザーが保存している検索条件を取得(要認証)〕
- saved_searches/show/:id〔指定したIDの検索条件を取得(要認証)〕
- saved_searches/create〔認証ユーザーの検索条件を保存(要認証)〕
- saved_searches/destroy/:id〔認証ユーザーが保存している検索条件を削除(要認証)〕
saved_searches
認証ユーザーが保存している検索条件を取得(要認証)
2009/7/18
http://api.twitter.com/1/saved_searches.[xml|json]
認証ユーザーが保存した検索条件を返します。
取得サンプル(XML/JSON)
saved_searches.xml
<?xml version="1.0" encoding="UTF-8"?> <saved_searches type="array"> <saved_search> <id>4507276</id> <name>jquery</name> <query>jquery</query> <position></position> <created_at>Sun Feb 07 15:04:47 +0000 2010</created_at> </saved_search> <saved_search> <id>4804586</id> <name>#nowplaying</name> <query>#nowplaying</query> <position></position> <created_at>Wed Feb 17 10:55:35 +0000 2010</created_at> </saved_search> <saved_search> <id>37331213</id> <name>phpjavascriptroom</name> <query>phpjavascriptroom</query> <position></position> <created_at>Fri May 27 02:47:14 +0000 2011</created_at> </saved_search> </saved_searches>
saved_searches.json
json[0]['id_str']=4507276 json[0]['name']=jquery json[0]['query']=jquery json[0]['created_at']=Sun Feb 07 15:04:47 +0000 2010 json[0]['id']=4507276 json[0]['position']= json[1]['id_str']=4804586 json[1]['name']=#nowplaying json[1]['query']=#nowplaying json[1]['created_at']=Wed Feb 17 10:55:35 +0000 2010 json[1]['id']=4804586 json[1]['position']= json[2]['id_str']=37331213 json[2]['name']=phpjavascriptroom json[2]['query']=phpjavascriptroom json[2]['created_at']=Fri May 27 02:47:14 +0000 2011 json[2]['id']=37331213 json[2]['position']=
saved_searches/show/:id
指定したIDの検索条件を取得(要認証)
2009/7/18
http://api.twitter.com/1/saved_searches/show/[検索条件ID].[xml|json]
認証ユーザーが保存している検索条件の中から、指定したIDの検索条件の情報を返します。
パラメーター
パラメーター | 説明 | |
---|---|---|
id | 必須 |
取得する検索条件IDを指定。 例)http://api.twitter.com/1/saved_searches/show/12345.xml |
取得サンプル(XML/JSON)
show.xml
<?xml version="1.0" encoding="UTF-8"?> <saved_search> <id>4804586</id> <name>#nowplaying</name> <query>#nowplaying</query> <position></position> <created_at>Wed Feb 17 10:55:35 +0000 2010</created_at> </saved_search>
show.json
json[id_str]=4804586 json[name]=#nowplaying json[query]=#nowplaying json[created_at]=Wed Feb 17 10:55:35 +0000 2010 json[id]=4804586 json[position]=
saved_searches/create
認証ユーザーの検索条件を保存(要認証)
2009/7/18
http://api.twitter.com/1/saved_searches/create.[xml|json]
認証ユーザーの検索条件に、指定した検索条件を保存します。 成功した場合は、保存した検索条件の情報を返します。 既に登録している検索条件を保存しようとするとエラーになります。
パラメーター
パラメーター | 説明 | |
---|---|---|
query | 必須 |
任意の検索条件(文字列)を指定。 例)http://api.twitter.com/version/saved_searches/create.xml?query=twieer |
取得サンプル(XML/JSON)
create.xml
▼成功時 <?xml version="1.0" encoding="UTF-8"?> <saved_search> <id>37331745</id> <name>#itunes</name> <query>#itunes</query> <position></position> <created_at>Fri May 27 02:53:15 +0000 2011</created_at> </saved_search> ▼失敗時 <?xml version="1.0" encoding="UTF-8"?> <hash> <error>There was an error creating your search.</error> <request>/1/saved_searches/create.xml</request> </hash>
create.json
▼成功時 json[id_str]=37332061 json[name]=#itunes json[query]=#itunes json[created_at]=Fri May 27 02:56:51 +0000 2011 json[id]=37332061 json[position]= ▼失敗時 json[error]=There was an error creating your search. json[request]=/1/saved_searches/create.json
saved_searches/destroy/:id
認証ユーザーが保存している検索条件を削除(要認証)
2009/7/18
http://api.twitter.com/version/saved_searches/destroy/[検索条件ID].[xml|json]
認証ユーザーが保存している検索条件の中から指定したIDの検索条件を削除します。
パラメーター
パラメーター | 説明 | |
---|---|---|
id | 必須 |
削除する検索条件IDを指定。 例)http://api.twitter.com/1/saved_searches/destroy/12345.xml |
取得サンプル(XML/JSON)
destroy.xml
▼成功時 <?xml version="1.0" encoding="UTF-8"?> <saved_search> <id>4804586</id> <name>#nowplaying</name> <query>#nowplaying</query> <position></position> <created_at>Wed Feb 17 10:55:35 +0000 2010</created_at> </saved_search> ▼失敗時 <?xml version="1.0" encoding="UTF-8"?> <hash> <error>Not found</error> <request>/1/saved_searches/destroy/4804586.xml</request> </hash>
destroy.json
▼成功時 json[id_str]=4804586 json[name]=#itunes json[query]=#itunes json[created_at]=Fri May 27 02:59:52 +0000 2011 json[id]=4804586 json[position]= ▼失敗時 json[error]=Not found json[request]=/1/saved_searches/destroy/4804586.json