# The Wall Street Journal API

> The Wall Street Journal workflow and API: headlines and news. Returns stories, authors, section and summary as JSON.

The Wall Street Journal data from wsj.com: headlines and news.

- Page: https://fous.com/tools/the-wall-street-journal
- Handle: `@the-wall-street-journal`
- Category: [News](https://fous.com/tools/category/news)
- Source website: https://wsj.com
- Last verified: Sep 29, 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 the headlines displayed in a Wall Street Journal news section, with available summaries, bylines, dates, images, and story links. Excludes ads, promotions, video-only items, and related or trending modules; some stories have no displayed date or summary.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `section` | string | no | `"top stories"` | News section to list, for example business. |
| `max_results` | integer | no | `20` | Maximum number of stories to return, for example 20. |

**Input schema**

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

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  |  |
| `stories[].authors` | array |  |  |
| `stories[].section` | string | `"Tech"` |  |
| `stories[].summary` | string or null | `"The model, known as GPT-6.1 Astra, was due to debut inside ChatGPT and Codex in October."` |  |
| `stories[].headline` | string | `"OpenAI Scraps Release of New AI Model Over Safety Concerns"` |  |
| `stories[].image_link` | string or null | `"https://images.wsj.net/im-33138169?size=1.5"` |  |
| `stories[].article_link` | string | `"https://www.wsj.com/tech/ai/openai-chatgpt-model-release-cancel-safety-5a2f9f42"` |  |
| `stories[].published_at` | string or null | `"2026-09-29T01:00:00+00:00"` | Published date and time with time zone, when available. |

**Example input**

```json
{
  "section": "top stories",
  "max_results": 20
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Maxwell Zeff"
      ],
      "section": "Tech",
      "summary": "The model, known as GPT-6.1 Astra, was due to debut inside ChatGPT and Codex in October.",
      "headline": "OpenAI Scraps Release of New AI Model Over Safety Concerns",
      "image_link": "https://images.wsj.net/im-33138169?size=1.5",
      "article_link": "https://www.wsj.com/tech/ai/openai-chatgpt-model-release-cancel-safety-5a2f9f42",
      "published_at": null
    },
    {
      "authors": [
        "Georgi Kantchev"
      ],
      "section": "World",
      "summary": "The erosion of Iran’s position comes as the U.S. Navy and Gulf oil producers have become better at fending off or evading Iranian attacks, allowing more tankers to cross the strait.",
      "headline": "Middle East Oil Exports Rebound as Iran’s Chokehold on Hormuz Breaks Down",
      "image_link": "https://images.wsj.net/im-26956664?size=1.78",
      "article_link": "https://www.wsj.com/world/middle-east/middle-east-oil-exports-rebound-as-irans-chokehold-on-hormuz-breaks-down-4ffde655",
      "published_at": null
    },
    {
      "authors": [
        "AnnaMaria Andriotis"
      ],
      "section": "Markets",
      "summary": "Under the plan, David Solomon, who has led the bank since 2018, would step down as soon as next year and be executive chair.",
      "headline": "Goldman’s Board Has Discussed a Plan to Name John Waldron as Its Next CEO",
      "image_link": "https://images.wsj.net/im-30810617?size=1.5",
      "article_link": "https://www.wsj.com/finance/banking/goldmans-board-has-discussed-a-plan-to-name-john-waldron-as-its-next-ceo-7c5d90dd",
      "published_at": null
    }
  ]
}
```

### 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 public Wall Street Journal article headlines and summaries by keyword. Includes publication time, authors, section, and link; excludes podcasts and live-coverage posts. Date filtering applies to publication dates.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Page of results, for example 1. |
| `sort` | string | no | `"newest"` | Sort results by newest or most relevant, for example newest. |
| `query` | string | yes | `"Tesla"` | Search words, for example Tesla. |
| `to_date` | string | no | `"2026-09-29"` | Latest publication date, for example 2026-09-29. |
| `from_date` | string | no | `"2026-09-01"` | Earliest publication date, for example 2026-09-01. |
| `max_results` | integer | no | `5` | Articles per page, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page of results, for example 1.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Sort results by newest or most relevant, for example newest.",
      "examples": [
        "newest",
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search words, for example Tesla.",
      "examples": [
        "Tesla",
        "Apple",
        "unlikelynonwordxyzzy2593847"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date, for example 2026-09-29.",
      "examples": [
        "2026-09-29"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date, for example 2026-09-01.",
      "examples": [
        "2026-09-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Articles per page, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "Tesla"
    },
    {
      "page": 2,
      "sort": "newest",
      "query": "Tesla",
      "to_date": "2026-09-29",
      "from_date": "2026-09-01",
      "max_results": 5
    },
    {
      "sort": "most_relevant",
      "query": "Apple",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].authors` | array |  |  |
| `articles[].section` | string or null | `"Real Estate"` |  |
| `articles[].summary` | string or null | `"The Oracle billionaire spent almost $10 million on houses for his children’s tutors and others about 30 minutes from hi` |  |
| `articles[].headline` | string | `"The Gated Community Where Larry Ellison Bought Eight Homes for His Staff"` |  |
| `articles[].article_link` | string | `"https://www.wsj.com/real-estate/luxury-homes/larry-ellison-oracle-gated-community-1831d914"` |  |
| `articles[].published_at` | string | `"2026-09-28T23:00:00+00:00"` |  |

**Example input**

```json
{
  "query": "Tesla"
}
```

**Example output**

```json
{
  "articles": [
    {
      "authors": [
        "Katherine Clarke",
        "Emily Glazer"
      ],
      "section": "Real Estate",
      "summary": "The Oracle billionaire spent almost $10 million on houses for his children’s tutors and others about 30 minutes from his Florida compound.",
      "headline": "The Gated Community Where Larry Ellison Bought Eight Homes for His Staff",
      "article_link": "https://www.wsj.com/real-estate/luxury-homes/larry-ellison-oracle-gated-community-1831d914",
      "published_at": "2026-09-28T23:00:00+00:00"
    },
    {
      "authors": [
        "Sharon Terlep"
      ],
      "section": "Autos Industry",
      "summary": "The new mandate will require an average of 34.5 miles a gallon by model year 2031, down from the 50.4 miles a gallon standard.",
      "headline": "Trump Administration Ends Tougher Fuel-Economy Rules",
      "article_link": "https://www.wsj.com/business/autos/trump-administration-ends-tougher-fuel-economy-rules-013c4633",
      "published_at": "2026-09-28T16:18:00+00:00"
    },
    {
      "authors": [
        "Andy Kessler"
      ],
      "section": "Opinion",
      "summary": "Liability is much more effective than regulation at pushing companies to be safe.",
      "headline": "The Real AI Fear: Lawyers",
      "article_link": "https://www.wsj.com/opinion/the-real-ai-fear-lawyers-69280f52",
      "published_at": "2026-09-27T15:15:00+00: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": "@the-wall-street-journal",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "top stories",
    "max_results": 20
  },
  "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\": \"@the-wall-street-journal\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"section\": \"top stories\",\n    \"max_results\": 20\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": "@the-wall-street-journal",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "section": "top stories",
    "max_results": 20
  },
  "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/the-wall-street-journal`
- 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.
- `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-the-wall-street-journal https://api.fous.com/mcp/tools/the-wall-street-journal --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.

## 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 The Wall Street Journal 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 The Wall Street Journal account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from wsj.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 29, 2026.

## Related

- [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.
- [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.
- [Fox News API](https://fous.com/tools/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.
- [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.
- [The Verge API](https://fous.com/tools/the-verge.md): The Verge provides technology, science, entertainment, and policy headlines and searchable articles, including public stories and older archives, with search limited to the first 100 matches.
- [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.
- [Al Jazeera API](https://fous.com/tools/al-jazeera.md): Al Jazeera provides news and analysis, current section headlines and article details, plus keyword-searchable articles; searches and live blogs may show only leading matches or latest updates.
- [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.
- [All News tools](https://fous.com/tools/category/news)