> ## 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. 한 페이지에 기사 10개 안팎이 담깁니다. |
| 국가 | 기본값 `US`. 모든 ISO 3166-1 alpha-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/ko/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/ko/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/ko/concepts/credits-and-limits.md)를 참고하세요.

## 제한과 오류

* 완료된 태스크의 `newsResults`가 비어 있으면 Google이 그 검색어에 기사를 하나도 보여 주지 않았다는 뜻입니다. 반환하기 전에 다른 브라우저에서 한 번 더 확인하며, 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/ko/engines/response-options.md)을 참고하세요.
* 그 밖의 요청 오류는 [오류](https://docs.querying.ai/ko/concepts/errors.md)에 정리되어 있습니다.

## 관련 문서

* 자연 검색 결과가 담긴 결과 페이지 하나를 받는 [Google 검색](https://docs.querying.ai/ko/engines/google-serp.md)
* [Google 리다이렉트 해석](https://docs.querying.ai/ko/api-reference/google-goto.md)
* [크레딧과 한도](https://docs.querying.ai/ko/concepts/credits-and-limits.md)


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