fool.com APIfool.com ↗
Access Motley Fool stock data, OHLCV historical prices, analyst opinions, and full earnings call transcripts via 4 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/5488de9f-9850-451f-9ce5-6f1edcb43528/get_stock_data?symbol=AAPL' \ -H 'X-API-Key: $PARSE_API_KEY'
Get basic stock info, instrument ID, articles, and analyst opinions for a given stock symbol. Returns recent articles from the quote page and Motley Fool analyst opinions when available.
| Param | Type | Description |
|---|---|---|
| symbolrequired | string | Stock ticker symbol (e.g. AAPL, TSLA, MSFT) |
{
"type": "object",
"fields": {
"symbol": "string — stock ticker symbol",
"articles": "array of article objects with title, url, and path",
"transcripts": "array of transcript objects with title, url, and path (may be empty)",
"instrument_id": "integer — internal instrument ID for use with get_historical_prices, or null if not found",
"analyst_opinions": "object with source and rating fields when available"
},
"sample": {
"data": {
"symbol": "AAPL",
"articles": [
{
"url": "https://www.fool.com/investing/2026/05/01/apple-earnings-this-important-high-margin-segment/",
"path": "/investing/2026/05/01/apple-earnings-this-important-high-margin-segment/",
"title": "Apple Earnings This Important High Margin Segment"
}
],
"transcripts": [],
"instrument_id": 202686,
"analyst_opinions": {
"rating": "Buy",
"source": "Motley Fool Stock Advisor"
}
},
"status": "success"
}
}About the fool.com API
The Motley Fool API provides 4 endpoints covering stock lookup, historical OHLCV price bars, analyst opinions, and complete earnings call transcripts sourced from fool.com. Starting with get_stock_data or search_stocks, you retrieve a symbol's instrument ID and linked articles, then feed that ID into get_historical_prices to pull chart data across timeframes from one week to the full available history.
Stock Lookup and Analyst Opinions
get_stock_data and search_stocks both accept a ticker symbol (e.g. AAPL, TSLA) and return the same response shape: a symbol string, an instrument_id integer, an articles array of objects with title, url, and path, a transcripts array with the same structure, and an analyst_opinions object containing source and rating fields when Motley Fool has published a rating for that stock. The instrument_id field is required by the historical prices endpoint, so stock lookup is typically the first step in any workflow.
Historical Price Data
get_historical_prices accepts a numeric instrument_id string, an optional precision parameter (Day, Hour, or Minute), and an optional timeframe parameter (OneWeek, OneMonth, OneYear, FiveYears, or Max). It returns a ChartBars array where each bar object includes PricingDate, Open, Close, High, Low, and Volume. The response also includes company-level metadata: Name, Symbol, a Currency object (Id, Name, Symbol), and an Exchange object (Id, Name, Symbol). Note that some instrument and timeframe combinations may return no data if the source does not have coverage for that range.
Earnings Call Transcripts
get_transcript_details fetches the full content of an earnings call transcript using a path parameter — the URL path on fool.com, such as /earnings/call-transcripts/2026/01/29/apple-aapl-q1-2026-earnings. The response includes the full_text string with paragraphs separated by newlines, a takeaways array of key bullet points extracted from the transcript, a paragraph_count integer, and a unique_speakers array listing identified speaker names. Transcript paths can be discovered from the transcripts array returned by get_stock_data. If the path is invalid, the endpoint returns a stale_input error with kind input_not_found.
- Build a charting tool using OHLCV
ChartBarsdata fromget_historical_pricesacross daily, hourly, or minute precision - Aggregate Motley Fool analyst
ratingfields across a portfolio of tickers to track buy/sell/hold sentiment - Extract
unique_speakersandfull_textfrom earnings call transcripts for NLP analysis or summarization - Index the
articlesarray fromget_stock_datato surface Motley Fool editorial coverage for a given stock - Pull
takeawaysarrays from multiple transcripts to compare management commentary across quarters - Seed a stock research dashboard with instrument metadata including
ExchangeandCurrencydetails from historical price responses - Discover recent earnings call transcript paths via
transcriptsarray, then fetch full content withget_transcript_details
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Motley Fool have an official public developer API?+
What does the `analyst_opinions` field actually contain?+
source (identifying the opinion source, typically Motley Fool) and rating (the published rating for the stock, such as a buy or outperform designation). This field appears only when a Motley Fool analyst opinion is available for the queried symbol; it is absent for stocks without published ratings.Are intraday or real-time price quotes available?+
get_historical_prices endpoint returns historical OHLCV bars and supports sub-day precision via the Hour and Minute options, but it does not return a live streaming price or a current bid/ask quote. You can fork this API on Parse and revise it to add a real-time quote endpoint if that data becomes accessible.Does the API cover analyst price targets or earnings estimates?+
What happens if a transcript path passed to `get_transcript_details` is invalid?+
stale_input error with kind input_not_found. Valid transcript paths are available in the transcripts array returned by get_stock_data or search_stocks, making those endpoints the reliable way to discover accessible transcript paths for a given ticker.