gurufocus.com APIgurufocus.com ↗
Access GuruFocus data via 3 endpoints: search stocks by ticker or name, retrieve stock summaries with price and market cap, and fetch the latest guru trading picks.
curl -X GET 'https://api.parse.bot/scraper/8f896012-f0f1-429a-afe6-1f493f91db26/search_stocks?query=AAPL' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for stocks and gurus by ticker symbol or company name. Returns matching stocks across multiple exchanges and related guru/ETF entries.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Stock ticker or company name to search for (e.g. 'AAPL', 'Microsoft'). |
{
"type": "object",
"fields": {
"data": "array of search result objects, each with 'type' (stock or guru) and 'data' containing symbol, company, price, exchange, mktcap, volume, currency"
},
"sample": {
"data": {
"data": [
{
"data": {
"price": 280.14,
"mktcap": 4109006.116,
"symbol": "AAPL",
"volume": 42769864,
"company": "Apple Inc",
"stockid": "US01WD",
"currency": "USD",
"exchange": "NAS"
},
"type": "stock"
}
]
},
"status": "success"
}
}About the gurufocus.com API
The GuruFocus API exposes 3 endpoints that cover stock search, individual stock summaries, and guru trading activity. With get_guru_latest_picks you can pull every tracked guru's recent new buys, additions, reductions, and sold-out positions in a single call. The search_stocks endpoint resolves tickers and company names across multiple exchanges, returning price, market cap, and exchange metadata alongside matching guru and ETF entries.
Stock Search and Lookup
The search_stocks endpoint accepts a query parameter — a ticker symbol like AAPL or a full company name like Microsoft — and returns an array of result objects. Each object includes a type field (stock or guru) plus a nested data payload carrying symbol, company, price, exchange, mktcap, and volume. This makes it suitable for autocomplete, ticker resolution, and cross-exchange coverage checks in a single round trip.
The get_stock_summary endpoint takes a single ticker parameter and returns a stock_info object with fields including stockid, symbol, exchange, company, price, currency, mktcap, and volume. The currency field is particularly useful when the ticker belongs to a non-USD-denominated exchange, and stockid can serve as a stable internal identifier for downstream lookups.
Guru Trading Activity
The get_guru_latest_picks endpoint requires no input parameters. It returns an array of pick objects, one per guru, each containing Guru Name, Firm, Date *, New Buy, Add, Reduce, Sold Out, and Last Update fields. The structure maps directly to the portfolio change columns GuruFocus tracks for investment managers — useful for monitoring which positions were initiated, scaled, or exited in the most recent filing period.
Data Scope and Coverage
Coverage spans stocks across multiple exchanges, accessible via both ticker symbol and company name search. The guru picks data reflects tracked investment managers and their disclosed portfolio movements. Response fields are consistent across calls, though some secondary identifier fields in stock_info may be null for less-covered tickers.
- Resolve an ambiguous ticker or company name to its canonical symbol and exchange using
search_stocks - Display a real-time stock header (price, market cap, currency) in a dashboard using
get_stock_summary - Track which investment gurus initiated new positions or exited holdings in the latest period via
get_guru_latest_picks - Identify which firm a guru is affiliated with alongside their most recent portfolio additions and reductions
- Build a watchlist by cross-referencing
symbolandexchangefields returned from stock search results - Monitor guru consensus by aggregating
New BuyandSold Outcounts across multiple gurus from a single endpoint call - Enrich a stock record with
stockidandcurrencyfor multi-exchange portfolio tracking applications
| 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 GuruFocus have an official developer API?+
What exactly does `get_guru_latest_picks` return, and how current is it?+
New Buy, Add, Reduce, Sold Out, Date *, Last Update, and Firm. The data reflects the most recently available portfolio disclosure on GuruFocus. Because institutional managers file on a delay (typically 13F quarterly filings), the picks represent disclosed activity rather than real-time trades.Does the `search_stocks` endpoint support filtering by exchange or asset type?+
query parameter — no exchange or asset-type filter is exposed. The response includes exchange and type fields per result, so filtering can be applied client-side. You can fork this API on Parse and revise it to add server-side filtering by exchange if needed.Does the API return historical price data or valuation metrics like P/E ratio?+
price, mktcap, volume, currency), and guru portfolio changes. Historical OHLCV data, valuation ratios, and financial statement figures are not included. You can fork this API on Parse and revise it to add an endpoint targeting those data points.Can I look up a specific guru's full portfolio rather than just their latest changes?+
get_guru_latest_picks endpoint returns the most recent portfolio activity across all tracked gurus — new buys, additions, reductions, and sold-out positions — but does not expose a full historical portfolio for a single named guru. You can fork this API on Parse and revise it to add a per-guru portfolio endpoint.