---
title: "Search company news"
method: POST
path: "/news/search"
tags: ["News"]
---

# Search company news

`POST /news/search`

Searches live and historical company news for one company, identified in searchBy by name, domain, ticker (optionally disambiguated by exchange), or ISIN. Results can be filtered by publisher domain, publisher country, article language, article type, and published-at date, and include stable story IDs, source metadata, verified entity relevance, and cursor pagination.

## Request body

- object
  - `searchBy` object, required — What to search for.
    - `type` 'entity', required — How to search. Only entity search is supported.
    - `entity` union, required — The company to search news for, identified by name, domain, ticker, or ISIN.
      - NewsSearchEntityByName — Identify the company by name.
        - `type` 'name', required
        - `name` string, required — Company name.
      - NewsSearchEntityByDomain — Identify the company by website domain.
        - `type` 'domain', required
        - `domain` string, required — Company website domain, such as apple.com.
      - NewsSearchEntityByTicker — Identify the company by stock ticker, optionally scoped to an exchange.
        - `type` 'ticker', required
        - `ticker` string, required — Public-company ticker.
        - `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' — Stock exchange the ticker trades on, used to disambiguate tickers listed on multiple exchanges.
      - NewsSearchEntityByIsin — Identify the company by International Securities Identification Number.
        - `type` 'isin', required
        - `isin` string, required — International Securities Identification Number.
  - `filterBy` object — Optional result filters.
    - `sourceDomain` string[] — Publisher domains to include. Up to 3.
    - `sourceCountry` string[] — Publisher countries to include, as lowercase ISO 3166-1 alpha-2 codes. Up to 3.
    - `articleLanguage` string[] — Article languages to include. Up to 3.
    - `articleType` string[] — Article types to include. Up to 3.
    - `date` object — Published-at window in epoch milliseconds.
      - `from` integer — Inclusive start of the published-at window, in epoch milliseconds.
      - `to` integer — Inclusive end of the published-at window, in epoch milliseconds.
  - `sortBy` object — Result ordering. Defaults to newest.
    - `type` 'relevance' | 'newest', required — Result ordering.
  - `limit` integer — Maximum results to return. Defaults to 10.
  - `cursor` string, nullable — Opaque next_cursor from the previous response, or null for the first page.
  - `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Company news results

- object
  - `data` object[], required — Articles matching the search, in the requested order.
    - `id` string, required — Stable unique identifier for this article. Use it to deduplicate or reference an article across requests.
    - `story_id` string, required — Shared by articles covering the same story on the same day. Use it to group or collapse syndicated copies of one announcement across outlets.
    - `url` string, uri, required — Link to the article on the publisher site.
    - `title` string, required — Article headline.
    - `description` string, nullable, required — Short summary or excerpt of the article, when the publisher provides one.
    - `language` string, nullable, required — Language the article is written in, as a lowercase ISO 639-1 code such as en. Null when unknown.
    - `authors` string[], required — Bylined authors. Empty when no byline is available.
    - `image_url` string, nullable, required — Lead image for the article, when one is available.
    - `published_at` string, date-time, nullable, required — When the article was published, as an ISO 8601 timestamp. Null when the publisher does not state a reliable date.
    - `type` 'editorial' | 'press_release' | 'regulatory_filing' | 'advisory', required — Kind of coverage. Use it to separate independent reporting (editorial) from company-issued content (press_release, regulatory_filing, advisory).
    - `source` object, required — The publication that published the article.
      - `name` string, required — Name of the publication, such as Reuters.
      - `domain` string, required — Website domain of the publication.
      - `direct` boolean, required — True when Context observed this article in the publisher-owned feed.
    - `match` object, required — How the article relates to the company you searched for.
      - `level` 'primary' | 'secondary', required — primary when the article is mainly about the company, secondary when the company is mentioned but is not the main subject.
      - `confidence` number, nullable, required — How confident the match is, from 0 to 1. Null when a score is unavailable.
  - `has_more` boolean, required — True when more results are available beyond this page.
  - `next_cursor` string, nullable, required — Pass as cursor in the next request to fetch the following page. Null when there are no more results.
  - `meta` object, required — Summary information about this response.
    - `count` integer, required — Number of articles in this page.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Request exceeded the applicable rate limit.
- `500` — News search failed because the index or an upstream resolver was unavailable.

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/revisions/05aa6b6ed6d7/schema)