ニュース
トピックス
Version 1 ｜ Version 2
リクエストURL
XML
http://news.yahooapis.jp/NewsWebService/V2/topics
トピックスAPIでは、Yahoo!ニュースのトピックスに関わる最新のデータを提供しています。
例えば、いまこの瞬間にYahoo! JAPANトップページに表示されているトピックスや国内、経済といった各カテゴリのトピックスの見出し一覧や関連情報を取得したり、それぞれのトピックスの現在のPV指標（アクセス数から割り出した指標的な数値）、関連するワードなどウェブ上では提供されていないデータ類も取得することができます。
※2009年6月から関連情報も追加し、レスポンスを全件取得できるようになりました。
リクエストパラメータ
「RESTリクエストの構築（GET）」をご参照ください。
| パラメータ | 値 | 説明 |
| appid（必須） | string | アプリケーションID。詳細はこちらをご覧ください。 |
| topicname（いずれか必須） | string | トピック（国内や経済などのカテゴリよりも細かい分類基準）名の絞り込み指定です。英字表記で、URLの末尾部分と対応しています。
例 weather ：「天気概況」トピック（http://dailynews.yahoo.co.jp/fc/domestic/weather/) |
| category（いずれか必須） | string | カテゴリ（国内や経済など大まかな分類基準）の絞り込み指定です。 英字表記で、次のようなものがあります。指定がない場合はすべてのカテゴリが対象となります。 |
| pickupcategory（いずれか必須） | string |
掲載されたカテゴリを指定します（上のcategoryにおけるカテゴリと一致しない場合があります）。 英字表記で、次のようなものがあります。指定がない場合はすべてのカテゴリが対象となります。
|
| query（いずれか必須） | string | UTF-8でURLエンコードされたワードで該当するトピックを検索します。 見出し、トピック名、トピック概要、キーワード、サブジャンルが検索対象で、部分一致したトピックのデータが返されます。 |
| relatedinformation（いずれか必須） | integer | 各トピックの関連情報を取得するかどうかを指定します。指定がない場合は取得しません。
|
| sort | string | レスポンスの表示順を指定します。次のようなものがあります。指定がない場合は最終更新時間が新しいものから順に表示します。
|
| results | integer | 表示件数の指定です。 最大値は10件で、指定がない場合は10件を返します。 |
| start | integer |
結果の先頭位置を指定します。 11件以上の該当データがある場合などに指定してください。 指定がない場合は1件目（最初）からになります。 |
サンプルリクエストURL
http://news.yahooapis.jp/NewsWebService/V2/topics?レスポンスフィールド
トピックスWeb APIのスキーマの記述は、以下のURLをご覧ください。
http://news.yahooapis.jp/NewsWebService/V2/topics.xsd
| フィールド | 説明 |
|---|---|
| ResultSet | クエリーレスポンスのすべてを含みます。
|
| Result | 個別レスポンスを含みます。 |
| HeadlineId | トピックの見出し（Title）に対応するIDです。 |
| DateTime | 最終更新日時（ニュース、ヘッドライン、関連情報のいずれかで一番最新の更新があった日時）です。 |
| CreateTime | トピック（国内や経済などのカテゴリよりも細かい分類基準）が作成された日時です。 |
| NewsUpdateTime | トピックのニュースの最終更新日時です。 |
| RelatedInfoUpdateTime | トピックの関連情報の最終更新日時です。 |
| HeadlineUpdateTime | トピックの見出し（Yahoo! JAPANトップページに表示されているような15文字程度のテキスト）に対応して更新されるヘッドラインの最終更新日時です。 |
| Title | トピックの見出しです。ない場合は表示されません。 |
| Keyword | トピックに関連するキーワードを含みます。最大5件まで表示します。 |
| Word | 具体的なキーワードです。 |
| TopicName | トピックの日本語表記です。随時更新される見出しとは異なり、基本的に固定の名称です。 |
| English | トピックの英語表記です。これは固定の名称です。 |
| Overview | 話題の単位であるトピックについての数十文字の簡単な説明です。 |
| Category | トピックが所属するカテゴリ（国内、海外、経済、エンターテインメント、スポーツ、コンピュータ、サイエンス、地域のいずれか）です。 |
| SubCategory | サブカテゴリ（社会、政治などカテゴリの下の分類指標）を含みます。複数ある場合もあります。 |
| Sub | 具体的なサブカテゴリ名です。 |
| Url | トピックのURLです。 |
| PickupCategory | 掲載されたカテゴリです（上のCategoryにおけるカテゴリと一致しない場合があります）。 |
| PickupOrder | 掲載されたときの表示順位（「主なトピックス」掲載時の順位のみ）です。 |
| PvIndex | PV指標は現在のアクセス数から割り出した指標的な数値です。 |
| EditNum | 関連情報がエディターによって更新された回数です。 |
| NewsNum | 掲載されているニュースの件数です。 |
| NewsUrl | ニュース一覧ページのURLです。 |
| RelatedInformation | 関連情報（最大10件まで）を含みます。 |
| TotalNum | 関連情報の帯（関連情報エリア内の大見出し）の数です。 |
| RelatedInfoTitle | 関連情報の帯名です。 |
| RelatedInfoUrl | 関連情報の帯別のURLです。 |
| RelatedInfoText | 関連情報の帯ごとの内容（本文）です。 Wiki文法（関連情報独自の簡易な記述言語）が用いられています。 |
| SmartphoneUrl | スマートフォン最適化ページのURLです。 |
サンプルレスポンス
以下は、サンプル のクエリーの結果です。エラー
トピックスWeb APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
