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

# News Browse

> Browse continuously updated company news by ticker, event, topic, or date.

<Note icon="sparkles">
  **Planned MCP tool**: `news_browse` — use it from Claude, Cursor, or another MCP client after launch. See [MCP Server](/en/integration/mcp-server) for setup.
</Note>

<Badge color="yellow">Coming Soon</Badge>
 
<Badge color="blue" size="sm">1 credit per call</Badge>

## What it does for your agent

`news_browse` gives your agent recent company news with concise titles, abstracts, and detailed summaries. Use exact filters to scan the market, follow companies, or find specific event and topic combinations.

Availability varies by company and date. Start with a recent query, then narrow the results with exact filters.

## Response

<ResponseField name="data" type="object" required>
  The matching news items and returned count.

  <Expandable title="data fields">
    <ResponseField name="items" type="NewsArticle[]" required>
      Results ordered by `published_at` descending, then `news_article_id` descending.

      <Expandable title="NewsArticle fields">
        <ResponseField name="news_article_id" type="string" required>
          Stable identifier for the news article.
        </ResponseField>

        <ResponseField name="title" type="string" required>
          Short title for scanning the result list.
        </ResponseField>

        <ResponseField name="abstract" type="string" required>
          One or two sentences for deciding whether to read the full summary.
        </ResponseField>

        <ResponseField name="summary" type="string" required>
          Detailed article summary with material facts and qualifying context.
        </ResponseField>

        <ResponseField name="events" type="string[]" required>
          Controlled event values in alphabetical order. Ignore unknown future values.
        </ResponseField>

        <ResponseField name="topics" type="string[]" required>
          Controlled subject topics in alphabetical order. Ignore unknown future values.
        </ResponseField>

        <ResponseField name="tickers" type="string[]" required>
          Equity symbols connected to the article.
        </ResponseField>

        <ResponseField name="published_at" type="string" required>
          Publication date in UTC, with day-level precision.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="count" type="number" required>
      Number of items returned in this response.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">Always `1` after a valid query runs, including an empty result.</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">Account credits remaining.</ResponseField>
<ResponseField name="meta.notice" type="string">Present when no data matches or more items exist beyond `limit`.</ResponseField>

```json title="200 OK · news_browse" expandable theme={null}
{
  "data": {
    "items": [
      {
        "news_article_id": "2bb83823-9f85-40ed-a51a-34f67d41a6af",
        "title": "NVIDIA Announces Q1 Results",
        "abstract": "NVIDIA reported quarterly results and described demand across its major businesses.",
        "summary": "NVIDIA reported quarterly performance and provided updated guidance for the next period.",
        "events": ["earnings", "guidance"],
        "topics": ["artificial_intelligence", "semiconductors"],
        "tickers": ["NVDA"],
        "published_at": "2026-06-01"
      }
    ],
    "count": 1
  },
  "meta": { "creditsUsed": 1, "remainingCredits": 99 }
}
```

## Notes

<Tip>
  Start without filters for recent market activity. Then combine `tickers`, `events`, and `topics` to narrow the result set.
</Tip>

<Warning>
  Availability varies by company, date, and category. A valid query can return no items when nothing matches the selected filters.
</Warning>

<Warning>
  Every valid query costs 1 credit, even when no items match. Invalid requests and service errors do not consume credits.
</Warning>

## Direct invocation

<Accordion title="HTTP / SDK examples" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    {
      "method": "tools/call",
      "params": {
        "name": "news_browse",
        "arguments": {
          "tickers": ["NVDA"],
          "events": ["earnings", "guidance"],
          "limit": 5
        }
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    resp = requests.get(
        "https://api.llmquantdata.com/api/news/browse",
        headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
        params={"tickers": "NVDA", "events": "earnings,guidance", "limit": 5},
    ).json()

    for item in resp["data"]["items"]:
        print(item["published_at"], item["title"])
    ```

    ```bash cURL theme={null}
    curl "https://api.llmquantdata.com/api/news/browse?tickers=NVDA&events=earnings,guidance&limit=5" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## Full parameter reference

<Accordion title="news_browse — request parameters" icon="sliders">
  <ParamField query="tickers" type="string">
    Comma-separated equity symbols. Values use OR logic. Maximum: 5.
  </ParamField>

  <ParamField query="events" type="string">
    Comma-separated event values. Values use OR logic. Supported values: `earnings`, `guidance`, `m_and_a`, `partnership`, `product`, `regulatory_approval`, `regulatory`, `legal`, `leadership_change`, `workforce`, `restructuring`, `bankruptcy`, `capital_action`, `credit_rating`, `analyst_rating`, `accounting_audit`, `operational_incident`, `shareholder_meeting`, `strategic_update`, `other`.
  </ParamField>

  <ParamField query="topics" type="string">
    Comma-separated subject topics. Values use OR logic. Supported values: `semiconductors`, `software`, `cloud_computing`, `cybersecurity`, `artificial_intelligence`, `consumer_electronics`, `it_hardware_networking`, `telecommunications`, `media_entertainment`, `internet_services`, `biotech_pharma`, `medical_devices`, `life_sciences_tools`, `healthcare_services`, `banking`, `capital_markets`, `insurance`, `fintech`, `crypto_digital_assets`, `real_estate`, `automotive`, `retail`, `consumer_packaged_goods`, `apparel_luxury`, `restaurants_leisure`, `aerospace_defense`, `industrial_machinery`, `transportation_logistics`, `construction_engineering`, `business_services`, `oil_gas`, `renewable_energy`, `utilities`, `metals_mining`, `chemicals`, `agriculture_food_production`, `paper_packaging_forestry`, `environmental_services`, `space_economy`, `quantum_computing`, `data_centers`, `macroeconomics_policy`, `geopolitics_trade`.
  </ParamField>

  <ParamField query="start_date" type="string">
    Inclusive UTC start date in `YYYY-MM-DD` format. Requires `end_date`.
  </ParamField>

  <ParamField query="end_date" type="string">
    Inclusive UTC end date in `YYYY-MM-DD` format. Requires `start_date`.
  </ParamField>

  <ParamField query="limit" type="number" default={10}>
    Maximum items returned. Range: 1–25.
  </ParamField>
</Accordion>

Parameters use AND logic across fields and OR logic within `tickers`, `events`, or `topics`. All parameters are optional, so an empty query returns recent market activity.

## Related

<Columns cols={2}>
  <Card title="Authentication" icon="key" href="/en/authentication">
    Create an API key and authenticate direct HTTP requests.
  </Card>

  <Card title="MCP Server setup" icon="plug" href="/en/integration/mcp-server">
    Connect Claude, Cursor, or another agent harness in 60 seconds.
  </Card>
</Columns>