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

# 뉴스 검색

> 카테고리, 국가, 언어, 날짜로 회사 뉴스를 찾습니다. 모든 기사는 언급한 회사에 연결되며, 선택적으로 기사가 생성한 확장 시그널에도 연결됩니다.

[뉴스 검색](/ko/api-reference/endpoint/companies/news_search)은 Pubrio가 분류한 뉴스 기사를 기사당 한 행으로 반환합니다. 각 행은 기사가 언급하는 **모든** 회사에 연결되고, 카테고리 슬러그(`acquires`, `partners_with`, `receives_financing` 등)를 가지며, 요청 시 기사가 생성한 확장 시그널도 포함합니다.

```bash theme={null}
curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "categories": ["partners_with", "launches"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'
```

## 언제 사용하나

* **계정 인텔리전스** — 이번 달 한 회사에 무슨 일이 있었는지, 카테고리별로.
* **트리거 기반 프로스펙팅** — 판매 대상 국가와 언어에서 투자 유치나 인수를 발표한 모든 회사.
* **시그널 근거** — `is_expansion_signal_available: true`로 어떤 기사가 어떤 [확장 시그널](/ko/knowledge-base/concepts/expansion-signals)을 생성했는지 확인.

카운트와 카테고리 분석에는 [뉴스 인사이트](/ko/api-reference/endpoint/companies/news_insights)를 사용하세요. 기사가 도착할 때 알림을 받으려면 `signal_types: ["news"]`로 모니터를 만드세요.

## 회사로 범위 지정

| 키               | 값                                             | 비고                               |
| --------------- | --------------------------------------------- | -------------------------------- |
| `domains`       | `["stripe.com"]`                              | 해당 회사에 관한 기사뿐 아니라 언급하는 기사와 일치합니다 |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | 회사 페이지만                          |
| `companies`     | `["5378845d-…"]`                              | `domain_search_id` 값             |

회사 없는 검색도 동작하며 — `{"categories": ["acquires"], "locations": ["SG"]}` — 그 카테고리의 전체 인덱스를 최신순으로 반환합니다.

## 필터

### 카테고리와 갤러리

| 키                  | 타입         | 일치 대상                                                                        |
| ------------------ | ---------- | ---------------------------------------------------------------------------- |
| `categories`       | `string[]` | [뉴스 카테고리](/ko/api-reference/endpoint/news/categories)의 카테고리 슬러그. 나열한 것 중 하나. |
| `news_galleries`   | `string[]` | [뉴스 갤러리](/ko/api-reference/endpoint/news/galleries)의 갤러리 슬러그.                |
| `news_gallery_ids` | `uuid[]`   | 같은 갤러리를 id로 지정.                                                              |
| `news_languages`   | `string[]` | [뉴스 언어](/ko/api-reference/endpoint/news/languages)의 ISO 639-1 코드.            |

### 텍스트

| 키              | 타입         | 일치 대상                          |
| -------------- | ---------- | ------------------------------ |
| `search_term`  | `string`   | 제목과 요약에 대한 자유 텍스트. 지원되는 모든 언어. |
| `search_terms` | `string[]` | 여러 용어. 하나만 일치해도 됩니다.           |

### 날짜

| 키                 | 타입              | 일치 대상                                   |
| ----------------- | --------------- | --------------------------------------- |
| `published_dates` | `[from, to]`    | 게시일 범위, 양끝 포함. 날짜 경계는 워크스페이스 시간대를 따릅니다. |
| `published_at`    | 날짜 또는 ISO 타임스탬프 | 이 시각 이후에 게시됨, UTC로 비교.                  |

### 위치

| 키                   | 타입         | 일치 대상                               |
| ------------------- | ---------- | ----------------------------------- |
| `locations`         | `string[]` | 기사가 **다루는** 국가(행의 `country_codes`). |
| `company_locations` | `string[]` | 언급된 회사의 본사 국가.                      |

### 확장 시그널

| 키                               | 타입         | 일치 대상                                                                                |
| ------------------------------- | ---------- | ------------------------------------------------------------------------------------ |
| `is_expansion_signal_available` | `boolean`  | 각 행에 `expansion_signals`를 붙이고 아래 두 필터를 활성화합니다. 가장 빠른 검색을 원하면 끄세요.                    |
| `expansion_signal_types`        | `string[]` | `HIRE`, `PARTNER`, `PRODUCT`, `SCALE` 등. 위 플래그 필요.                                   |
| `expansion_signal_polarities`   | `string[]` | `expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`. |

### 페이징과 정렬

| 키                    | 기본값     | 비고                                                    |
| -------------------- | ------- | ----------------------------------------------------- |
| `per_page` / `page`  | 25 / 1  | 플랜 제한. `total_display_pages` 참고.                      |
| `is_ascending_order` | `false` | 행은 `published_at` 최신순이며 날짜 없는 기사는 마지막. `true`면 오래된 순. |

## 행의 모습

