Yahoo Finance scraper API
The InsightSocial Yahoo Finance API has 29 endpoints, from 20 credits a call. A instrument call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.
The Yahoo Finance scraper API for market data, as JSON: quotes for up to 200 symbols, price history, financial statements, earnings and call transcripts, analyst targets, holders, options, screeners and news.
29 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card
curl "https://api.insightsocial.app/v1/yahoofinance/instrument?symbol=AAPL" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
What Yahoo Finance data can you get?
Public Yahoo Finance data only, in the same JSON envelope as every other platform. Every Yahoo Finance endpoint is beta: inside data it returns Yahoo Finance's own structure under our naming rules (snake_case keys, string ids, ISO times where Yahoo Finance gives a timestamp), not the shared profile and post schema, and fields may change.
Quotes and price history
A quote for one symbol or up to 200 at once, and price bars from one minute to three months with dividends and splits.
Company fundamentals
Income, balance-sheet and cash-flow periods, key statistics and valuation ratios, fundamental metrics, the company profile and SEC filings.
Earnings, analysts and owners
Earnings history and estimates, earnings-call transcripts, analyst recommendations and price targets, institutional and insider holders.
What people build with the Yahoo Finance API
Research dashboards
Pull quotes for a watchlist of up to 200 symbols in one call, with price history and key statistics for each.
Earnings-season analysis
List the companies reporting this week from the calendar, then read each call transcript and the analyst estimates beside it.
Public companies next to social data
Put a brand's stock, news and analyst view next to its TikTok, YouTube and LinkedIn numbers, from one key.
Yahoo Finance API endpoints
All 29 Yahoo Finance endpoints and their price in credits. Every one has a fixed price.
| Endpoint | Credits | What it returns |
|---|---|---|
| /calendar | 20 | List Yahoo Finance earnings, economic, split and IPO calendar rows. |
| /industry | 20 | Get Yahoo Finance industry performance and top and growing companies. |
| /instrument | 20 | Get Yahoo Finance instrument quote record and quote type. |
| /instrument/analyst | 20 | Get Yahoo Finance analyst recommendations, price targets and upgrades. |
| /instrument/chart | 20 | Get Yahoo Finance chart bars, dividends, splits and capital gains. |
| /instrument/earnings | 20 | Get Yahoo Finance quarterly and yearly earnings, estimates and history. |
| /instrument/filings | 20 | List Yahoo Finance SEC filings and SEC reports with EDGAR links. |
| /instrument/financials | 20 | List Yahoo Finance income, balance-sheet and cash-flow periods. |
| /instrument/fund | 20 | Get Yahoo Finance fund profile, performance and top holdings. |
| /instrument/fundamentals | 20 | List Yahoo Finance fundamental metric values for a symbol and period. |
| /instrument/holders | 20 | Get Yahoo Finance institutional and fund holders and holder breakdown. |
| /instrument/insiders | 20 | Get Yahoo Finance insider holders, transactions and share purchases. |
| /instrument/insights | 20 | Get Yahoo Finance technical events, technicals and company snapshot. |
| /instrument/news | 20 | List Yahoo Finance news headlines for a symbol with publisher links. |
| /instrument/options | 20 | Get Yahoo Finance option expiries, strikes, calls and puts. |
| /instrument/profile | 20 | Get Yahoo Finance company profile, address, officers, sector and industry. |
| /instrument/related | 20 | List related Yahoo Finance tickers and recommended symbols. |
| /instrument/statistics | 20 | Get Yahoo Finance key statistics, summary detail and valuation ratios. |
| /instrument/transcript | 20 | Get Yahoo Finance earnings-call transcript with speakers and paragraphs. |
| /instrument/transcripts | 20 | List Yahoo Finance earnings-call transcript entries for a company. |
| /lookup | 20 | Search Yahoo Finance symbols by text and instrument kind. |
| /markets | 20 | Get Yahoo Finance market summary, clock, ticker lists and currencies. |
| /quotes | 20 | Get Yahoo Finance quote records for up to 200 symbols. |
| /screener | 20 | Get one page of a Yahoo Finance predefined screener. |
| /screener/fields | 20 | List Yahoo Finance screener filter and output fields by instrument type. |
| /screeners | 20 | List Yahoo Finance predefined screeners and their titles. |
| /search | 20 | Search Yahoo Finance entities, news, lists and research reports. |
| /sector | 20 | Get Yahoo Finance sector performance, top companies and industries. |
| /trending | 20 | List Yahoo Finance trending symbols for a region. |
Parameters, response fields and examples for each endpoint are in the Yahoo Finance API reference.
How much does the Yahoo Finance API cost?
Yahoo Finance calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 quotes at 20 credits each.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats and retries
A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
Connect InsightSocial to Claude or ChatGPT and ask for Yahoo Finance data in plain English. Same account, same credits.
Yahoo Finance API: frequently asked questions
Anything Yahoo Finance lists a symbol for: stocks on many exchanges (such as AAPL or 7203.T), indexes (^GSPC), currencies (EURUSD=X), crypto (BTC-USD) and funds. /v1/yahoofinance/lookup finds a symbol from a name.
/v1/yahoofinance/instrument/chart returns price bars for a named range such as 1y or max, or a start and end date, at intervals from one minute to three months, with dividends and splits.
/v1/yahoofinance/instrument/transcripts lists a company's calls, and /v1/yahoofinance/instrument/transcript returns one with its speakers and paragraphs.
No to both. It is the market data Yahoo Finance shows publicly, for research. Quotes can be delayed, and a field Yahoo leaves blank comes back empty.
They return Yahoo Finance's own structure under our naming rules (snake_case keys, string ids, ISO times where a timestamp is given) rather than the shared profile and post entities, so fields may change. Each endpoint is 20 credits a call. Calls that fail or find nothing are free.
No. There is no Yahoo Finance app, OAuth flow or review. One API key in the x-api-key header works for Yahoo Finance and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Yahoo Finance's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Yahoo Finance API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Substack scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yelp scraper API