seo/
google-news

企業、製品、トピックのGoogleニュース記事を任意の市場で収集し、見出し、抜粋、媒体名、公開日時、サムネイル、媒体サイトの記事ページへの直リンクを返します。

Google News API

トップニュースを先頭に
媒体への直リンク
公開日時
国と言語を指定
結果1件あたり0.1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Google News

Googleニュースは各ニュース媒体の記事を集めて検索ごとに順位付けし、トップニュースのカルーセルをより幅広い記事一覧の上に置き、各結果に見出し、抜粋、媒体名、公開日時を表示します。企業や製品、トピックについてこの結果を追い続ければ、誰が報じているか、ニュースが媒体間にどれだけ速く広がるか、国によって報道がどう違うかがわかり、メディアモニタリング、競合アラート、毎日のニュースダイジェストの素材になります。

Google News API の主な機能

  • 記事そのものへのリンクurl は媒体サイト上の記事を指すので、Googleのリンクを経由せずにそのまま開く、保存する、読者に渡すことができます。
  • トップニュースを区別section が各記事を top_stories か news に分け、rank はトップニュースのカルーセルを先頭にGoogleの順序を保ちます。
  • すべての記事に媒体名と公開日時source は媒体名、domain は媒体サイト、published_at は公開日時で、報道の並べ替えや絞り込みに使えます。
  • 見出し、抜粋、サムネイルtitle と text に見出しとその下の抜粋が入り、image_url は公開されている場合に記事のサムネイルを示します。
  • 任意の市場で最大200件検索の国と言語を選び、results_limit で1リクエストあたり1〜200件を指定できます。

Google News API のパラメータ

パラメータ必須説明
query必須ニュースの検索語。企業、製品、人物、トピックなど。
location_code任意ニュース市場のロケーションコード。既定は2840(米国)です。
location_name任意location_code の代わりに使う市場名。指定すると location_code より優先されます。
language_code任意ニュースの言語コード。既定は en です。
language任意language_code の代わりに使う言語名。指定すると language_code より優先されます。
results_limit任意取得する記事の上限。1〜200、既定は10です。

Google News API の使い方

検索語を送信し、記事ごとに1行で読み取ります。

  1. {"query": "nvidia", "location_code": 2840, "language_code": "en", "results_limit": 10} を /v1/seo/google-news に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から rank 順に記事を読み取り、has_more が true の間は results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/seo/google-news" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nvidia","location_code":2840,"language_code":"en","results_limit":10}'

Google News API の主なユースケース

  • 自社ブランドの報道をモニタリング: ブランド名を定期的に検索し、確認済み記事の url を保存して、新しい記事が出たら source と published_at とともに通知します。
  • 競合の発表やリリースを把握: 競合各社の名前や製品ラインを調べ、どの媒体がどれだけ早く取り上げているかを確認します。
  • 毎日のニュースダイジェストを作る: 業界トピックの top_stories を毎朝集め、見出し、抜粋、リンクをチームのチャンネルやニュースレターに送ります。
  • 国ごとの報道を比較: 同じ検索語を複数の市場で調べ、世界に広がるニュースと国内にとどまるニュースを見分けます。

Google News API 活用のヒント

  • 主要ニュースだけで足りるなら、results_limit を増やすより section が top_stories の行に絞り込みましょう。
  • 実行をまたいで重複を除くときは url をキーにしましょう。記事自体のアドレスで、行の id にもなっています。
  • 名前が紛らわしい場合は、業種や製品名などの限定語を query に加えて無関係な記事を除きましょう。

Google News API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Keywords for Site API — 1つのWebサイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
  • Google Autocomplete API — 検索語の書き出しに対してGoogleが示すサジェストを、Googleの表示順のまま、国と言語を選んで集めます。

他のプラットフォームを見る

SEOのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Google News API — よくある質問

Google News APIは、選んだ国と言語で検索語に対するGoogleニュースの記事を返すAPIです。各記事に見出し、抜粋、媒体名、ドメイン、公開日時、サムネイル、記事への直リンクが含まれます。

url は媒体サイト上の記事を指しているので、そのまま開いたり保存したりできます。

section はGoogleでの表示場所を示し、top_stories はトップニュースのカルーセル、news はメインの一覧です。rank ではトップニュースが先に並びます。

results_limit は1〜200で、既定は10です。

返された記事1件ごとに0.1クレジットです。