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

# Company news

> Search news articles about a company by name, domain, ticker or ISIN

> [!TIP]
>
> Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

`POST /data/news/search` returns recent articles about a company, with filters and cursor pagination.

> [card] [Try it in the Console](https://console.notte.cc/data-apis/news)
>
> Try this API in the playground, no code needed.

## Quick start

```bash theme={null}
curl -X POST https://api.notte.cc/data/news/search \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "searchBy": {"type": "entity", "entity": {"type": "name", "name": "Stripe"}},
    "limit": 2
  }'
```

```json theme={null}
{
  "data": [
    {
      "id": "59a2a2b022898353547631c59f6eb09f",
      "story_id": "88d3b5ceb2ca4b0cea76c3af4ec4a38c",
      "url": "https://finance.yahoo.com/...",
      "title": "Stripe Just Built the Full-Stack Agent Commerce Infrastructure in One Day",
      "description": "...",
      "language": "en",
      "authors": ["Tessa Vaughn"],
      "published_at": "2026-09-23T11:17:02Z",
      "type": "editorial",
      "source": { "name": "Yahoo! Finance", "domain": "finance.yahoo.com" }
    }
  ],
  "has_more": true,
  "next_cursor": "MjowNmM4...",
  "meta": { "count": 2 },
  "request_id": "..."
}
```

## Parameters

**searchBy** `object` *required*

`{"type": "entity", "entity": {...}}`. The entity is one of:

* `{"type": "name", "name": "Stripe"}`
* `{"type": "domain", "domain": "stripe.com"}`
* `{"type": "ticker", "ticker": "AAPL", "exchange": "NASDAQ"}`
* `{"type": "isin", "isin": "US0378331005"}`

**filterBy** `object`

Narrow the results:

* `sourceDomain`: only these publishers, for example `["reuters.com"]`
* `sourceCountry`: publisher countries, for example `["us", "gb"]`
* `articleLanguage`: for example `["en", "fr"]`
* `articleType`: a list of `editorial`, `press_release`, `regulatory_filing` or `advisory`, for example `["editorial"]`

**sortBy** `object`

`{"type": "newest"}` (default) or `{"type": "relevance"}`.

**limit** `integer` (default: 10)

Articles per page.

**cursor** `string`

Pass `next_cursor` from the previous response to get the next page. Stop when `has_more` is `false`.

Each article also has a `match` object describing how it matched your entity.


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