Fool APIfool.com ↗
Access Motley Fool stock data, OHLCV historical prices, analyst opinions, and full earnings call transcripts via 4 structured API endpoints.
What is the Fool 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fool-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.motley_fool_financial_api import MFool, Timeframe, Precision, TranscriptNotFound
client = MFool()
# Get stock data for Apple
stock = client.stocks.get(symbol="AAPL")
print(stock.symbol, stock.instrument_id)
# Check analyst opinions
if stock.analyst_opinions:
print(stock.analyst_opinions.source, stock.analyst_opinions.rating)
# Browse recent articles
for article in stock.articles:
print(article.title, article.url)
# Fetch historical prices with enum-typed timeframe and precision
for bar in stock.prices.list(timeframe=Timeframe.ONE_YEAR, precision=Precision.DAY):
print(bar.pricing_date, bar.close.amount, bar.volume)
# Get transcript details from a transcript summary
for ts in stock.transcripts:
transcript = ts.details()
print(transcript.title, transcript.paragraph_count)
for speaker in transcript.unique_speakers:
print(speaker)
# Search for a stock by query
msft = client.stocks.search(query="MSFT")
print(msft.symbol, msft.instrument_id)
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. The instrument_id in the response is required for fetching historical prices via the get_historical_prices endpoint.
| 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/06/09/why-apple-stock-is-sinking-today/",
"path": "/investing/2026/06/09/why-apple-stock-is-sinking-today/",
"title": "Why Apple Stock Is Sinking Today"
}
],
"transcripts": [],
"instrument_id": 202686,
"analyst_opinions": {
"rating": "Buy",
"source": "Motley Fool Stock Advisor"
}
},
"status": "success"
}
}About the Fool API
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.
The Fool API is a managed, monitored endpoint for fool.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fool.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fool.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.