# CNBC API

> CNBC returns news headlines, article search results, and market quotes through a workflow and API.

CNBC’s List headlines returns stories from a selected news section, using the section and maximum results as inputs. Search news finds CNBC-published articles by keyword, with optional publication dates, sort order, and page number. Get market snapshot returns levels and changes for major stock indexes and U.S. futures, optionally by region.

- Page: https://fous.com/workflows/cnbc
- Handle: `@cnbc`
- Category: [News](https://fous.com/workflows/category/news)
- Source website: https://cnbc.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with CNBC.

## Methods

### Get market snapshot

Operation `get_market_snapshot`, version 1. 1 credit per call.

Get CNBC levels and changes for major stock indexes and U.S. futures, optionally by region. Quote times and market-status labels are null when CNBC does not show them; quotes may be delayed.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `region` | string | no | `"europe"` | Market region to include, such as "europe". Defaults to "us". |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "region": {
      "enum": [
        "us",
        "europe",
        "asia",
        "all"
      ],
      "type": "string",
      "default": "us",
      "description": "Market region to include, such as \"europe\". Defaults to \"us\".",
      "examples": [
        "europe",
        "us",
        "asia"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "region": "europe"
    },
    {
      "region": "us"
    },
    {
      "region": "asia"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `markets` | array |  | Market quotes in the requested regional order. |
| `markets[].name` | string | `"FTSE 100"` | Index or futures name. |
| `markets[].as_of` | string or null | `"2026-09-28T16:35:00+01:00"` | Time of the quote with its UTC offset, if provided by CNBC. |
| `markets[].level` | number or null | `10684.88` | Most recent reported level. |
| `markets[].page_url` | string | `"https://www.cnbc.com/quotes/.FTSE"` | CNBC quote page. |
| `markets[].cnbc_symbol` | string | `".FTSE"` | CNBC quote symbol. |
| `markets[].change_points` | number or null | `-10.37` | Change from the previous close in points. |
| `markets[].market_status` | string or null |  | CNBC market-status label if one is explicitly provided. |
| `markets[].change_percent` | number or null | `-0.1` | Change from the previous close as a percentage number. |

**Example input**

```json
{
  "region": "europe"
}
```

**Example output**

```json
{
  "markets": [
    {
      "name": "FTSE 100",
      "as_of": "2026-09-28T16:35:00+01:00",
      "level": 10684.88,
      "page_url": "https://www.cnbc.com/quotes/.FTSE",
      "cnbc_symbol": ".FTSE",
      "change_points": -10.37,
      "market_status": null,
      "change_percent": -0.1
    },
    {
      "name": "DAX",
      "as_of": "2026-09-28T18:00:00+02:00",
      "level": 25374.42,
      "page_url": "https://www.cnbc.com/quotes/.GDAXI",
      "cnbc_symbol": ".GDAXI",
      "change_points": -34.22,
      "market_status": null,
      "change_percent": -0.13
    },
    {
      "name": "CAC 40",
      "as_of": null,
      "level": 8078.48,
      "page_url": "https://www.cnbc.com/quotes/.FCHI",
      "cnbc_symbol": ".FCHI",
      "change_points": 0,
      "market_status": null,
      "change_percent": 0
    }
  ]
}
```

### List headlines

Operation `list_headlines`, version 1. 1 credit per call.

List CNBC article headlines in the order they appear on a public news section page. Results are limited to stories in the initial page view; a section may show fewer than the requested maximum.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `section` | string | no | `"tech"` | News section to read, for example tech. |
| `max_results` | integer | no | `5` | Maximum stories to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "section": {
      "enum": [
        "top stories",
        "markets",
        "business",
        "investing",
        "tech",
        "politics",
        "personal finance",
        "economy"
      ],
      "type": "string",
      "default": "top stories",
      "description": "News section to read, for example tech.",
      "examples": [
        "tech",
        "top stories",
        "politics"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum stories to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5,
        10,
        50
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "section": "tech",
      "max_results": 5
    },
    {
      "section": "top stories",
      "max_results": 10
    },
    {
      "section": "politics",
      "max_results": 50
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  | CNBC stories in the order shown on the section page. |
| `stories[].authors` | array |  |  |
| `stories[].section` | string | `"tech"` |  |
| `stories[].summary` | string or null | `"The heads of OpenAI and rival Anthropic have both indicated recently that top AI labs should slow the pace of model dev` |  |
| `stories[].headline` | string | `"Samsung to inject $1 billion into Nvidia- and KKR-backed AI infrastructure firm"` |  |
| `stories[].image_link` | string or null | `"https://image.cnbcfm.com/api/v1/image/108333294-1783682286868-gettyimages-2283571410-SKOREA_SAMSUNG.jpeg?v=1783682311"` |  |
| `stories[].article_link` | string | `"https://www.cnbc.com/2026/09/29/samsung-investment-nvidia-kkr-ai-helix-digital.html"` |  |
| `stories[].published_at` | string or null | `"2026-09-29T00:00:10+00:00"` | Publication date and time in ISO 8601 with offset. |

**Example input**

```json
{
  "section": "tech",
  "max_results": 5
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Jenny Lee"
      ],
      "section": "tech",
      "summary": null,
      "headline": "Samsung to inject $1 billion into Nvidia- and KKR-backed AI infrastructure firm",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108333294-1783682286868-gettyimages-2283571410-SKOREA_SAMSUNG.jpeg?v=1783682311",
      "article_link": "https://www.cnbc.com/2026/09/29/samsung-investment-nvidia-kkr-ai-helix-digital.html",
      "published_at": "2026-09-29T00:00:10+00:00"
    },
    {
      "authors": [
        "Ashley Capoot"
      ],
      "section": "tech",
      "summary": null,
      "headline": "OpenAI abandons plan to release upcoming model as safety concerns escalate",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108363595-1789562931107-gettyimages-2294958313-train0827.jpeg?v=1790634288",
      "article_link": "https://www.cnbc.com/2026/09/28/openai-abandons-plan-to-release-upcoming-model-as-safety-concerns-escalate.html",
      "published_at": "2026-09-28T22:27:58+00:00"
    },
    {
      "authors": [
        "Alexa LoMonaco"
      ],
      "section": "tech",
      "summary": null,
      "headline": "AMD briefly joined the $1 trillion club. Cramer says its monster run isn’t over",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108158703-1749756531719-Screenshot_2025-06-12_at_32333_PM.png?v=1750098597",
      "article_link": "https://www.cnbc.com/2026/09/28/jim-cramer-amd-lisa-su-agentic-ai.html",
      "published_at": "2026-09-28T22:27:10+00:00"
    }
  ]
}
```

### Search news

Operation `search_news`, version 1. 1 credit per call.

Search CNBC-published articles by keyword, with optional publication dates, sort order, and pagination. Excludes videos, wire stories, and press releases.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Result page to return, such as 2. |
| `sort` | string | no | `"most_relevant"` | Order articles by newest date or relevance, such as newest. |
| `query` | string | yes | `"Nvidia"` | Words to search for, such as Tesla. |
| `to_date` | string | no | `"2026-09-27"` | Latest publication date, inclusive, such as 2026-09-29. No limit if omitted. |
| `from_date` | string | no | `"2026-09-20"` | Earliest publication date, inclusive, such as 2026-09-01. No limit if omitted. |
| `max_results` | integer | no | `5` | Maximum articles per page, such as 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Result page to return, such as 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order articles by newest date or relevance, such as newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, such as Tesla.",
      "examples": [
        "Nvidia",
        "Tesla",
        "nonsensicalxyzz1234567890"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date, inclusive, such as 2026-09-29. No limit if omitted.",
      "examples": [
        "2026-09-27"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date, inclusive, such as 2026-09-01. No limit if omitted.",
      "examples": [
        "2026-09-20"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum articles per page, such as 20.",
      "x-fous-developer": true,
      "examples": [
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "Nvidia",
      "max_results": 5
    },
    {
      "query": "Tesla"
    },
    {
      "page": 2,
      "query": "Tesla",
      "to_date": "2026-09-27",
      "from_date": "2026-09-20",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].link` | string | `"https://www.cnbc.com/2026/09/28/biggest-wall-street-analyst-calls-on-monday.html"` |  |
| `articles[].authors` | array |  |  |
| `articles[].section` | string or null | `"Analyst Calls of the Day"` |  |
| `articles[].summary` | string or null | `"Here are Monday's biggest calls on Wall Street."` |  |
| `articles[].headline` | string | `"Here are Monday's biggest analyst calls: Nvidia, SpaceX, Apple, Micron, Coinbase, Tesla, Sweetgreen & more"` |  |
| `articles[].published_at` | string | `"2026-09-28T12:22:20+00:00"` |  |

**Example input**

```json
{
  "page": 2,
  "sort": "most_relevant",
  "query": "Nvidia",
  "max_results": 5
}
```

**Example output**

```json
{
  "articles": [
    {
      "link": "https://www.cnbc.com/2026/09/28/biggest-wall-street-analyst-calls-on-monday.html",
      "authors": [
        "Michael Bloom"
      ],
      "section": "Analyst Calls of the Day",
      "summary": "Here are Monday's biggest calls on Wall Street.",
      "headline": "Here are Monday's biggest analyst calls: Nvidia, SpaceX, Apple, Micron, Coinbase, Tesla, Sweetgreen & more",
      "published_at": "2026-09-28T12:22:20+00:00"
    },
    {
      "link": "https://www.cnbc.com/2026/09/28/stocks-making-the-biggest-moves-premarket-meta-ual-nvda.html",
      "authors": [
        "Davis Giangiulio"
      ],
      "section": "Market Insider",
      "summary": "These are the stocks posting the largest moves premarket.",
      "headline": "Stocks making the biggest moves premarket: Meta Platforms, United Airlines, Nvidia & more",
      "published_at": "2026-09-28T11:29:28+00:00"
    },
    {
      "link": "https://www.cnbc.com/2026/09/26/nvidia-and-these-other-stocks-are-on-sale-bank-of-america-says.html",
      "authors": [
        "Michael Bloom"
      ],
      "section": "Pro: Analyst Calls",
      "summary": "Bank of America named several stocks that it said are undervalued.",
      "headline": "Bank of America says Nvidia and these other stocks are on sale",
      "published_at": "2026-09-26T13:43:15+00:00"
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@cnbc",
  "visibility": "public",
  "operation": "get_market_snapshot",
  "version": 1,
  "input": {
    "region": "europe"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@cnbc\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_market_snapshot\",\n  \"version\": 1,\n  \"input\": {\n    \"region\": \"europe\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@cnbc",
  "visibility": "public",
  "operation": "get_market_snapshot",
  "version": 1,
  "input": {
    "region": "europe"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@cnbc","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Track headlines from a selected news section.
- Find CNBC articles about a company or topic.
- Review article summaries and publication dates.
- Compare reported index and futures levels and changes.

## FAQ

### Is Fous affiliated with CNBC?

No. Fous is not affiliated with CNBC. This workflow reads the public cnbc.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a CNBC account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from cnbc.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What headlines appear in a CNBC section?

List headlines returns stories in the order shown on the section page.

### Which CNBC articles mention a topic?

Search news finds CNBC-published articles by keyword, with optional publication dates, sort order, and pagination.

### What market levels and changes are reported?

Get market snapshot returns levels and changes for major stock indexes and U.S. futures.

## Related

- [CNN API](https://fous.com/workflows/cnn.md): CNN provides section-page headlines and searchable public articles, plus article text; subscriber stories show only a brief public preview, and live blogs include entries.
- [The Wall Street Journal API](https://fous.com/workflows/the-wall-street-journal.md): The Wall Street Journal provides news-section headlines and searchable public article headlines and summaries, with available story details and publication dates for search filtering.
- [Fox News API](https://fous.com/workflows/fox-news.md): Fox News returns section-page headlines, keyword-matched articles among up to 100 available results, and readable article text, including the latest live-blog updates.
- [AP News API](https://fous.com/workflows/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [TechCrunch API](https://fous.com/workflows/techcrunch.md): TechCrunch returns latest section headlines, keyword search results of up to 50 articles per page, public article text with available live updates, and recent startup funding stories with clearly announced amounts.
- [The New York Times API](https://fous.com/workflows/the-new-york-times.md): The New York Times provides current section headlines and summaries, keyword-matched public listings with dates, authors, sections and links, and Best Sellers lists for the latest issue or dates within a week.
- [NPR API](https://fous.com/workflows/npr.md): NPR returns displayed section headlines, searchable articles with summaries and publication details, and available article text; date-filtered searches may miss older stories edited much later.
- [Reuters API](https://fous.com/workflows/reuters.md): Reuters provides international news and reporting, with latest section headlines and keyword search; coverage and article details may be limited by access restrictions and news indexing.
- [All News workflows](https://fous.com/workflows/category/news)