API Reference
Get MarketWatch's public section list, site-wide and per-section headlines, and full public article content as structured JSON. 5 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/marketwatch/article?url=https%3A%2F%2Fwww.marketwatch.com%2Fstory%2Fexample" \
-H "x-api-key: $CRAWLORA_API_KEY"MarketWatch's Top Stories RSS feed runs same-day — on 2026-09-22 it led with MIT ending Princeton's 15-year run atop the U.S. News college rankings — but its markets section reads a separate marketpulse RSS feed that, on the same day, surfaced stories dated as far back as June 2024. Crawlora's four endpoints return MarketWatch's eight sections, the current feed, per-section headlines, and articles as normalized JSON.
/marketwatch/sections returns the full 8-slug list /marketwatch/headlines accepts — latest-news, markets, investing, personal-finance, economy-politics, technology, retirement, and real-estate.
/marketwatch/news reads MarketWatch's public Top Stories RSS feed. Its 2026-09-22 lead — MIT displacing Princeton at No. 1 in the U.S. News rankings — was filed under the Personal Finance section at 04:02 UTC, not Markets or Latest News.
Pass a slug from /marketwatch/sections to /marketwatch/headlines. The markets slug parses a separate marketpulse RSS feed rather than the section web page; on 2026-09-22 that feed's most recent entries were still dated between mid-2024 and mid-2025, so /marketwatch/news is the better source for same-day markets news.
Pass a canonical marketwatch.com/story/... URL to /marketwatch/article for title, author, section, and body paragraphs. The college-rankings piece above, bylined Jillian Berman, was tagged section: Personal Finance despite its markets-adjacent subject.
/marketwatch/articleapiKey2 credits/requestReturns a MarketWatch article by `url`, a canonical HTTPS article link. The response has the title, description, section, authors, lead image, publish and update times, body `paragraphs` and a `paywalled` flag. Subscriber-only or blocked articles return an upstream error, so some URLs may fail.
Required: url.
/marketwatch/authorapiKey2 credits/requestReturns a MarketWatch author profile, identified by `slug` (such as `hannah-pedone`) or a canonical `marketwatch.com/author/<slug>` `url`; provide exactly one. The response has the name, job title, bio, `works_for` and one page of recent articles with title and URL. The `?mod=` attribution query is removed from article URLs.
Optional: slug, url.
Sampled 14 Oct 2026: 20 items. Filled in every item: title, url. In the sample: url: marketwatch.com.
/marketwatch/headlinesapiKey1 credit/requestReturns current MarketWatch headlines for one section. `section` is required and takes `latest-news`, `markets`, `investing`, `personal-finance`, `economy-politics`, `technology`, `retirement` or `real-estate`. Each item has its title, URL, summary, author, publication time and image where available.
Required: section (8 allowed values: latest-news, markets, investing, personal-finance, economy-politics, technology, retirement, real-estate).
Sampled 14 Oct 2026: 30 items. Filled in every item: title, url, published_at, author. In the sample: published_at: 2024-06-05 to 2025-07-03; url: marketwatch.com; title: median 64 characters.
/marketwatch/newsapiKey1 credit/requestReturns MarketWatch's current top stories, with no parameters. Each item has its title, URL, summary, author, publication time and image where available. Use `marketwatch-headlines` to read a single section instead.
Takes no parameters.
Sampled 14 Oct 2026: 10 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-13; url: marketwatch.com; title: median 97 characters; summary: median 105 characters; image_url: images.mktw.net.
/marketwatch/sectionsapiKey1 credit/requestLists the eight MarketWatch sections accepted by `marketwatch-headlines`: `latest-news`, `markets`, `investing`, `personal-finance`, `economy-politics`, `technology`, `retirement` and `real-estate`. Each entry has a `slug`, display `name` and section `url`.
Takes no parameters.
Sampled 14 Oct 2026: 8 items. Filled in every item: slug, name, url. In the sample: name: “Latest News” and 7 other values; url: marketwatch.com and 1 other host.