# Fox News API

> Fox News provides headlines, searchable articles, and readable article text as a workflow and API.

Fox News lists article headlines from a selected news section; choose a section and maximum number of results. Search news finds articles matching required keywords, with optional date range, ordering, page, and result count. Read article returns details and readable text for one article, using its link or headline.

- Page: https://fous.com/tools/fox-news
- Handle: `@fox-news`
- Category: [News](https://fous.com/tools/category/news)
- Source website: https://foxnews.com
- Last verified: Sep 28, 2026

## Methods

### List headlines

Operation `list_headlines`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List Fox News article headlines in the order shown on the selected news section page. Excludes video-only items, ads and promotions.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `section` | string | no | `"politics"` | News section to read, for example politics. |
| `max_results` | integer | no | `3` | Maximum number of article headlines to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "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.",
      "examples": [
        "politics",
        "world",
        "top stories"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of article headlines to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3,
        20
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "section": "politics",
      "max_results": 3
    },
    {
      "section": "world",
      "max_results": 20
    },
    {
      "section": "top stories"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  | Article headlines in the order they appear on the section page. |
| `stories[].authors` | array |  |  |
| `stories[].section` | string | `"Politics"` |  |
| `stories[].summary` | string or null | `"Critics call the New York mayor's 'Opera for All' lottery a case of misplaced priorities"` |  |
| `stories[].headline` | string | `"Mamdani's latest freebie sets off online fury as critics rip city priorities: 'Opera socialism'"` |  |
| `stories[].image_link` | string or null | `"https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/02/1280/720/mamdani-snow-shoveling-cnn.jpg?` |  |
| `stories[].article_link` | string | `"https://www.foxnews.com/politics/mamdanis-latest-freebie-sets-off-online-fury-critics-rip-city-priorities-opera-sociali` |  |
| `stories[].published_at` | string or null | `"2026-09-28T14:00:12-04:00"` | Published time with timezone when available. |

**Example input**

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

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Kiera McDonald",
        "Andrew Miller"
      ],
      "section": "Politics",
      "summary": "Critics call the New York mayor's 'Opera for All' lottery a case of misplaced priorities",
      "headline": "Mamdani's latest freebie sets off online fury as critics rip city priorities: 'Opera socialism'",
      "image_link": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/02/1280/720/mamdani-snow-shoveling-cnn.jpg?ve=1&tl=1",
      "article_link": "https://www.foxnews.com/politics/mamdanis-latest-freebie-sets-off-online-fury-critics-rip-city-priorities-opera-socialism",
      "published_at": "2026-09-28T14:00:12-04:00"
    },
    {
      "authors": [
        "Ashley DiMella"
      ],
      "section": "Politics",
      "summary": "The 10-week program limits participation to immigrants, including non-U.S. citizens, drawing criticism online",
      "headline": "Blue city funds immigrant activist program with taxpayer dollars, critics say it 'shuts citizens out'",
      "image_link": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2026/02/1280/720/boston-mayor-wu-ice-body-camera-footage-release-002.jpg?ve=1&tl=1",
      "article_link": "https://www.foxnews.com/politics/blue-city-funds-immigrant-activist-program-taxpayer-dollars-critics-say-shuts-citizens",
      "published_at": "2026-09-28T11:47:47-04:00"
    }
  ]
}
```

### Read article

Operation `read_article`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the details and full readable text of one Fox News article by link or headline. For a headline, returns the best search match; live blogs include their latest updates.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `article` | string | yes | `"https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot"` | The Fox News article link or headline, for example: In-laws arrested after New York Times Games engineering director found fatally shot. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "The Fox News article link or headline, for example: In-laws arrested after New York Times Games engineering director found fatally shot.",
      "examples": [
        "https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot",
        "https://www.foxnews.com/live-news/iran-war-strait-of-hormuz-donald-trump-09-27-26",
        "In-laws arrested after New York Times Games engineering director found fatally shot"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "article": "https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot"
    },
    {
      "article": "https://www.foxnews.com/live-news/iran-war-strait-of-hormuz-donald-trump-09-27-26"
    },
    {
      "article": "In-laws arrested after New York Times Games engineering director found fatally shot"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `tags` | array |  |  |
| `authors` | array |  |  |
| `section` | string or null | `"U.S."` |  |
| `summary` | string or null | `"Authorities said witnesses helped officers quickly detain McKinsey's in-laws after the fatal shooting"` |  |
| `headline` | string | `"In-laws arrested after New York Times Games engineering director found fatally shot"` |  |
| `article_id` | string or null | `"28a4a6aa-4e64-5207-b4ee-b4a423dd1ff3"` |  |
| `paragraphs` | array |  |  |
| `updated_at` | string or null | `"2026-09-28T18:00:06-04:00"` | Last updated date and time in ISO 8601 with offset. |
| `word_count` | integer | `405` |  |
| `article_url` | string | `"https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot"` |  |
| `published_at` | string or null | `"2026-09-28T15:36:21-04:00"` | Publication date and time in ISO 8601 with offset. |
| `main_image_url` | string or null | `"https://static.foxnews.com/foxnews.com/content/uploads/2026/09/jon-mckinsey-nyt-exec.jpg"` |  |
| `main_image_caption` | string or null | `"A New York Times spokesperson confirmed to Fox News Digital that Jonathan McKinsey served as director of engineering fo` |  |
| `full_text_available` | boolean | `true` |  |

