Googleニュース API
Google Newsは、ニュース媒体の記事を集めたサービスです。searchはクエリに対する最新の記事を最大20件返します。各記事にはタイトル、リンク、媒体名、スニペット、公開日時、画像が含まれます。
結果はcountryとlanguageで設定したエディション（デフォルトはusとen）に従います。time_windowで記事の公開期間を制限できます。キーワードにはsite:cnn.com、OR、-wordなどのGoogle検索演算子を使えます。料金は記事が1件でも20件でも、1回の呼び出しにつき同じです。また、Google Newsは指定した件数より少ない記事を返すことがあります。
プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Googleニュースの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでGoogle Newsを検索し、タイトル、リンク、配信元、スニペット、公開日時、画像を含む記事を最大20件取得します。country、language、time_window（1時間、1日、1週間、1か月、1年）で絞り込めます。キーワードにはsite:、OR、-などの検索演算子を使用できます。 | 1,000リクエストあたり$0.79 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Googleニュースの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | country, language, time_window | Sync配信 | カタログ値：defaultLimit=20、maxLimit=20。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.79 | rank · title · url · source · text · published_at · image_url · platform |
Googleニュースのsearchのパラメータはそれぞれどういう意味ですか？
keywordでGoogle Newsを検索し、タイトル、リンク、配信元、スニペット、公開日時、画像を含む記事を最大20件取得します。country、language、time_window（1時間、1日、1週間、1か月、1年）で絞り込めます。キーワードにはsite:、OR、-などの検索演算子を使用できます。
keyword必須- ニュースの検索語です（例：
OpenAI）。site:cnn.com、OR、単語を除外する-wordなどのGoogle演算子を使用できます。500文字以内で指定します。Google検索ヘルプ：検索結果を絞り込む演算子 — Google検索ヘルプでは、結果を1つのサイトに限定する`site:`、語句を除外する`-`、完全一致のフレーズを指定する引用符などの演算子が説明されており、演算子と語句の間にはスペースを入れずに記述します。この資料が説明しているのはGoogleの検索構文のみです。Google NewsでこのAPIの`keyword`にこれらの演算子を指定できること、および`country`、`language`、`time_window`のフィルター仕様は、EveryInfraが定めています。この資料は結果や件数を保証するものではありません。 · 確認日 country任意- 検索するGoogle Newsのエディションを指定する2文字の国コードです（例：
us、gb、de）。デフォルトはusです。 language任意- エディションの言語を指定する2文字の言語コードです（例：
en、es、de）。デフォルトはenです。 time_window任意- 指定した期間の記事のみを対象にします。
hour、day、week、month、yearのいずれかを指定します。省略すると期間の制限はありません。
Googleニュース APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_news","action":"search","params":{"keyword":"<keyword>"}}'
Googleニュース APIに関する質問
Googleニュース APIでは何を取得できますか？
platformをgoogle_newsに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるGoogleニュースのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Googleニュースのsearchリクエストを開始するには、どの入力を使用しますか？
ニュースの検索語です（例：OpenAI）。site:cnn.com、OR、単語を除外する-wordなどのGoogle演算子を使用できます。500文字以内で指定します。params内のkeywordとして送信してください。
Googleニュースのsearchはどのフィールドを返しますか？
宣言されたスキーマにはrank、title、source、textが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Googleニュースのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。