```json theme={null}
{
  "news_id": "76886b56-3418-476a-a531-fff18deb29db",
  "news_search_id": "4d950aea-e2bb-4367-869b-c34e834a82ec",
  "title": "PayPal Rejects Takeover, Rated Buy",
  "summary": "…",
  "url": "https://seekingalpha.com/article/4942660-…",
  "source": "seekingalpha.com",
  "image_url": "https://static.seekingalpha.com/…",
  "language": "en",
  "published_at": "2026-09-03T08:54:21.000000Z",
  "last_modified": "2026-09-03T09:20:55.189Z",
  "category": "receives_financing",
  "news_category_name": "Funding Announcements",
  "news_galleries": [{ "news_gallery_id": "342f2eb1-…", "slug": "general-business", "name": "General Business" }],
  "country_codes": null,
  "company_country_codes": ["US"],
  "locations": null,
  "domains": ["paypal.com", "stripe.com"],
  "companies": [
    { "domain_search_id": "5378845d-…", "company_name": "Stripe", "domain": "stripe.com", "country_code": "US", "…": "…" },
    { "domain_search_id": "b03b312a-…", "company_name": "PayPal", "domain": "paypal.com", "country_code": "US", "…": "…" }
  ]
}
```

* `companies`와 `domains`는 나란한 배열이며 언급된 **모든** 회사를 나열합니다. 따라서 `stripe.com`으로 범위를 지정한 검색이 주제가 PayPal인 기사를 반환할 수 있습니다. 귀사가 주제인 기사가 필요하면 클라이언트 측에서 `domains`로 필터링하세요.
* `country_codes`는 기사가 다루는 국가이고, `company_country_codes`는 언급된 회사의 소재지입니다. `locations`는 전자를 필터링합니다.
* `news_category_name`은 요청의 `language`에 맞게 현지화되고, `category`는 안정적인 슬러그입니다.
* `is_expansion_signal_available: true`이면 각 행에 `expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]`가 추가됩니다.

### `metadata.ignored_fields`

엔드포인트가 인식하지 못하는 본문 키는 제거되어 여기에 나열됩니다. `"categorys"`는 오류가 아니라 `ignored_fields: ["categorys"]`와 함께 전체 인덱스를 반환합니다.

## 레시피

<Tabs>
  <Tab title="일본어 투자 유치 뉴스">
    ```bash cURL theme={null}
    curl -X POST https://api.pubrio.com/companies/news/search \
      -H "pubrio-api-key: $PUBRIO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "categories": ["receives_financing"],
        "news_languages": ["ja"],
        "published_dates": ["2026-08-01", "2026-09-04"],
        "per_page": 25
      }'
    ```
  </Tab>

  <Tab title="한 계정의 확장 근거">
    ```bash cURL theme={null}
    curl -X POST https://api.pubrio.com/companies/news/search \
      -H "pubrio-api-key: $PUBRIO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "domains": ["stripe.com"],
        "is_expansion_signal_available": true,
        "expansion_signal_types": ["HIRE", "PARTNER", "PRODUCT", "OFFICE"],
        "expansion_signal_polarities": ["expansion"],
        "per_page": 25
      }'
    ```

    이제 각 행이 [회사 확장 상세](/ko/api-reference/endpoint/expansions/company_lookup)에서는 단계로만 보이던 시그널을 설명합니다.
  </Tab>

  <Tab title="일일 다이제스트">
    ```python Python theme={null}
    import os, requests
    from datetime import datetime, timedelta, timezone

    since = (datetime.now(timezone.utc) - timedelta(days=1)).strftime("%Y-%m-%dT%H:%M:%SZ")
    body = requests.post(
        "https://api.pubrio.com/companies/news/search",
        headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
        json={"domains": ["stripe.com", "adyen.com"], "published_at": since, "per_page": 25},
    ).json()

    for a in body["data"]["news"]:
        subjects = ", ".join(c["company_name"] for c in a["companies"])
        print(f'[{a["category"]}] {a["title"]} — {subjects}')
    ```

    `published_at`은 UTC로 비교되므로 달력 날짜보다 최근 24시간 타임스탬프가 더 안전합니다.
  </Tab>
</Tabs>

## 관련

<CardGroup cols={2}>
  <Card title="뉴스 검색 레퍼런스" icon="code" href="/ko/api-reference/endpoint/companies/news_search">
    모든 파라미터와 응답 필드.
  </Card>

  <Card title="뉴스 인사이트" icon="chart-column" href="/ko/api-reference/endpoint/companies/news_insights">
    한 회사의 기간 내 언급, 주제, 소스.
  </Card>

  <Card title="뉴스 카테고리" icon="tags" href="/ko/api-reference/endpoint/news/categories">
    필터링할 수 있는 카테고리 슬러그.
  </Card>

  <Card title="확장 시그널" icon="globe" href="/ko/knowledge-base/concepts/expansion-signals">
    시그널 유형과 극성의 의미.
  </Card>
</CardGroup>