News APIを使って巷のニュースを拾い上げてみた。

## はじめに
さて、最後の更新からおよそ10ヶ月経ってしまいました。毎週更新が目標だったのに。。というわけで、今後は毎月更新に下方修正してこれからも頑張りたいと思います（？）。さて復活第一弾はNews APIを使ってみた、です。RSSリーダーのような機能を自作のWebアプリにも搭載してみたいなと思い、試しに使ってみたのでここでまとめてみます。

## News APIとは
[<strong>「News API」</strong>](https://newsapi.org/)とは世界中のニュースをかき集めたサービスで、利用者はREST APIでニュースを取得できます。[無償版・有償版](https://newsapi.org/pricing)があり、HPを確認する限りでは有償版は企業でも利用されているようですが、記事更新が24時間遅れ、100リクエスト/日などの制約に目を瞑れば十分有用だと思うので今回は無償版を利用させていただきましょう。また、今回Pythonを使用してAPIを叩きますが、その他にもNode.js, Ruby, PHP, Java, C#が利用できるようです。利用までの大まかな流れは以下の通りです。めっちゃ簡単です。イージーピージー。
1. 利用登録・APIキー取得
2. APIを叩く

## 1. 利用登録・APIキー取得
一般的に、サービス利用時に求められる情報の提供さえすればAPIキーは取得可能なので、ここは省きます。

## 2. APIを叩く
News APIには<strong>「Everything」</strong>`/v2/everything`と<strong>「Top headlines」</strong>`/v2/top-headlines`の2種類のエンドポイントがありますが、今回は「Everything」を使います。それぞれパラメータが異なるので注意してください。

<script src="https://gitlab.com/-/snippets/3746930.js"></script>
<details>
<summary>「一行解説」を見る</summary>
<ol type="1">
<li>(l.1-3) <a href="https://newsapi.org/docs/client-libraries/python">公式ドキュメント</a>を確認すると<code>newsapi-python</code>というライブラリが使われているようですが、PythonでのHTTP通信によく使われる<code>requests</code>で代用可能なので今回はこちらを使います。その他、取得したデータを整形するための<code>pandas</code>もインポートします。
<li>(l.5-12) HTTPリクエスト時のパラメータを設定しています。<code>apiKey</code>はNews API登録時に取得したものです。また今回のニュース検索では検索クエリとして<code>q</code>、検索対象言語として<code>language</code>、検索条件として<code>sortBy</code>、期間指定として<code>from</code>と<code>to</code>を設定しています。<a href="https://newsapi.org/docs/endpoints/everything">検査対象言語</a>としては残念ながら日本語は設定できませんが、英語をはじめいくつかの言語が設定できるようです。デフォルトでは言語に関係なく返されますが、今回はフランス語（<code>fr</code>）を設定してみました。検索条件には<code>popularity</code>を設定しており、閲覧数の多いソース・出版社からの記事が優先されます。最後に、期間指定を指定しました。</li>
<li>(l.13-15) URLにはAPIのエンドポイントを、<code>get()</code>メソッド内にパラメーター（<code>params</code>）と一緒に設定します。レスポンスは<code>json()</code>メソッドを利用しJSON形式としてパースします。</li>
<li>(l.17) 最後にJSON形式のままでは利用しづらいため、DataFrame形式に変換しましょう。実際の記事データは、<code>articles</code>という配列の中に格納されているので、この部分だけ抜き出しますが、今回はJSON形式からの変換となるため、<code>pd.DataFrame()</code>メソッドではなく<code>json_normalize()</code>メソッドを利用します。</li>
</details>

## まとめ
今回はあえてフランス語での検索をしてみましたが、日本語のキーワードを入力すれば日本語の記事が返ってきます。しかし前述の通り日本語指定検索は非対応のため、一部中国語の記事が返されてしまいました。その後正規表現ライブラリを利用すればできなくはないですが、使いこなすには色々と工夫が必要そうです。