# 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/workflows/fox-news
- Handle: `@fox-news`
- Category: [News](https://fous.com/workflows/category/news)
- Source website: https://foxnews.com
- Last verified: Sep 28, 2026
- Fous is not affiliated with Fox News.

## Methods

### List headlines

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

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 call.

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 call.

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

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": "@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.
# 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\": \"@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=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": "@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);
```

Or describe the data in plain language: send `{"api":"@fox-news","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 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

### Is Fous affiliated with Fox News?

No. Fous is not affiliated with Fox News. This workflow reads the public foxnews.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 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/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/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.
- [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.
- [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.
- [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.
- [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.
- [Yahoo News API](https://fous.com/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/news)