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

# Get News

> Retrieve recent financial news articles

## Query Parameters

<ParamField query="limit" type="integer" default="50" optional>
  Number of articles to return. Min: 1, Max: 100.
</ParamField>

<ParamField query="since" type="string" optional>
  Only return articles received after this ISO 8601 datetime. Example: `2026-04-07T00:00:00Z`
</ParamField>

<ParamField query="urgency" type="string" optional>
  Filter by urgency level: `breaking`, `flash`, or `regular`.
</ParamField>

## Response

<ResponseField name="count" type="integer">
  Number of articles returned.
</ResponseField>

<ResponseField name="articles" type="Article[]">
  Array of article objects. Max-plan responses additionally include a `tickers` array on each article (per-ticker sentiment, e.g. `[{"ticker": "AAPL", "sentiment": "positive"}]`). Starter and Pro responses omit the field.
</ResponseField>

<Note>
  Starter keys can query articles received in the last 24 hours; Pro and Max keys can query the last 7 days. Older `since` values are silently clamped to the allowed window.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-Key: YOUR_KEY" \
    "https://api.tradingnews.press/v1/news?limit=5&urgency=breaking"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.tradingnews.press/v1/news",
      headers={"X-API-Key": "YOUR_KEY"},
      params={"limit": 5}
  )
  articles = resp.json()["articles"]
  ```
</RequestExample>

<ResponseExample>
  ```json 200 (Starter / Pro) theme={null}
  {
    "count": 1,
    "articles": [
      {
        "id": "01KNKV33C9DDADR1HRRWGCSA8V",
        "content": "Apple announces record Q2 earnings, beats estimates by 12%",
        "urgency": "breaking",
        "sentiment": null,
        "published_at": "2026-04-07T14:30:00+00:00",
        "received_at": "2026-04-07T14:30:02.123456+00:00"
      }
    ]
  }
  ```

  ```json 200 (Max) theme={null}
  {
    "count": 1,
    "articles": [
      {
        "id": "01KNKV33C9DDADR1HRRWGCSA8V",
        "content": "Apple announces record Q2 earnings, beats estimates by 12%",
        "urgency": "breaking",
        "sentiment": null,
        "published_at": "2026-04-07T14:30:00+00:00",
        "received_at": "2026-04-07T14:30:02.123456+00:00",
        "tickers": [
          {"ticker": "AAPL", "sentiment": "positive"}
        ]
      }
    ]
  }
  ```
</ResponseExample>