Docs menu
The Motley Fool API endpoint
The Motley Fool article API
Returns one Motley Fool investing article by `url`, which must look like `https://www.fool.com/investing/YYYY/MM/DD/slug/`; only public `/investing/` URLs are accepted. The response has the title, description, section, authors, publication and update times, image URL, body `paragraphs` and a `paywalled` flag.
GETapiKey2 credits/requestThe Motley Foolpublicnews.articleResponseDoc
The Motley Fool/motleyfool/articleEndpoint facts
- Method
- GET
- API path
- /motleyfool/article
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- The Motley Fool
- Response schema
- #/definitions/publicnews.articleResponseDoc
How this endpoint behaves
Parameters:
url(required): canonical Fool investing article URL in the formhttps://www.fool.com/investing/YYYY/MM/DD/slug/.x-api-keyheader (required).
Returns NewsArticle metadata and public paragraph text extracted from
#article-body. Only public /investing/ article URLs are accepted.
Workflow check
Start from the checked request: GET /motleyfool/article?url=https%3A%2F%2Fwww.fool.com%2Finvesting%2F2026%2F09%2F28%2Ffinancial-stock-great-business-bad-investment-how%2F. Live check on 2026-10-14: one record. Fields present in every checked record: url, title, description, published_at, updated_at, authors, image_url, paragraphs.
For a known public contributor profile, continue with Get a Motley Fool author profile.
Live monitoring
- Monitored request
- GET /motleyfool/article?url=https%3A%2F%2Fwww.fool.com%2Finvesting%2F2026%2F09%2F28%2Ffinancial-stock-great-business-bad-investment-how%2F
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 3.55 s
Sampled response
- Request, 14 Oct 2026
- GET /motleyfool/article?url=https%3A%2F%2Fwww.fool.com%2Finvesting%2F2026%2F09%2F28%2Ffinancial-stock-great-business-bad-investment-how%2F
- Fields returned with a value
- 8
| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | fool.com |
| title | Has a value | 94 characters |
| description | Has a value | 92 characters |
| published_at | Has a value | 2026-09-28 |
| updated_at | Has a value | 2026-09-28 |
| authors | Has a value | 1 entry |
| image_url | Has a value | g.foolcdn.com |
| paragraphs | Has a value | 5 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical The Motley Fool investing article URL | https://www.fool.com/investing/2026/09/28/financial-stock-great-business-bad-investment-how/ | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/motleyfool/article?url=https%3A%2F%2Fwww.fool.com%2Finvesting%2F2026%2F09%2F28%2Ffinancial-stock-great-business-bad-investment-how%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
Illustrative JSON response shape
{
"code": 200,
"data": {
"url": "https://www.fool.com/investing/2026/09/28/financial-stock-great-business-bad-investment-how",
"title": "A Financial Stock Can Be a Great Business and a Bad Investment. Here's How to Tell Them Apart.",
"published_at": "2026-09-28T06:45:00Z",
"authors": [
"Neil Patel"
],
"paragraphs": [
"Before deciding to buy a stock, investors need to check two boxes."
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.articleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.ArticleResponse | No | ||||
| data.authors | array | No | ||||
| data.description | string | No | ||||
| data.image_url | string | No | ||||
| data.paragraphs | array | No | ||||
| data.paywalled | boolean | No | Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned. | |||
| data.published_at | string | No | ||||
| data.section | string | No | ||||
| data.title | string | No | ||||
| data.updated_at | string | No | ||||
| data.url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/article?url=https%3A%2F%2Fwww.fool.com%2Finvesting%2F2026%2F09%2F28%2Ffinancial-stock-great-business-bad-investment-how%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"