# MarketWatch Scraper (`publicmoney/marketwatch-scraper`) Actor

Extract MarketWatch top stories and real-time bulletins as structured news: headline, summary, byline, an ISO 8601 publication time, and the company tickers each story mentions. Export data, run via API, schedule and monitor runs, or integrate with other tools.

- **URL**: https://apify.com/publicmoney/marketwatch-scraper.md
- **Developed by:** [Public Money](https://apify.com/publicmoney) (Apify)
- **Categories:** Business
- **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

MarketWatch is the equities and macro desk in this fleet, not a crypto feed, and its bulletins carry market-moving headlines within minutes. This Actor turns them into structured records: headline, summary, byline and a real ISO 8601 timestamp, each tagged with the company tickers the story actually names, resolved against the SEC's own ticker file.

### What it does

- Covers **equities and macro** rather than crypto, so it pairs with the Yahoo, Nasdaq and CNBC Actors rather than the coin feeds.
- Reads the **bulletins feed**, which carries short market-moving headlines within minutes rather than finished articles.
- Resolves company tickers against the **SEC company ticker file**, so `mentionedTickers` maps to real registrants rather than guesses.
- Tags **which assets each story is about** in `mentionedTickers`, resolved against a live CoinGecko coin list and the SEC company ticker file rather than a hardcoded table, with a guard so an ordinary word like "optimism" does not ship `OP` as a mention.
- Converts the feed's RFC 822 date to a real **ISO 8601 `datePublished`**, so stories sort and filter correctly instead of arriving as "Sat, 06 Sep 2026 05:30:00 GMT" strings.
- Returns the **summary body** in `articleBody`, decoded from the feed's HTML entities, so a headline arrives with enough context to classify without a second fetch.
- Carries the feed's own `guid`, so a scheduled run can drop stories it has already seen instead of reprocessing the whole feed.

### Use cases

| You need to | How this Actor does it |
| --- | --- |
| Alert on a holding | Filter `mentionedTickers` against your portfolio and push to Slack on a match |
| Watch the tape | Read the `bulletins` feed on a short schedule for market-moving headlines |
| Join a headline to a price move | Run the Yahoo Finance or Nasdaq Actor on the same schedule and match on ticker |
| Build a news timeline for a company | Accumulate runs and group by `mentionedTickers` and `datePublished` |
| Feed a finance agent | Call the Actor over MCP and let the model read the day's headlines |
| Deduplicate a feed | Key your store on `guid` and only process what is new |

### Quick start

1. Click **Try for free**.
2. Leave **Feeds** on `topstories` and `bulletins`, the two that are still updated. `marketpulse` and `realtimeheadlines` are served but no longer maintained.
3. Set **Articles per feed** to control how many stories come back.
4. Click **Start**. Rows appear within seconds.
5. Export as JSON, CSV, Excel or XML, or read the dataset over the API.

### Input

| Field | Type | Default | What it controls |
| --- | --- | --- | --- |
| `feeds` | array | `topstories, bulletins` | Which MarketWatch feeds to read. `topstories` and `bulletins` are live; `marketpulse` and `realtimeheadlines` are still served but Dow Jones stopped adding to them in 2025 |
| `articlesPerFeed` | integer | `50` | How many stories each feed returns, counted from the newest |
| `maxItems` | integer | `0` | Caps how many records are written. `0` writes them all |

```json
{
    "articlesPerFeed": 50,
    "maxItems": 0
}
```

### Output

One dataset item per story. Fields the feed does not carry for a story are dropped rather than returned as `null`, so a story with no byline carries no `author`.

| Field group | Fields |
| --- | --- |
| Story | `status`, `headline`, `articleBody`, `url`, `guid` |
| Attribution | `publisher`, `author`, `categories`, `feed` |
| Assets | `mentionedTickers` |
| Timing | `datePublished`, `scrapedAt` |

```json
{
    "status": "ok",
    "headline": "Fed holds rates, signals one cut before year end",
    "articleBody": "The decision was unanimous, with the statement pointing to cooling wage growth.",
    "publisher": "MarketWatch",
    "author": "Greg Robb",
    "categories": [],
    "feed": "bulletins",
    "mentionedTickers": [
        "SPY"
    ],
    "datePublished": "2026-09-06T05:30:00.000Z",
    "scrapedAt": "2026-09-06T06:02:11.418Z",
    "url": "https://www.marketwatch.com/story/fed-holds-rates-signals-one-cut"
}
```

### Integrations

Run it over the API and get the rows back in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/publicmoney~marketwatch-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"articlesPerFeed": 50, "maxItems": 0}'
```

From Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("publicmoney/marketwatch-scraper").call(run_input={"articlesPerFeed": 50, "maxItems": 0})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["headline"])
```

Give an AI agent the Actor over MCP:

```json
{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com/?actors=publicmoney/marketwatch-scraper"
        }
    }
}
```

Schedules run it on any cron, webhooks fire when a run finishes, and platform integrations push the
dataset to Google Sheets, Slack, Airtable, Zapier or your own endpoint.

### Cost

Pay per event, so you pay for records rather than compute time.

| Event | Free tier | Top volume tier |
| --- | --- | --- |
| News article | $0.002 | $0.0007 |
| Actor start | $0.00005 per GB | Same |

A record that returned no data is published as a failure row and is **never charged**. Six volume tiers apply, so the per-record price falls with monthly volume.