**Example input**

```json
{
  "article": "https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot"
}
```

**Example output**

```json
{
  "tags": [
    "crime world",
    "us",
    "california"
  ],
  "authors": [
    "Sophia Compton"
  ],
  "section": "U.S.",
  "summary": "Authorities said witnesses helped officers quickly detain McKinsey's in-laws after the fatal shooting",
  "headline": "In-laws arrested after New York Times Games engineering director found fatally shot",
  "article_id": "28a4a6aa-4e64-5207-b4ee-b4a423dd1ff3",
  "paragraphs": [
    "Jonathan McKinsey, a New York Times Games engineering executive, was shot and killed Saturday afternoon in Dublin, California, and his wife's parents were arrested on suspicion of murder within minute…",
    "McKinsey, 40, was found with multiple gunshot wounds in the parking lot of the Dublin Sports Grounds and was pronounced dead at the scene, according to the City of Dublin.",
    "A New York Times spokesperson confirmed to Fox News Digital that McKinsey served as director of engineering for New York Times Games. He had worked for the company since January 2023."
  ],
  "updated_at": "2026-09-28T18:00:06-04:00",
  "word_count": 405,
  "article_url": "https://www.foxnews.com/us/parents-in-law-arrested-after-new-york-times-games-engineering-director-found-fatally-shot",
  "published_at": "2026-09-28T15:36:21-04:00",
  "main_image_url": "https://static.foxnews.com/foxnews.com/content/uploads/2026/09/jon-mckinsey-nyt-exec.jpg",
  "main_image_caption": "A New York Times spokesperson confirmed to Fox News Digital that Jonathan McKinsey served as director of engineering for New York Times Games. He had worked for the company since January 2023. (Jon Mc…",
  "full_text_available": true
}
```

### Search news

