TDnet(適時開示情報)のWEB-APIプロジェクト
Last Update: 2010/11/08
提供しているWEB-API
★(XML形式の例)★ http://webapi.yanoshin.jp/webapi/tdnet/list/20091105.xml
書式説明
リクエストURLのフォーマット:http://webapi.yanoshin.jp/webapi/tdnet/list/(条件).(形式)[?パラメータ名=値&…](条件)で指定可能なもの
- recent …最新順の適時開示情報
- today …本日の適時開示情報
- yesterday …昨日の適時開示情報
- xxxx …数字4桁=証券コードで絞り込んだ適時開示情報
- xxxx-yyyy-zzzz〜 …複数銘柄をひとつにまとめて適時開示情報(-(ハイフン)で証券コードをつなげてください)
- YYYYmmdd …年月日の数字8桁=指定日付で絞り込んだ適時開示情報
- 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
- 2009年11月2日の適時開示情報をxmlで→ http://webapi.yanoshin.jp/webapi/tdnet/list/20091102.xml
- 2009年11月2日から5日までの適時開示情報を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形式で最大100件取得→ 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形式で最大100件取得→ 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
- 2010年11月08日:APIアクセスの日次推移グラフを追加。マッシュアップアワード6に参加。 New!
- 2010年03月18日:オプションパラメータにXBRL形式指定(hasXBRL)を追加
- 2010年02月21日:オプションパラメータ仕様を追加、最大件数取得(limit)を追加
- 2010年02月21日:RSS形式時にtitle文字列で文字化けが発生していた不具合を修正(mb_substr処理によるマルチバイト対応)
- 2010年01月30日:本WEB APIを利用したiPhoneアプリ「i適時開示」がリリースされました。(参考ブログ:企業法務について)
- 2009年11月09日:フォーマット条件に複数銘柄指定、日付範囲の指定を追加。サンプルURL追加
- 2009年11月05日:一般公開しました。第7回XBRL勉強会でデモ発表しました。
