Yahoo Finance API. Market data as JSON.
Quotes, charts, company statements, screeners, calendars and earnings-call transcripts for any ticker. Send a symbol, get JSON.
- Any ticker
- 30 routes
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Yahoo Finance data as JSON. You build the product.
Live Yahoo Finance data in one response shape, with platform changes handled for you.
Yahoo Finance, plus every other platform
One key and one response envelope for Yahoo Finance and 56 more platforms.
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Yahoo Finance data can you get?
30 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Instruments
- +7 more company endpoints
Company
- +2 more markets endpoints
Markets
News
Discover
Screeners
Browse all 30 Yahoo Finance endpoints
Instruments
Company
Markets
News
Discover
Screeners
What teams build with Yahoo Finance data
Monitoring, enrichment, research and content workflows on Yahoo Finance data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
Sources
+ 51 more platforms
One request
GET/v1/tiktok/profiles/
x-api-key: sk_live_••••••••
Same JSON shape
{
"data": {
"lookupStatus": "found",
"profile": {
"platform": "tiktok",
"handle": "charlidamelio",
"displayName": "charli d’amelio",
"verified": true
},
"metrics": {
"followers": 160263648
}
}
}Step 1
Create your free account
Get an API key with 100 requests included.
Step 2
Choose an endpoint
Pass a username, URL, keyword, or post ID.
Step 3
Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
TypeScript
n8n
- Make
- Apify
- MCP
- AI clients
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“Transcripts at volume from one endpoint. No broken scrapers for our small team to maintain.”
“Live profile data on every request. We never flag accounts from a stale cache.”
“Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Yahoo Finance API: common questions
What can I get from the Yahoo Finance API?
Thirty routes cover quotes, charts, company profiles and statements, earnings, analyst data, holders, insiders, options, funds, SEC filings, technical insights, related tickers, news, earnings-call transcripts, search, lookup, predefined and custom screeners, calendars, sectors, industries, trending symbols and the market summary.
Which symbols are accepted?
The ticker as Yahoo Finance writes it: AAPL for Apple, ^GSPC for the S&P 500 index, EURUSD=X for a currency pair, BTC-USD for bitcoin and 7203.T for Toyota on Tokyo. Symbols are case-insensitive and may contain letters, digits, ^, =, . and -.
What does lookupStatus mean?
found means the entity was returned. not_found means the symbol or entity does not exist. HTTP 200 only means the request finished, so branch on data.lookupStatus before writing a row. A found result can still carry null sections when that instrument kind has none.
Is the market data real time?
The routes return the market data Yahoo Finance publishes publicly. Each quote carries exchangeDataDelayedBy, the exchange delay in minutes for that instrument, so read it before you treat a price as live. Indices, futures and crypto can report different delays from listed equities.
How do I page through lookup, screeners and calendar results?
Read data.page. While data.page.hasMore is true, call again with cursor set to data.page.nextCursor. The cursor carries the offset, page size and a fingerprint of the filters, so it only works with the same filters. A page with no rows has no next cursor.
How many chart bars can I request?
Bars are capped at 25,000 per response. When the cap is reached, data.truncated is true and data.bars is the number returned; narrow range or use start and end to read the rest. range=max is translated to explicit periods instead of being sent as max.
Is quoteType always set?
quoteType is the instrument kind the screener runs over (equity, crypto, ETF, mutual fund, option or private company). analyst_strong_buy_stocks does not name one, so it is null.
What is in an earnings-call transcript response?
data.transcript carries the title, fiscal year and period, date, speakers, paragraphs and the full text. The list route first returns the newest transcripts with their event id, which you pass to the transcript route. An ETF or a company with no transcript key returns an empty list or reason no_transcript_key.
How much does a Yahoo Finance request cost?
Each route charges its credit amount per completed request, shown on the endpoint page. A request with bad input returns a 400 and is not billed. Check meta.creditsCharged on every response; new accounts start with 100 free credits.
The Yahoo Finance API in detailHow the Yahoo Finance routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Yahoo Finance
Social Fetch exposes thirty routes under /v1/yahoo-finance. Instrument routes start at GET /v1/yahoo-finance/instruments/{symbol} and branch into chart, profile, statistics, financials, earnings, analyst, holders, insiders, options, fund, filings, insights, related, news and transcript data. The other routes cover quotes by list, search and lookup, predefined and custom screeners, screener fields, calendars, sectors, industries, trending symbols and the market summary.
A symbol is the ticker Yahoo Finance uses: AAPL, ^GSPC, EURUSD=X, BTC-USD, 7203.T. Every response uses the { data, meta } envelope. Lookups carry data.lookupStatus, so an unknown ticker comes back as a typed not_found instead of an error. Lists with an offset (lookup, screener.get, screener.search, calendar.list) return data.page with a nextCursor; a page past the end is an empty page with no next cursor.
Market data is what Yahoo Finance publishes publicly, and quote records carry exchangeDataDelayedBy so you can see the exchange delay for that instrument. Chart metadata carries chartPreviousClose and the trading period instead. You can rely on the shape: raw number fields, epoch times as ISO 8601 UTC, sections that are null when an instrument kind has none, and data.sources recording which parts are available.
How to call the Yahoo Finance API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try every Yahoo Finance route on a few tickers.2. Pick the ticker and route
Use the symbol as Yahoo Finance writes it, for example
GET /v1/yahoo-finance/instruments/AAPL/chart?range=1y&interval=1dorGET /v1/yahoo-finance/quotes?symbols=AAPL,MSFT,NVDA. Sendx-api-keyon every request.3. Branch on lookupStatus and page
Check
data.lookupStatusbefore you store a row, keep requesting withdata.page.nextCursorwhiledata.page.hasMoreis true, and bill frommeta.creditsCharged.
What each Yahoo Finance route returns
- One quote or a batch of up to 200 symbols, with per-symbol
lookupStatus. - OHLCV chart bars by interval and range, plus dividends, splits and capital gains, with
truncatedwhen the bar cap is reached. - Company profile, key statistics, income, balance-sheet and cash-flow periods and known fundamental metrics.
- Analyst recommendations and price targets, institutional, fund and insider holders, SEC filings and technical insights.
- Option expiries, strikes, calls and puts, fund performance and top holdings.
- Predefined and custom screeners, four calendar types, sectors, industries, trending symbols and the market clock.
How much does the Yahoo Finance API cost?
Every Yahoo Finance route charges its credit amount per completed request, shown on the endpoint page. A request with bad input returns a 400 and is not billed. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Yahoo Finance API
On Yahoo Finance the available data changes with the instrument kind, and quotes, charts and statements each use a different shape. Social Fetch normalises those fields under their own names, converts epoch times to ISO 8601 UTC, reports an unknown symbol as not_found data, and pages the offset lists with a cursor bound to the filters that issued it.
Pull your first Yahoo Finance data.
Run a live Yahoo Finance request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub
