Docs menu
The Motley Fool API endpoint
The Motley Fool section headlines API
Returns the article cards of one Motley Fool investing-news section. `section` is required: `trending-news`, `news`, `market-movers`, `tech-stock-news`, `market-trends`, `crypto-news`, `markets`, `most-active-stocks`, `top-stock-gainers` or `top-stock-losers`. Other values return a 400. Items carry the title, URL and, where present, summary, author and publication time.
GETapiKey1 credit/requestThe Motley Foolpublicnews.headlinesResponseDoc
The Motley Fool/motleyfool/headlinesEndpoint facts
- Method
- GET
- API path
- /motleyfool/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- The Motley Fool
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Parameters:
section(required): one oftrending-news,news,market-movers,tech-stock-news,market-trends,crypto-news,markets,most-active-stocks,top-stock-gainers, ortop-stock-losers.x-api-keyheader (required).
Returns article cards from the selected public section. Invalid section slugs return a 400 invalid-parameter error.
Workflow check
Start from the checked request: GET /motleyfool/headlines?section=news. Live check on 2026-10-14: 19 items returned. Fields present in every checked item: title, url, image_url. Observed field variation: summary was populated in 18 of 19; published_at was populated in 18 of 19; author was populated in 18 of 19.
Resolve a returned canonical story URL with Get a Motley Fool article.
Live monitoring
- Monitored request
- GET /motleyfool/headlines?section=news
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 2.85 s
Sampled response
- Request, 14 Oct 2026
- GET /motleyfool/headlines?section=news
- Items in items
- 19
- Fields filled in every checked item
- 3
- Fields empty in some or all items
- 3
| Field | Filled in, of 19 checked | Values in the sample |
|---|---|---|
| title | 19 | median 67 characters |
| url | 19 | fool.com |
| image_url | 19 | g.foolcdn.com |
| summary | 18 | median 73 characters |
| published_at | 18 | 2026-10-13 to 2026-10-14 |
| author | 18 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | The Motley Fool section slug Allowed values: trending-news, news, market-movers, tech-stock-news, market-trends, crypto-news, markets, most-active-stocks, top-stock-gainers, top-stock-losers. | news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/motleyfool/headlines?section=news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"section": "news",
"items": [
{
"title": "Palantir's Stock Is Up Over 50% Since Reporting Earnings. Is It Heading for a New All-Time High?",
"url": "https://www.fool.com/investing/2026/09/28/palantir-s-stock-is-up-over-50-since-reporting-earnings-is-it-heading-for-a-new-all-time-high"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under The Motley Fool news API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/motleyfool/headlines?section=news" \
-H "x-api-key: $CRAWLORA_API_KEY"