# CNBC API: List headlines

> Lists CNBC article headlines in the order they appear on a public news section page, with summary, time, authors and image.

Unofficial. Not affiliated with or endorsed by CNBC.

- Page: https://fous.com/methods/cnbc.com/list-headlines
- Method: `cnbc.com/list_headlines`, version 1
- Website: cnbc.com
- Returns: headline, summary, published time, authors, section, image link, article link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `section` | string | no | `"politics"` | News section to read, for example tech. One of "top stories", "markets", "business", "investing", "tech", "politics", "personal finance", "economy". Default "top stories". |
| `max_results` | integer | no | `50` | Maximum stories to return, for example 20. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "section": "politics",
  "max_results": 50
}
```

Its output:

```json
{
  "stories": [
    {
      "authors": [
        "Garrett Downs"
      ],
      "section": "politics",
      "summary": null,
      "headline": "Khanna to introduce AI safety bill with ban on 'recursive' technology until safeguards exist",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108368847-1790610558721-gettyimages-2292801324-khanna_178_090326.jpeg?v=1790610581",
      "article_link": "https://www.cnbc.com/2026/09/28/khanna-ai-safety-bill.html",
      "published_at": "2026-09-28T21:43:40+00:00"
    },
    {
      "authors": [
        "Dan Mangan"
      ],
      "section": "politics",
      "summary": null,
      "headline": "Supreme Court Justice Alito won't participate in big climate change case next week",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108328727-1782831495932-108328727-1782831415459-gettyimages-2278340792-supreme_court_2206.jpg?v=1782831504",
      "article_link": "https://www.cnbc.com/2026/09/28/supreme-court-justice-alito-recusal-climate-change-case.html",
      "published_at": "2026-09-28T18:58:47+00:00"
    },
    {
      "authors": [
        "Dan Mangan"
      ],
      "section": "politics",
      "summary": null,
      "headline": "Feds can't withhold counterterrorism funds to force election admin changes: Judge",
      "image_link": "https://image.cnbcfm.com/api/v1/image/108315203-1780408967315-gettyimages-2278723586-sm1_5165.jpeg?v=1780409020",
      "article_link": "https://www.cnbc.com/2026/09/28/elections-dhs-counterterrorism.html",
      "published_at": "2026-09-28T18:41:51+00:00"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"cnbc.com/list_headlines","input":{"section":"politics","max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the latest headlines on CNBC's tech page right now? Give me the top 10 with summaries and authors.
- Pull the current markets news stories from CNBC, up to 25, including publish times and links.
- Show me today's top business news headlines with a short summary and who wrote each one.
- I need the 5 most recent personal finance articles, with image links and article URLs, for a newsletter roundup.
- List the economy news stories currently featured, max 40, with section, timestamp, and byline for each.

## 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."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum stories to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "stories"
  ],
  "properties": {
    "stories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "summary",
          "published_at",
          "authors",
          "section",
          "image_link",
          "article_link"
        ],
        "properties": {
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "section": {
            "type": "string"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "headline": {
            "type": "string"
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "article_link": {
            "type": "string"
          },
          "published_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publication date and time in ISO 8601 with offset."
          }
        }
      },
      "description": "CNBC stories in the order shown on the section page."
    }
  }
}
```

## See more

- [CNBC API: Search articles](https://fous.com/methods/cnbc.com/search-news.md): Searches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases.
- [CNBC API: Get market snapshot](https://fous.com/methods/cnbc.com/get-market-snapshot.md): Returns 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.
- [wsj.com API: List Wall Street Journal section headlines](https://fous.com/methods/wsj.com/list-headlines.md): Lists the headlines shown in a Wall Street Journal news section (top stories, business, markets, tech, economy, world, politics or personal finance) with summaries, bylines, dates, images and story links.
- [TechCrunch API: List headlines](https://fous.com/methods/techcrunch.com/list-headlines.md): Lists the latest TechCrunch story headlines in a section, in page order. Skips video, podcast and event promotion cards.
- [CNN API: List headlines by section](https://fous.com/methods/cnn.com/list-headlines.md): Lists CNN headlines in the order shown on a chosen news section page (top stories, US, world, politics, business, health, entertainment or science), with each story's summary, publication time, authors and image when available. Promotions and video-only items are left out.
- [Fox News API: List headlines](https://fous.com/methods/foxnews.com/list-headlines.md): Lists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.
- [NPR API: List headlines](https://fous.com/methods/npr.org/list-headlines.md): Lists the headlines on an NPR section page in page order, with summaries, publication times, authors, images and article links.
- [BBC News API: List headlines](https://fous.com/methods/bbc.com/list-headlines.md): Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
- [All CNBC methods](https://fous.com/methods/cnbc.com.md)
