# Fox News API: List headlines

> Lists Fox News article headlines in the order shown on a news section page. Video-only items, ads and promotions are left out.

Unofficial. Not affiliated with or endorsed by Fox News.

- Page: https://fous.com/methods/foxnews.com/list-headlines
- Method: `foxnews.com/list_headlines`, version 1
- Website: foxnews.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 politics. One of "top stories", "U.S.", "politics", "world", "opinion", "entertainment", "health", "lifestyle". Default "top stories". |
| `max_results` | integer | no | `3` | Maximum number of article headlines to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026. Its input:

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

Its output:

```json
{
  "stories": [
    {
      "authors": [
        "Paul Steinhauser"
      ],
      "section": "Politics",
      "summary": "Katie Zacharia lasted just five days in the role, making her the shortest-serving White House press secretary in US history",
      "headline": "Leavitt opens up on helping Trump find new press secretary after Zacharia debacle: 'Was not for her'",
      "image_link": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/01/1280/720/karoline-leavitt-press-briefing.jpg?ve=1&tl=1",
      "article_link": "https://www.foxnews.com/politics/leavitt-opens-helping-trump-find-new-press-secretary-zacharia-debacle-wasnt-her",
      "published_at": "2026-10-22T11:07:32-04:00"
    },
    {
      "authors": [
        "Andrew Miller",
        "Robert Schmad"
      ],
      "section": "Politics",
      "summary": "Michael Bicksel argues Slotkin's 'deterrence message' aimed to frighten young conservatives away from government service",
      "headline": "Slotkin's viral 'threat' to conservatives takes new twist as student moves to hold her accountable: 'Shocking'",
      "image_link": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/01/1280/720/elissa-slotkin-senator-democrat-2025.jpg?ve=1&tl=1",
      "article_link": "https://www.foxnews.com/politics/slotkins-viral-threat-conservatives-takes-new-twist-student-moves-hold-her-accountable-shocking",
      "published_at": "2026-10-22T11:29:11-04:00"
    },
    {
      "authors": [
        "Elizabeth Elkind"
      ],
      "section": "Politics",
      "summary": "Obama-appointed Judge Kathleen Williams imposed sanctions after Trump voluntarily dismissed his $10B IRS lawsuit",
      "headline": "Obama-appointed judge at center of Trump's anti-weaponization fund case hit with misconduct claim",
      "image_link": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/10/1280/720/president-donald-trump-october-13-2026-scaled.jpg?ve=1&tl=1",
      "article_link": "https://www.foxnews.com/politics/obama-appointed-judge-center-trumps-anti-weaponization-fund-case-hit-misconduct-claim",
      "published_at": "2026-10-22T10:30:57-04: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":"foxnews.com/list_headlines","input":{"section":"politics","max_results":3}}'
```

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

- Show me the latest headlines from the politics section, about 15 of them.
- What are the top stories right now? Give me 30 headlines with their summaries.
- I need the newest opinion pieces from Fox News, up to 10 with authors and publish times.
- List 25 headlines from the health section along with article links.
- Pull the most recent world news headlines, maximum 40, including section and image links.

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "section": {
      "enum": [
        "top stories",
        "U.S.",
        "politics",
        "world",
        "opinion",
        "entertainment",
        "health",
        "lifestyle"
      ],
      "type": "string",
      "default": "top stories",
      "description": "News section to read, for example politics."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of article headlines to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "stories"
  ],
  "properties": {
    "stories": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "headline",
          "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"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [Fox News API: Search articles](https://fous.com/methods/foxnews.com/search-news.md): Searches Fox News articles by keyword, with date filtering, ordering and pagination, over the first 100 matches.
- [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.
- [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them.
- [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.
- [CNBC API: List headlines](https://fous.com/methods/cnbc.com/list-headlines.md): Lists CNBC article headlines in the order they appear on a public news section page, with summary, time, authors and image.
- [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.
- [AP News API: List headlines](https://fous.com/methods/apnews.com/list-headlines.md): Lists AP News headlines in the order shown on a public section page, up to 50 stories. Author credits and the article section are added for the first 20 articles only.
- [The Verge API: List headlines](https://fous.com/methods/theverge.com/list-headlines.md): Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.
- [All Fox News methods](https://fous.com/methods/foxnews.com.md)