### Troubleshooting

| Issue | Solution |
| --- | --- |
| Every story returns `failed` | The MarketWatch feed was unreachable on that run. It is a public endpoint, so this is usually transient. Check the log and rerun. |
| `marketpulse` or `realtimeheadlines` returns nothing new | Dow Jones stopped adding to those two in 2025. They still serve, so old items come back, but use `topstories` and `bulletins` for current coverage. |
| Stories carry no `categories` | MarketWatch does not tag its feed items the way the crypto publications do. Use `feed` and `mentionedTickers` to route instead. |
| `mentionedTickers` is empty on a story that clearly names an asset | The ticker index is resolved live and a story that names a company only in prose, with no cashtag and no bracketed symbol, will not match. An index that fails to load leaves the field empty rather than failing the run, so check the log. |
| A scheduled run returns stories I already have | The feed carries a rolling window, so each run sees recent stories again. Deduplicate on `guid`, which is stable per story. |
| `articleBody` is a summary, not the full article | That is what the feed publishes. This Actor does not fetch the article page, so you get the headline, the summary and the link. |

### FAQ

#### Does MarketWatch have an API?

No public API. MarketWatch is a Dow Jones title and its data is sold through Dow Jones, while the syndication feeds are open, which is what this Actor reads.

#### Is this a stock news API?

It is the closest thing to one here: MarketWatch headlines with the company tickers each story names, resolved against the SEC ticker file. For per-symbol news pages use the Yahoo Finance, Nasdaq or Finviz Actor in this fleet.

#### Which feeds are still updated?

`topstories` and `bulletins`. `marketpulse` and `realtimeheadlines` are still served but Dow Jones stopped adding to them in 2025, so treat them as an archive.

#### How does it know which assets a story is about?

It resolves cashtags and bracketed symbols in the headline and body against a live CoinGecko coin list and the SEC company ticker file. Both are fetched per run rather than hardcoded, so new listings resolve without an Actor update, and there is a guard against common words that happen to be tickers.

#### Does it return the full article text?

No. It returns what the feed publishes: headline, summary body, author, categories, link and date. Fetching and republishing full articles is a copyright question, so the Actor gives you the metadata and the URL.

#### Do I need a MarketWatch API key?

No. MarketWatch publishes its feed openly and this Actor reads it, so there is no MarketWatch credential anywhere. You need an Apify token to call the Actor over the API.

#### Can I get this data in Python?

Yes, with the `apify-client` package as shown above. It returns parsed JSON, so there is no HTML or response handling on your side.

#### Can I get the data into Excel or Google Sheets?

Yes. Export the dataset as XLSX or CSV, or connect the Google Sheets integration so each run appends to a sheet.

#### Can an AI agent call this Actor?

Yes. Add it to an MCP client with the config above and the model can request what it needs on its own. Every record is flat JSON with named fields, so no post-processing is needed.

#### Is it legal to scrape MarketWatch?

This Actor reads MarketWatch's own public feed, which the publisher publishes for syndication, and returns headline, summary, byline and link rather than full article text. Republishing the text of an article is a copyright question and is your responsibility, so take your own legal advice for how you use it.

### Changelog

- **0.0.2** Added the bulletins feed and mentioned-ticker resolution against the SEC ticker file.
- **0.0.1** First release. MarketWatch headlines as structured records.

### Feedback

Found a field MarketWatch publishes that this Actor misses, or an input it rejects? Open an issue on the Issues tab with the input and what you expected. A daily test runs every Actor in the fleet against live sources, so parser fixes ship fast.

# Actor input Schema

## `feeds` (type: `array`):

Which MarketWatch feeds to read, one per line. Top stories and bulletins are the two that are still updated, and bulletins carries short market-moving headlines within minutes. Market pulse and real-time headlines are still served but Dow Jones stopped adding to them in 2025, so treat them as an archive. Examples: 'topstories', 'bulletins'. Default is 'topstories', 'bulletins'.

## `articlesPerFeed` (type: `integer`):

How many stories to return per feed, newest first. The feed carries a rolling window, so a value above what it holds returns everything available. Examples: 10, 50, 100. Default is 50.

## `maxItems` (type: `integer`):

Maximum number of stories to read, counted from the top of the list. Use it to cap spend on a long list without editing the list itself. Examples: 10, 50, 200. Default is 0, which reads every story given.

## Actor input object example

```json
{
  "feeds": [
    "topstories",
    "bulletins"
  ],
  "articlesPerFeed": 50,
  "maxItems": 0
}
```

# Actor output Schema

## `results` (type: `string`):

One item per requested input, in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "feeds": [
        "topstories",
        "bulletins"
    ],
    "articlesPerFeed": 50,
    "maxItems": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("publicmoney/marketwatch-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "feeds": [
        "topstories",
        "bulletins",
    ],
    "articlesPerFeed": 50,
    "maxItems": 0,
}

# Run the Actor and wait for it to finish
run = client.actor("publicmoney/marketwatch-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "feeds": [
    "topstories",
    "bulletins"
  ],
  "articlesPerFeed": 50,
  "maxItems": 0
}' |
apify call publicmoney/marketwatch-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,publicmoney/marketwatch-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nnWHBYICUtx4FjeWs/builds/gX5ylX8e9UvCzT0xV/openapi.json