ニュース
トピックス
Version 1 ｜ Version 2
リクエストURL
XML
http://news.yahooapis.jp/NewsWebService/V1/Topics
トピックスAPIでは、Yahoo!ニュースのトピックスに関わるデータを提供しています。
例えば、現在Yahoo! JAPANトップページに表示されているトピックスや国内、経済といった各ジャンルのトピックスの見出し一覧を取得したり、それぞれのトピックスの現在のPV指標、関連するワードなどウェブ上では提供されていないデータ類も取得することができます。
※2008年7月31日以降、relatedtopicsおよびrelatedsiteのデータはご利用いただけません。ご了承ください。
リクエストパラメータ
「RESTリクエストの構築（GET）」をご参照ください。
| パラメータ | 値 | 説明 |
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| topicname | string | トピック名の絞り込み指定です。英語表記でURLの末尾部分と対応しています。 例 weather : 「天気概況」トピック（http://dailynews.yahoo.co.jp/fc/domestic/weather/) |
| category | string | 特定カテゴリの絞り込み指定です。 指定がない場合はすべてのトピックが対象となります。 domestic : 国内 world : 海外 economy : 経済 entertainment : エンターテインメント sports：スポーツ computer：コンピュータ science：サイエンス local：地域 |
| word | string | （URLエンコードされた）ワードを指定します。見出し、トピック名、サブジャンル名、キーワードの文字列で部分一致したトピックのデータが返されます。 |
| topflg | integer: 値なし（デフォルト）, 1 | Yahoo! JAPANトップページへの掲載による絞り込み指定です。 指定のない場合はすべてのトピックが対象となります。 1 : 絞り込む（掲載されている） |
| midashiflg | integer: 値なし（デフォルト）, 1 | 見だしの有無による絞り込み指定です。 指定のない場合はすべてのトピックが対象となります。 1 : 絞り込む（見出しがあるトピックだけ） |
| relatedtopics | integer: 0（デフォルト）, 1 | 関連トピックの表示を制御するオプションです。 0 : 関連トピックを表示しない 1 : 関連トピックを表示する |
| relatedsite | integer: 0（デフォルト）, 1 | 関連外部サイトの表示を制御するオプションです。 0 : 関連外部サイトを表示しない 1 : 関連外部サイトを表示する |
| sort | pvindex（デフォルト）, topicname, datetime | ソート項目の指定です。指定できる値はPV指標、トピック名、日付のいずれかとなります。PV指標は現在のアクセス数から割り出した指標的な数値で大きいほど注目度が高いトピックであるといえます。 pvindex : PV指標順 topicname : トピック名 datetime : 日付 |
| order | d（デフォルト）, a | ソート項目の順序の指定です。 d : 降順 a : 昇順 |
| num | integer: 1（最小）, 30（デフォルト）（最大） | 表示件数の指定です。 |
サンプルリクエストURL
http://news.yahooapis.jp/NewsWebService/V1/Topics?レスポンスフィールド
トピックスWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://news.yahooapis.jp/NewsWebService/V1/Topics.xsd
| フィールド | 説明 |
| ResultSet | クエリーレスポンスのすべてを含みます。 |
| Result | 各個別レスポンスを含みます。 |
| datetime | 最後にトピックを更新した日時です。 |
| title | Yahoo! JAPANトップページに表示されているような15文字程度の見出し（テキスト）です。 |
| keyword | トピックに関連するキーワードです。最大5件まで表示します。 |
| topicname | 常設トピック名で、見出しは更新されますが、トピック名は基本的に固定の名称となります。 |
| category | カテゴリ（国内、海外、経済、エンターテインメント、スポーツ、コンピュータ、サイエンス、地域のいずれか） |
| subcategory | サブカテゴリ（社会、政治などカテゴリの下の分類指標） |
| url | トピックページのURLです。 |
| topflg | Yahoo! JAPANトップページへの掲載有無をあらわします。 0 : 無 1 : 有 |
| pvindex | PV指標は現在のアクセス数から割り出した指標的な数値です。 |
| relatedtopics | トピックに関連するトピックの以下のデータを表示します。 表示件数は最大5件です。 relatedtopicsname（関連トピック名） relatedtopicsurl（関連トピックURL） ※2008年7月31日以降、このフィールドのデータは、ご利用いただけません。ご了承ください。 |
| relatedsite | トピックに関連するサイトの以下のデータを表示します。 表示件数は最大5件です。 relatedsitename（関連サイト名） relatedsiteurl（関連サイトURL） ※2008年7月31日以降、このフィールドのデータは、ご利用いただけません。ご了承ください。 |
サンプルレスポンス
以下は、サンプル のクエリーの結果です。
エラー
トピックスWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
Yahoo!ニュースWeb APIは、24時間中1アプリケーションIDにつき5000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。