Operation `search_news`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Fox News articles by keyword, with date filtering, ordering, and pagination. Searches up to the first 100 matches available from Fox News.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Result page number, such as 2. |
| `sort` | string | no | `"most_relevant"` | Order results by newest date or search relevance, such as newest. |
| `query` | string | yes | `"NASA"` | Words to search for, such as Tesla. |
| `to_date` | string | no | `"2026-09-28"` | Last publication date to include, such as 2026-09-28. |
| `from_date` | string | no | `"2026-09-01"` | First publication date to include, such as 2026-09-01. |
| `max_results` | integer | no | `2` | 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 number, such as 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Order results by newest date or search relevance, such as newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to search for, such as Tesla.",
      "examples": [
        "NASA",
        "Tesla"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Last publication date to include, such as 2026-09-28.",
      "examples": [
        "2026-09-28"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "First publication date to include, such as 2026-09-01.",
      "examples": [
        "2026-09-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum articles per page, such as 20.",
      "x-fous-developer": true,
      "examples": [
        2,
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "NASA",
      "max_results": 2
    },
    {
      "query": "Tesla",
      "max_results": 3
    },
    {
      "query": "Tesla",
      "to_date": "2026-09-28",
      "from_date": "2026-09-01",
      "max_results": 2
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].authors` | array |  |  |
| `articles[].section` | string or null | `"U.S."` |  |
| `articles[].summary` | string or null | `"Jared Isaacman says NASA has captured imagery of unknown objects it cannot explain as Trump pushes broader UAP declassi` |  |
| `articles[].headline` | string | `"NASA chief confirms agency has unexplained UFO imagery: 'We don't know what it is'"` |  |
| `articles[].article_link` | string | `"https://www.foxnews.com/us/nasa-chief-confirms-agency-unexplained-ufo-imagery-dont-know-what-it-is"` |  |
| `articles[].published_at` | string | `"2026-07-09T17:34:33-04:00"` |  |

**Example input**

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

**Example output**

```json
{
  "articles": [
    {
      "authors": [
        "Louis Casiano"
      ],
      "section": "U.S.",
      "summary": "Jared Isaacman says NASA has captured imagery of unknown objects it cannot explain as Trump pushes broader UAP declassification efforts forward.",
      "headline": "NASA chief confirms agency has unexplained UFO imagery: 'We don't know what it is'",
      "article_link": "https://www.foxnews.com/us/nasa-chief-confirms-agency-unexplained-ufo-imagery-dont-know-what-it-is",
      "published_at": "2026-07-09T17:34:33-04:00"
    },
    {
      "authors": [
        "Brittany Kasko"
      ],
      "section": "Lifestyle",
      "summary": "As many reflect on the year of 2023, NASA has released an array of remarkable images taken over the past 12 months. See the moments stood out in history.",
      "headline": "NASA headquarters releases its best photos from 2023: See the stunning pictures",
      "article_link": "https://www.foxnews.com/lifestyle/nasa-headquarters-releases-best-photos-see-stunning-pictures",
      "published_at": "2024-01-04T13:05:58-05:00"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@fox-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "politics",
    "max_results": 3
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@fox-news\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"section\": \"politics\",\n    \"max_results\": 3\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=180) 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.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@fox-news",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "politics",
    "max_results": 3
  },
  "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);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/fox-news`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `list_headlines`: List headlines. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `read_article`: Read article. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_news`: Search news. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-fox-news https://api.fous.com/mcp/tools/fox-news --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track headlines across selected news sections
- Find articles about a topic within a date range
- Compare article results by date or relevance
- Read an article’s full available text
- Review article authors, summaries, and publication times

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Fox News tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Fox News account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from foxnews.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.

### What are the latest headlines in a section?

Use List headlines with a section and maximum number of results to return headlines in the order shown on that section page.

### Which articles mention a topic?

Use Search news with a required keyword query; optionally set dates, ordering, page, and maximum results.

### Can I get the full text of an article?

Use Read article with an article link or headline. It returns readable text when available.

## Related

- [BBC News API](https://fous.com/tools/bbc-news.md): BBC News returns section-ordered headlines, searchable articles with dates, authors and sections (filters/newest sorting cover 180 matches), and article text with available latest live entries.
- [CNN API](https://fous.com/tools/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.
- [NPR API](https://fous.com/tools/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.
- [The Wall Street Journal API](https://fous.com/tools/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.
- [The New York Times API](https://fous.com/tools/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.
- [AP News API](https://fous.com/tools/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [Yahoo News API](https://fous.com/tools/yahoo-news.md): Yahoo News provides section headlines and searchable articles, plus public article text and details; health has no public stories, and search covers a limited results window.
- [CNBC API](https://fous.com/tools/cnbc.md): CNBC provides business news, page-view headlines, searchable CNBC articles excluding videos, wire stories and press releases, and potentially delayed major index and U.S. futures quotes.
- [All News tools](https://fous.com/tools/category/news)