TDnet（適時開示情報）のWEB-APIプロジェクト
Last Update: 2010/11/08
tweetする |
|
提供しているWEB-API
★（XML形式の例)★ http://webapi.yanoshin.jp/webapi/tdnet/list/20091105.xml
書式説明
リクエストURLのフォーマット：http://webapi.yanoshin.jp/webapi/tdnet/list/（条件）.（形式）[?パラメータ名=値&…]（条件）で指定可能なもの
- recent …最新順の適時開示情報
- today …本日の適時開示情報
- yesterday …昨日の適時開示情報
- xxxx …数字４桁=証券コードで絞り込んだ適時開示情報
- xxxx-yyyy-zzzz〜 …複数銘柄をひとつにまとめて適時開示情報（-（ハイフン）で証券コードをつなげてください）
- YYYYmmdd …年月日の数字８桁=指定日付で絞り込んだ適時開示情報
- YYYYmmdd-YYYYmmdd …指定日付の範囲で絞り込んだ適時開示情報
（形式）で指定可能なもの
- xml …一番汎用的、ほぼすべてのデータを含んでいます
- rss
- atom
- json …Javascriptで直接読み込めるオブジェクト
- html …確認用
- xml2 …(現在テスト中)xmlフォーマットの変更版。冗長だったitems->[数値]->TDnet->title〜だった部分のTDnet部分を削除仕様について御意見ください！
- json2 …(現在テスト中)jsonフォーマットの変更版。冗長だったitems->[数値]->TDnet->title〜だった部分のTDnet部分を削除仕様について御意見ください！
パラメータで指定可能なもの(オプション)
- limit …取得する最大件数 [指定なしデフォルト=300件]
- hasXBRL … 1=XBRLデータで報告されているものだけに絞り込み [指定なしデフォルト=0…すべての報告書]
- ＊ただしXBRL報告書のみに絞り込んだ場合、表示される報告書URL(document_url）はXBRLファイルへのリンクとなることに注意！
■様々な条件と形式でのサンプル
- 最新順の適時開示情報をRSS形式で→ http://webapi.yanoshin.jp/webapi/tdnet/list/recent.rss
- ２００９年１１月２日の適時開示情報をxmlで→ http://webapi.yanoshin.jp/webapi/tdnet/list/20091102.xml
- ２００９年１１月２日から５日までの適時開示情報をjsonで→ http://webapi.yanoshin.jp/webapi/tdnet/list/20091102-20091105.json
- トヨタ（7203）の適時開示情報をAtomで→ http://webapi.yanoshin.jp/webapi/tdnet/list/7203.atom
- トヨタ（7203）とソフトバンク(9984）とヤフー（4689）の適時開示情報をrssで→ http://webapi.yanoshin.jp/webapi/tdnet/list/7203-9984-4689.atom
- 最新順の適時開示情報をAtom形式で最大１００件取得→ http://webapi.yanoshin.jp/webapi/tdnet/list/recent.atom?limit=100
- 最新順のXBRLで報告された適時開示情報をRSS形式で→ http://webapi.yanoshin.jp/webapi/tdnet/list/recent.rss?hasXBRL=1
- XBRLで報告されたトヨタ（7203）の適時開示情報をAtom形式で最大１００件取得→ http://webapi.yanoshin.jp/webapi/tdnet/list/7203.atom?limit=100&hasXBRL=1
- ＊その他のサンプルパターン募集中です
■その他、活用デモなど
- iPhoneサイト向けに使用した例：http://webapi.yanoshin.jp/tdnet/iphonedemo
- 携帯サイト向けに使用した例：http://webapi.yanoshin.jp/tdnet/mobiledemo
■更新履歴・NEWS
- ２０１０年１１月０８日：APIアクセスの日次推移グラフを追加。マッシュアップアワード６に参加。 New!
- ２０１０年０３月１８日：オプションパラメータにXBRL形式指定(hasXBRL)を追加
- ２０１０年０２月２１日：オプションパラメータ仕様を追加、最大件数取得(limit)を追加
- ２０１０年０２月２１日：RSS形式時にtitle文字列で文字化けが発生していた不具合を修正（mb_substr処理によるマルチバイト対応）
- ２０１０年０１月３０日：本WEB APIを利用したiPhoneアプリ「i適時開示」がリリースされました。（参考ブログ：企業法務について）
- ２００９年１１月０９日：フォーマット条件に複数銘柄指定、日付範囲の指定を追加。サンプルURL追加
- ２００９年１１月０５日：一般公開しました。第７回XBRL勉強会でデモ発表しました。
