> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google ニュース検索結果 API

> 検索に対して Google のニュースタブが表示する記事を、最大10ページまで媒体名、日付、リンクとともに取得します。

`GOOGLE_NEWS` は、検索に対して Google 検索の「ニュース」タブが表示する記事のリストを返します。約10件の記事が入ったページを最大10ページ読み、ページをまたいで Google の順序を保つため、あるトピック、ブランド、競合について Google がどの媒体を表示するか、その変化を追跡できます。

| | |
| - | - |
| `taskType` | `GOOGLE_NEWS` |
| 入力 | `query`(必須)、`pages`、`country`、`device`、`hl` |
| クレジット | 読んだニュースページごとに1。1ページに記事が約10件入ります。 |
| 国 | 既定値は `US`。任意の ISO 3166-1 alpha-2 コード。 |

## リクエスト

次のリクエストは、米国で電気自動車の関税を検索したときのニュースタブの最初の2ページを取得します。

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_NEWS", "payload": { "query": "electric vehicle tariffs", "country": "US", "pages": 2 } }'
```

タスクは非同期で実行されます。結果は[非同期タスク](https://docs.querying.ai/ja/concepts/async-tasks.md)の説明に従って読んでください。

## パラメータ

| フィールド | 必須 | 説明 |
| - | - | - |
| `query` | はい | 検索クエリ、1〜100,000文字。`query` がなければ `prompt` を受け付けます。 |
| `pages` | いいえ | 読むニュースページの数、1〜10の整数。既定値は `1`。 |
| `country` | いいえ | 検索する Google の市場。既定値は `US`。ページの言語は国に従い、`hl` で変えられます。 |
| `device` | いいえ | 既定値は `desktop`。`mobile` または `android` は Android スマートフォンの Chrome が描画するページを読みます。`ios` は `422` を返します。 |
| `hl` | いいえ | Google の `hl`、ニュースページの表示言語です。既定は `country` に合わせた言語です。記事の日付や表示文言がこの言語になります。`pt-br` は `pt-BR` として読みます。 |

## レスポンス

たとえば、上のリクエストの結果です。

```json theme={"theme":"css-variables"}
{
  "newsResults": [
    {
      "position": 1,
      "title": "...",
      "link": "https://...",
      "snippet": "...",
      "source": "...",
      "date": "3 hours ago",
      "page": 1,
      "thumbnail": "..."
    },
    { "position": 11, "page": 2, "...": "..." }
  ],
  "pages": 2
}
```

| フィールド | 説明 |
| - | - |
| `newsResults` | 常に存在し、Google の表示順に並びます。各記事には `position`、`title`、`link`、`page` があり、Google が表示していれば `snippet`、`source`、`date`、`thumbnail` も入ります。 |
| `newsResults[].position` | リスト全体での記事の順位。1から始まり、ページをまたいで数えます。 |
| `newsResults[].page` | その記事が載っていたニュースページ、1〜10。 |
| `newsResults[].link` | 記事のアドレス。Google のリダイレクトを時間内に読めなかった場合は空になり、そのリダイレクトは `redirectLink` に入ります。 |
| `newsResults[].redirectLink` | Google がリンクをリダイレクトとして返した場合の、そのリダイレクト。空の `link` は [`POST /v1/google/goto`](https://docs.querying.ai/ja/api-reference/google-goto) で解決してください。 |
| `newsResults[].date` | Google が表示した経過時間または日付。ページの言語で書かれます。 |
| `pages` | 読んだニュースページの数。この数だけ課金されます。 |

`pages` に届く前に Google のリストが終わると、`newsResults` には Google が表示したすべての記事が入り、`pages` は読んだページ数を数えます。`position`、`title`、`link`、`page` 以外はすべて任意フィールドとして扱ってください。

## クレジット

読んだニュースページごとに1クレジットです。タスクの開始時に、指定したページ数のクレジットを確保します。既定値では1、`pages: 10` では10です。完了時には実際に読んだページ数だけ課金するため、Google のリストが3ページで終われば3クレジットです。失敗したタスクは0です。[クレジットと上限](https://docs.querying.ai/ja/concepts/credits-and-limits.md)を参照してください。

## 制限とエラー

* 完了したタスクで `newsResults` が空なら、Google がその検索に記事を1件も表示しなかったことを意味します。返す前に別のブラウザで再確認しており、1クレジットが課金されます。
* `en`、`de`、`pt-BR` のような言語コードでない `hl` は `422 VALIDATION_ERROR` を返します。
* 1〜10の範囲外の `pages`、`desktop`・`mobile`・`android` 以外の `device` は `422 VALIDATION_ERROR` を返します。
* `state` と `uule` は `422 LOCATION_UNSUPPORTED` を返します。市場は `country` で指定してください。
* `include.rawResponse` は効果がなく、`include.html` と `include.analysis` は `422` を返します。[Markdownと生レスポンス](https://docs.querying.ai/ja/engines/response-options.md)を参照してください。
* その他のリクエストエラーは[エラー](https://docs.querying.ai/ja/concepts/errors.md)に記載しています。

## 関連

* [Google 検索](https://docs.querying.ai/ja/engines/google-serp.md): オーガニック検索結果を含む結果ページを1ページ分
* [Google リダイレクトの解決](https://docs.querying.ai/ja/api-reference/google-goto.md)
* [クレジットと上限](https://docs.querying.ai/ja/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.