---
title: "News Search"
method: POST
path: "/data/news/search"
tags: ["Data APIs"]
---

# News Search

`POST /data/news/search`

## Request

- Base URL: `https://api.notte.cc` (the document declares no server; this is the origin it was published from)
- URL: `https://api.notte.cc/data/news/search`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Headers

- `X-Notte-Cache-Mode` string, nullable: Extraction cache: default, refresh, or bypass.
- `X-Notte-Cache-Max-Age-Ms` string, nullable: Maximum cached result age in milliseconds; zero forces refresh.
- `X-Notte-Cache-Ttl-Seconds` string, nullable: Shorten the server storage TTL; zero bypasses caching.
- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Request body

- NewsSearchRequest
  - `searchBy` NewsSearchBy, required
    - `type` 'entity', required
    - `entity` union, required
      - NewsEntityName
        - `type` 'name', required
        - `name` string, required
      - NewsEntityDomain
        - `type` 'domain', required
        - `domain` string, required
      - NewsEntityTicker
        - `type` 'ticker', required
        - `ticker` string, required
        - `exchange` 'AMEX' | 'AMS' | 'AQS' | 'ASX' | 'ATH' | 'BER' | 'BME' | 'BRU' | 'BSE' | 'BUD' | 'BUE' | 'BVC' | 'CBOE' | 'CNQ' | 'CPH' | 'DFM' | 'DOH' | 'DUB' | 'DUS' | 'DXE' | 'EGX' | 'FSX' | 'HAM' | 'HEL' | 'HKSE' | 'HOSE' | 'ICE' | 'IOB' | 'IST' | 'JKT' | 'JNB' | 'JPX' | 'KLS' | 'KOE' | 'KSC' | 'KUW' | 'LIS' | 'LSE' | 'MCX' | 'MEX' | 'MIL' | 'MUN' | 'NASDAQ' | 'NEO' | 'NSE' | 'NYSE' | 'NZE' | 'OSL' | 'OTC' | 'PAR' | 'PNK' | 'PRA' | 'RIS' | 'SAO' | 'SAU' | 'SES' | 'SET' | 'SGO' | 'SHH' | 'SHZ' | 'SIX' | 'STO' | 'STU' | 'TAI' | 'TAL' | 'TLV' | 'TSX' | 'TSXV' | 'TWO' | 'VIE' | 'WSE' | 'XETRA', nullable
      - NewsEntityIsin
        - `type` 'isin', required
        - `isin` string, required
  - `filterBy` NewsFilter
    - `sourceDomain` string[], nullable
    - `sourceCountry` string[], nullable
    - `articleLanguage` string[], nullable
    - `articleType` string[], nullable
    - `date` NewsDateFilter
      - `from` integer, nullable
      - `to` integer, nullable
  - `sortBy` NewsSort
    - `type` 'newest' | 'relevance'
  - `limit` integer
  - `cursor` string, nullable
  - `tags` string[]

## Response `200`

Successful Response

- NewsSearchResponse
  - `data` NewsArticle[], required
    - `id` string, required
    - `story_id` string, required
    - `url` string, required
    - `title` string, required
    - `description` string, nullable
    - `language` string, nullable
    - `authors` string[]
    - `image_url` string, nullable
    - `published_at` string, nullable
    - `type` 'editorial' | 'press_release' | 'regulatory_filing' | 'advisory'
    - `source` NewsSource, required
      - `name` string, required
      - `domain` string, required
      - `direct` boolean
    - `match` NewsMatch, required
      - `level` 'primary' | 'secondary', required
      - `confidence` number, nullable
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `meta` NewsMeta, required
    - `count` integer, required
  - `request_id` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-18** `20f8ac8dc733`: 3 info
  - added the new optional `header` request parameter `X-Notte-Cache-Max-Age-Ms`
  - added the new optional `header` request parameter `X-Notte-Cache-Mode`
  - added the new optional `header` request parameter `X-Notte-Cache-Ttl-Seconds`
- **2026-10-16** `24d67222f012`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notte/apis/notte-api/changes/data/news/search/post.md)

---

[API](https://skmtc.dev/notte/apis/notte-api.md) - [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notte/apis/notte-api/revisions/d56fcbf39bc9?raw)