Yahoo! Finance API
Our Yahoo! Finance API allows you to scrape quote pages from Yahoo! Finance. Search a stock, ETF, index, mutual fund, cryptocurrency, currency, or futures by its symbol with the q parameter to get its price summary, graph, statistics, company overview, performance overview, analyst insights, earnings, key statistics, related quotes, and the market summary. Search anything else, like a company name, to get the symbols Yahoo! Finance finds for it. Results can be localized with any of the Yahoo! Finance domains.
The API endpoint is https://serpapi.com/search?engine=yahoo_finance
Head to the playground for a live and interactive demo.
API parameters
Localization
yahoo_domain
Optional
Parameter defines the Yahoo! Finance domain to use (e.g., de for de.finance.yahoo.com). It defaults to finance.yahoo.com.
The domain sets the region of market_summary, trending_tickers, and suggestions, the format of numbers, and the language of some names and descriptions. The quote's extracted values (e.g., extracted_price) are the same on every domain, but other domains often return prices that are several minutes older. Head to the Yahoo! Finance domains page for a full list of supported Yahoo! Finance domains.
Advanced parameters
window
Optional
Parameter is used for setting the time range of the graph. It can be set to:1D - 1 Day5D - 5 Days1M - 1 Month6M - 6 MonthsYTD - Year to Date1Y - 1 Year5Y - 5 YearsMAX - Maximum
As Yahoo! Finance has no price for a time without trades, the graph has no point for it. Before and after the regular session, a stock can go several minutes without a trade.
SerpApi parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Yahoo! Finance results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
output
Optional
Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.
json_restrictor
Optional
Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.
API results
JSON results
JSON output includes structured data for Summary, Graph, Stats, Company Overview, Performance Overview, Analyst Insights, Earnings, Key Statistics, People Also Watch, Trending Tickers, Market Summary, and Suggestions.
A search status is accessible through search_metadata.status.
It flows this way: Processing -> Success || Error.
If a search has failed, error will contain an error message.
search_metadata.id is the search ID inside SerpApi.
HTML results
This API does not have a full HTML response, only text.
search_metadata.prettify_html_file contains a link to the prettified version of the result.
It is displayed in the playground.
Markdown results
Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results
in a token-efficient format using tables, markdown links, and YAML frontmatter.
To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.
API examples
Result for q: AAPL
{
...
"summary": {
"stock": "AAPL",
"title": "Apple Inc.",
"exchange": "NasdaqGS",
"quote_type": "Equity",
"currency": "USD",
"market_state": "REGULAR",
"price": "357.40",
"extracted_price": 357.3976,
"price_movement": {
"percentage": 0.5733983,
"value": 2.0376282,
"movement": "Up"
},
"date": "Nov 12 2026, 09:49:11 AM UTC-05:00"
},
"graph": [
{
"date": "Nov 12 2026, 04:00 AM UTC-05:00",
"close": 356.2,
"pre_market": true
},
{
"date": "Nov 12 2026, 04:05 AM UTC-05:00",
"close": 356.07,
"pre_market": true
},
{
"date": "Nov 12 2026, 04:10 AM UTC-05:00",
"close": 356.1789,
"pre_market": true
},
...
],
"stats": {
"previous_close": {
"value": "355.36",
"extracted_value": 355.36
},
"open": {
"value": "357.71",
"extracted_value": 357.71
},
"bid": {
"value": "355.02",
"extracted_value": 355.02,
"size": 400
},
"ask": {
"value": "357.00",
"extracted_value": 357.0,
"size": 2000
},
"day_low": {
"value": "355.92",
"extracted_value": 355.92
},
"day_high": {
"value": "359.02",
"extracted_value": 359.02
},
"fifty_two_week_low": {
"value": "243.42",
"extracted_value": 243.42
},
"fifty_two_week_high": {
"value": "359.02",
"extracted_value": 359.02
},
"volume": {
"value": "4,348,907",
"extracted_value": 4348907
},
"avg_volume": {
"value": "42,706,656",
"extracted_value": 42706656
},
"market_cap": {
"value": "5.194T",
"extracted_value": 5193767321600
},
"beta": {
"value": "1.09",
"extracted_value": 1.089
},
"trailing_pe": {
"value": "39.79",
"extracted_value": 39.787308
},
"diluted_eps": {
"value": "8.98",
"extracted_value": 8.98
},
"earnings_date": "2027-01-28",
"dividend_rate": {
"value": "1.08",
"extracted_value": 1.08
},
"dividend_yield": {
"value": "0.30%",
"extracted_value": 0.003
},
"ex_dividend_date": "2026-11-12"
},
...
}
Company overview
{
...
"company_overview": {
"description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories. The company offers iPhone, a line of smartphones; Mac, a line of personal computers; iPad, a line of multi-purpose tablets; and wearables, home, and accessories, including Apple Watch, AirPods, Beats products, Apple Vision Pro, Apple TV 4K, HomePod, and Apple HomeView, as well as Apple branded and third-party accessories. It also provides advertising services comprising third-party licensing arrangements and own advertising platforms; AppleCare and cloud services; and payment services, including Apple Card and Apple Pay. In addition, the company operates App Store that allow customers to discover and download applications and digital content, such as books, music, video, games, and podcasts. Further, it provides digital content through subscription-based services, including Apple Arcade, a game service; Apple Fitness+, a personalized fitness service; Apple Music, which offers users a curated listening experience; Apple News+, a news and magazine service; and Apple TV, which offers original content and live sports. The company sells its products and resells third-party products through its retail and online stores, and direct sales force; its services through its various service platforms; and third-party cellular network carriers and other resellers. It serves consumer, small and mid-sized business, education, enterprise, and government markets. The company operates in North and South America, European countries, India, the Middle East, Africa, China mainland, Hong Kong, Taiwan, Japan, Australia, New Zealand, and rest of Asia. The company was formerly known as Apple Computer, Inc. and changed its name to Apple Inc. in January 2007. Apple Inc. was founded in 1976 and is headquartered in Cupertino, California.",
"website": "https://www.apple.com",
"full_time_employees": 167000,
"fiscal_year_ends": "September 26",
"sector": "Technology",
"industry": "Consumer Electronics"
},
...
}
Performance overview
{
...
"performance_overview": {
"benchmark": {
"stock": "^GSPC",
"name": "S&P 500"
},
"ytd": {
"value": "31.78%",
"extracted_value": 0.31782,
"benchmark": {
"value": "11.01%",
"extracted_value": 0.11006354
}
},
"one_year": {
"value": "31.01%",
"extracted_value": 0.31006163,
"benchmark": {
"value": "10.92%",
"extracted_value": 0.10918534
}
},
"two_years": {
"value": "60.50%",
"extracted_value": 0.6049718,
"benchmark": {
"value": "26.99%",
"extracted_value": 0.2698784
}
},
"three_years": {
"value": "94.02%",
"extracted_value": 0.94016063,
"benchmark": {
"value": "72.11%",
"extracted_value": 0.7210705
}
},
"five_years": {
"value": "143.87%",
"extracted_value": 1.4386827,
"benchmark": {
"value": "62.27%",
"extracted_value": 0.6227169
}
}
},
...
}
Analyst insights
{
...
"analyst_insights": {
"price_targets": {
"current": {
"value": "357.40",
"extracted_value": 357.3976
},
"target_high": {
"value": "425.00",
"extracted_value": 425.0
},
"target_low": {
"value": "250.00",
"extracted_value": 250.0
},
"target_avg": {
"value": "344.62",
"extracted_value": 344.6155
},
"target_median": {
"value": "352.50",
"extracted_value": 352.5
},
"number_of_analysts": 40
},
"recommendation": "buy",
"recommendation_mean": {
"value": "2.18",
"extracted_value": 2.17778
},
"recommendation_trend": [
{
"period": "Current Month",
"strong_buy": 6,
"buy": 20,
"hold": 13,
"sell": 3,
"strong_sell": 3
},
{
"period": "1 Month Ago",
"strong_buy": 6,
"buy": 18,
"hold": 13,
"sell": 3,
"strong_sell": 3
},
...
],
"latest_rating": {
"date": "2026-11-11",
"firm": "China Renaissance",
"to_grade": "Buy",
"from_grade": "Hold",
"action": "Upgrade",
"price_target_action": "Announces",
"current_price_target": 425.0
}
},
...
}
Earnings
{
...
"earnings": {
"quarterly": [
{
"date": "4Q2025",
"fiscal_quarter": "1Q2026",
"actual": {
"value": "2.84",
"extracted_value": 2.84
},
"estimate": {
"value": "2.67",
"extracted_value": 2.6708
},
"difference": 0.17,
"surprise_percent": 6.34,
"period_end_date": "2025-12-31",
"reported_date": "2026-01-29"
},
{
"date": "1Q2026",
"fiscal_quarter": "2Q2026",
"actual": {
"value": "2.01",
"extracted_value": 2.01
},
"estimate": {
"value": "1.94",
"extracted_value": 1.94275
},
"difference": 0.07,
"surprise_percent": 3.46,
"period_end_date": "2026-03-31",
"reported_date": "2026-04-30"
},
...
],
"current_quarter": {
"estimate": {
"value": "2.91",
"extracted_value": 2.91173
},
"estimate_date": "4Q",
"estimate_year": 2026,
"fiscal_quarter": "1Q2027",
"calendar_quarter": "4Q2026",
"period_end_date": "2026-12-31"
},
"next_earnings_date": "2027-01-28",
"yearly_financials": [
{
"year": 2023,
"revenue": {
"value": "383.29B",
"extracted_value": 383285000000
},
"earnings": {
"value": "97B",
"extracted_value": 96995000000
},
"profit_margin": {
"value": "25.31%",
"extracted_value": 0.25306234
}
},
{
"year": 2024,
"revenue": {
"value": "391.04B",
"extracted_value": 391035000000
},
"earnings": {
"value": "93.74B",
"extracted_value": 93736000000
},
"profit_margin": {
"value": "23.97%",
"extracted_value": 0.23971257
}
},
...
],
"quarterly_financials": [
{
"date": "4Q2025",
"fiscal_quarter": "1Q2026",
"revenue": {
"value": "143.76B",
"extracted_value": 143756000000
},
"earnings": {
"value": "42.1B",
"extracted_value": 42097000000
},
"profit_margin": {
"value": "29.28%",
"extracted_value": 0.2928365
}
},
{
"date": "1Q2026",
"fiscal_quarter": "2Q2026",
"revenue": {
"value": "111.18B",
"extracted_value": 111184000000
},
"earnings": {
"value": "29.58B",
"extracted_value": 29578000000
},
"profit_margin": {
"value": "26.60%",
"extracted_value": 0.26602748
}
},
...
],
"is_earnings_date_estimate": true
},
...
}
Key statistics
{
...
"key_statistics": {
"valuation_measures": {
"market_cap": {
"value": "5.19T",
"extracted_value": 5192203370496
},
"enterprise_value": {
"value": "5.21T",
"extracted_value": 5205836955648
},
"trailing_pe": {
"value": "39.79",
"extracted_value": 39.787308
},
"forward_pe": {
"value": "33.88",
"extracted_value": 33.88093
},
"peg_ratio": {
"value": "2.87",
"extracted_value": 2.87
},
"price_to_sales": {
"value": "10.84",
"extracted_value": 10.8434305
},
"price_to_book": {
"value": "46.32",
"extracted_value": 46.323093
},
"enterprise_to_revenue": {
"value": "10.87",
"extracted_value": 10.872
},
"enterprise_to_ebitda": {
"value": "30.36",
"extracted_value": 30.357
}
},
"financial_highlights": {
"profit_margin": {
"value": "27.60%",
"extracted_value": 0.27604
},
"return_on_assets": {
"value": "25.87%",
"extracted_value": 0.25868
},
"return_on_equity": {
"value": "142.26%",
"extracted_value": 1.42257
},
"revenue": {
"value": "478.83B",
"extracted_value": 478833999872
},
"net_income_to_common": {
"value": "132.18B",
"extracted_value": 132175003648
},
"diluted_eps": {
"value": "8.98",
"extracted_value": 8.98
},
"total_cash": {
"value": "56.72B",
"extracted_value": 56722001920
},
"total_debt_to_equity": {
"value": "84.29%",
"extracted_value": 0.84286
},
"levered_free_cash_flow": {
"value": "105.66B",
"extracted_value": 105658376192
}
}
},
...
}
People also watch
Yahoo! Finance's page sometimes requests the quotes of the recommended symbols only after it opens. The results then have the symbols, with stock, link, and serpapi_link only.
{
...
"people_also_watch": [
{
"stock": "AMZN",
"link": "https://finance.yahoo.com/quote/AMZN/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=AMZN",
"name": "Amazon.com, Inc.",
"price": "271.63",
"extracted_price": 271.63,
"price_movement": {
"percentage": 2.0513172,
"value": 5.4599915,
"movement": "Up"
}
},
{
"stock": "TSLA",
"link": "https://finance.yahoo.com/quote/TSLA/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=TSLA",
"name": "Tesla, Inc.",
"price": "393.29",
"extracted_price": 393.2922,
"price_movement": {
"percentage": 0.63351786,
"value": 2.475891,
"movement": "Up"
}
},
{
"stock": "GOOG",
"link": "https://finance.yahoo.com/quote/GOOG/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=GOOG",
"name": "Alphabet Inc.",
"price": "292.73",
"extracted_price": 292.73,
"price_movement": {
"percentage": 0.7225703,
"value": 2.100006,
"movement": "Up"
}
},
...
],
...
}
Trending tickers
{
...
"trending_tickers": [
{
"stock": "NVDA",
"link": "https://finance.yahoo.com/quote/NVDA/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=NVDA",
"name": "NVIDIA Corporation",
"price": "159.75",
"extracted_price": 159.75,
"price_movement": {
"percentage": 8.046967,
"value": 13.979996,
"movement": "Down"
}
},
{
"stock": "NBIS",
"link": "https://finance.yahoo.com/quote/NBIS/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=NBIS",
"name": "Nebius Group N.V.",
"price": "129.21",
"extracted_price": 129.21,
"price_movement": {
"percentage": 16.47165,
"value": 25.479996,
"movement": "Down"
}
},
{
"stock": "MSTR",
"link": "https://finance.yahoo.com/quote/MSTR/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=MSTR",
"name": "Strategy Inc",
"price": "113.31",
"extracted_price": 113.31,
"price_movement": {
"percentage": 7.3886404,
"value": 9.040001,
"movement": "Down"
}
},
...
],
...
}
Market summary
{
...
"market_summary": [
{
"stock": "^GSPC",
"link": "https://finance.yahoo.com/quote/%5EGSPC/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=%5EGSPC",
"name": "S&P 500",
"price": "7,598.47",
"extracted_price": 7598.47,
"price_movement": {
"percentage": 0.27441445,
"value": 20.909668,
"movement": "Down"
}
},
{
"stock": "^DJI",
"link": "https://finance.yahoo.com/quote/%5EDJI/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=%5EDJI",
"name": "Dow 30",
"price": "52,544.82",
"extracted_price": 52544.82,
"price_movement": {
"percentage": 0.11113837,
"value": 58.33203,
"movement": "Up"
}
},
{
"stock": "^IXIC",
"link": "https://finance.yahoo.com/quote/%5EIXIC/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=%5EIXIC",
"name": "Nasdaq",
"price": "25,323.49",
"extracted_price": 25323.494,
"price_movement": {
"percentage": 0.5603456,
"value": 142.69531,
"movement": "Down"
}
},
...
],
...
}
Result for window: 1Y
{
...
"graph": [
{
"date": "Nov 12 2025, 09:30 AM UTC-05:00",
"open": 195.72,
"high": 195.89,
"low": 191.13,
"close": 193.8,
"volume": 154935300
},
{
"date": "Nov 13 2025, 09:30 AM UTC-05:00",
"open": 191.05,
"high": 191.44,
"low": 183.85,
"close": 186.86,
"volume": 207423100
},
{
"date": "Nov 14 2025, 09:30 AM UTC-05:00",
"open": 182.86,
"high": 191.01,
"low": 180.58,
"close": 190.17,
"volume": 186591900
},
...
],
...
}
Result for q: SPY (ETF)
ETFs and mutual funds have their net assets, NAV, yield, and expense ratio in stats, and their returns are compared with their category in performance_overview.
{
...
"stats": {
"previous_close": {
"value": "749.92",
"extracted_value": 749.92
},
"open": {
"value": "756.80",
"extracted_value": 756.8
},
"day_low": {
"value": "754.91",
"extracted_value": 754.91
},
"day_high": {
"value": "762.51",
"extracted_value": 762.51
},
"fifty_two_week_low": {
"value": "629.28",
"extracted_value": 629.28
},
"fifty_two_week_high": {
"value": "781.62",
"extracted_value": 781.62
},
"volume": {
"value": "37,707,134",
"extracted_value": 37707134
},
"avg_volume": {
"value": "42,957,123",
"extracted_value": 42957123
},
"net_assets": {
"value": "796.87B",
"extracted_value": 796865200128
},
"nav": {
"value": "759.66",
"extracted_value": 759.6635
},
"yield": {
"value": "1.00%",
"extracted_value": 0.01
},
"ytd_return": {
"value": "10.83%",
"extracted_value": 0.1083181
},
"expense_ratio": {
"value": "0.09%",
"extracted_value": 0.000945
},
"category": "Large Blend",
"inception_date": "1993-01-22",
"beta": {
"value": "0.97",
"extracted_value": 0.97
},
"trailing_pe": {
"value": "24.17",
"extracted_value": 24.172848
}
},
"performance_overview": {
"benchmark": {
"name": "Large Blend"
},
"ytd": {
"value": "10.83%",
"extracted_value": 0.1083181,
"benchmark": {
"value": "5.14%",
"extracted_value": 0.051434003
}
},
"one_year": {
"value": "11.23%",
"extracted_value": 0.1123472,
"benchmark": {
"value": "27.72%",
"extracted_value": 0.27720898
}
},
"three_years": {
"value": "20.85%",
"extracted_value": 0.2084537,
"benchmark": {
"value": "19.34%",
"extracted_value": 0.1934272
}
}
},
...
}
Result for q: BTC-USD (cryptocurrency)
Cryptocurrencies have their market cap, fully diluted valuation, supply, and all-time high and low in stats, and company_overview has their website and whitepaper. As on Yahoo! Finance, only cryptocurrencies have an all-time high and low.
{
...
"stats": {
"previous_close": {
"value": "73,925.19",
"extracted_value": 73925.19
},
"open": {
"value": "73,925.19",
"extracted_value": 73925.19
},
"day_low": {
"value": "72,305.29",
"extracted_value": 72305.29
},
"day_high": {
"value": "74,072.29",
"extracted_value": 74072.29
},
"fifty_two_week_low": {
"value": "57,747.77",
"extracted_value": 57747.766
},
"fifty_two_week_high": {
"value": "104,005.49",
"extracted_value": 104005.49
},
"market_cap": {
"value": "1.454T",
"extracted_value": 1454137802752
},
"fully_diluted_valuation": {
"value": "1.52T",
"extracted_value": 1517566312500
},
"volume_24h": {
"value": "24.04B",
"extracted_value": 24037003264
},
"volume_24h_to_market_cap": {
"value": "1.65%",
"extracted_value": 0.016534895
},
"circulating_supply": {
"value": "20.11M",
"extracted_value": 20111084
},
"total_supply": {
"value": "20.11M",
"extracted_value": 20111084
},
"max_supply": {
"value": "21.00M",
"extracted_value": 21000000
},
"all_time_high": {
"value": "126,198.07",
"extracted_value": 126198.07
},
"all_time_low": {
"value": "171.51",
"extracted_value": 171.51
},
"start_date": "2010-07-13"
},
"company_overview": {
"description": "Bitcoin (BTC) is a cryptocurrency launched in 2010. Users are able to generate BTC through the process of mining. Bitcoin has a current supply of 20,111,046. The last known price of Bitcoin is 73,425.33922051 USD and is down -0.74 over the last 24 hours. It is currently trading on 12778 active market(s) with $21,143,794,963.77 traded over the last 24 hours. More information can be found at https://bitcoin.org/.",
"website": "https://bitcoin.org/",
"whitepaper": "https://bitcoin.org/bitcoin.pdf"
},
...
}
Result for yahoo_domain: de
yahoo_domain sets the region of market_summary, trending_tickers, and suggestions, the format of numbers, and the language of some names and descriptions. The quote's extracted values are the same on every domain, but other domains often return prices that are several minutes older. Head to the Yahoo! Finance domains page for a full list of supported Yahoo! Finance domains. Links stay on the domain, and each serpapi_link keeps yahoo_domain.
{
...
"summary": {
"stock": "SAP.DE",
"title": "SAP SE",
"exchange": "XETRA",
"quote_type": "Equity",
"currency": "EUR",
"market_state": "REGULAR",
"price": "211,20",
"extracted_price": 211.2,
"price_movement": {
"percentage": 0.1185115,
"value": 0.25,
"movement": "Up"
},
"date": "Nov 12 2026, 02:58:26 PM UTC+01:00"
},
"stats": {
"previous_close": {
"value": "210,95",
"extracted_value": 210.95
},
"open": {
"value": "212,30",
"extracted_value": 212.3
},
"bid": {
"value": "210,10",
"extracted_value": 210.1,
"size": 76700
},
"ask": {
"value": "210,15",
"extracted_value": 210.15,
"size": 56500
},
"volume": {
"value": "390.051",
"extracted_value": 390051
},
"market_cap": {
"value": "243,768Mrd.",
"extracted_value": 243767934976
},
...
},
"people_also_watch": [
{
"stock": "SIE.DE",
"link": "https://de.finance.yahoo.com/quote/SIE.DE/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=SIE.DE&yahoo_domain=de"
},
...
],
...
}
Result for q: Apple Inc
Search anything other than a symbol, like a company name, to get the symbols Yahoo! Finance finds for it in suggestions, as its symbol lookup page shows them. Each has a serpapi_link to search its quote.
{
...
"suggestions": [
{
"stock": "AAPL",
"link": "https://finance.yahoo.com/quote/AAPL/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=AAPL",
"name": "Apple Inc.",
"exchange": "NMS",
"quote_type": "Equity",
"sector": "Technology",
"price": "357.29",
"extracted_price": 357.29,
"price_movement": {
"percentage": 0.54311776,
"value": 1.9300232,
"movement": "Up"
}
},
{
"stock": "SAAPL=F",
"link": "https://finance.yahoo.com/quote/SAAPL%3DF/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=SAAPL%3DF",
"name": "Apple Inc Stock Futures,Dec-202",
"exchange": "CME",
"quote_type": "Futures",
"price": "357.37",
"extracted_price": 357.37,
"price_movement": {
"percentage": 0.3848301,
"value": 1.3699951,
"movement": "Up"
}
},
{
"stock": "TAAPL=F",
"link": "https://finance.yahoo.com/quote/TAAPL%3DF/",
"serpapi_link": "https://serpapi.com/search.json?engine=yahoo_finance&q=TAAPL%3DF",
"name": "BTIC Apple Inc Stock Futures,De",
"exchange": "CME",
"quote_type": "Futures",
"price": "0.37",
"extracted_price": 0.37,
"price_movement": {
"percentage": 75.333336,
"value": 1.13,
"movement": "Down"
}
},
...
],
...
}
JSON structure overview
{
...
"summary": {
"stock": "String - Symbol of the quote",
"title": "String - Name of the quote",
"exchange": "String - Name of the exchange (e.g., 'NasdaqGS')",
"quote_type": "String - Type of the quote: 'Equity', 'ETF', 'Fund', 'Index', 'Cryptocurrency', 'Currency', or 'Futures'",
"currency": "String - Currency of the prices (e.g., 'USD')",
"market_state": "String - State of the market (e.g., 'PRE', 'REGULAR', 'POST', 'CLOSED')",
"price": "String - Price of the regular session, as Yahoo! Finance shows it",
"extracted_price": "Float - Price of the regular session",
"price_movement": {
"percentage": "Float - Change since the previous close, in percent",
"value": "Float - Change since the previous close",
"movement": "String - 'Up' or 'Down', unless the price didn't change"
},
"date": "String - Time of the price, in the time zone of the exchange (e.g., 'Nov 11 2026, 04:00:01 PM UTC-05:00')",
"market": {
"trading": "String - Extended hours session: 'Pre-Market', 'After hours', or 'Overnight'",
"price": "String - Price of the session, as Yahoo! Finance shows it",
"extracted_price": "Float - Price of the session",
"price_movement": {
"percentage": "Float - Change in the session, in percent",
"value": "Float - Change in the session",
"movement": "String - 'Up' or 'Down', unless the price didn't change"
},
"date": "String - Time of the price, in the time zone of the exchange"
}
},
"graph": [
{
"date": "String - Time of the point, in the time zone of the exchange (e.g., 'Nov 12 2026, 04:00 AM UTC-05:00')",
"open": "Float - Opening price. Without window, only in the US pre-market, for stocks and ETFs",
"high": "Float - Highest price. Without window, only in the US pre-market, for stocks and ETFs",
"low": "Float - Lowest price. Without window, only in the US pre-market, for stocks and ETFs",
"close": "Float - Closing price",
"volume": "Integer - Volume. Without window, only in the US pre-market, for stocks and ETFs",
"pre_market": "Boolean - true for a point of the pre-market session",
"after_hours": "Boolean - true for a point of the after hours session"
}
],
"stats": {
"previous_close": {
"value": "String - Previous close, as Yahoo! Finance shows it",
"extracted_value": "Float - Previous close"
},
"open": {
"value": "String - Opening price",
"extracted_value": "Float - Opening price"
},
"bid": {
"value": "String - Bid",
"extracted_value": "Float - Bid",
"size": "Integer - Size of the bid, for stocks and ETFs"
},
"ask": {
"value": "String - Ask",
"extracted_value": "Float - Ask",
"size": "Integer - Size of the ask, for stocks and ETFs"
},
"day_low": {
"value": "String - Lowest price of the day",
"extracted_value": "Float - Lowest price of the day"
},
"day_high": {
"value": "String - Highest price of the day",
"extracted_value": "Float - Highest price of the day"
},
"fifty_two_week_low": {
"value": "String - Lowest price of the last 52 weeks",
"extracted_value": "Float - Lowest price of the last 52 weeks"
},
"fifty_two_week_high": {
"value": "String - Highest price of the last 52 weeks",
"extracted_value": "Float - Highest price of the last 52 weeks"
},
"volume": {
"value": "String - Volume",
"extracted_value": "Integer - Volume"
},
"avg_volume": {
"value": "String - Average volume over 3 months",
"extracted_value": "Integer - Average volume over 3 months"
},
"market_cap": {
"value": "String - Market capitalization (e.g., '5.168T')",
"extracted_value": "Integer - Market capitalization"
},
"fully_diluted_valuation": {
"value": "String - Fully diluted valuation of a cryptocurrency",
"extracted_value": "Integer - Fully diluted valuation"
},
"volume_24h": {
"value": "String - Volume of a cryptocurrency over 24 hours",
"extracted_value": "Integer - Volume over 24 hours"
},
"volume_24h_to_market_cap": {
"value": "String - Volume of a cryptocurrency over 24 hours, as a percentage of its market capitalization (e.g., '1.65%')",
"extracted_value": "Float - Volume over 24 hours to market capitalization, as a fraction"
},
"circulating_supply": {
"value": "String - Circulating supply of a cryptocurrency",
"extracted_value": "Integer - Circulating supply"
},
"total_supply": {
"value": "String - Total supply of a cryptocurrency",
"extracted_value": "Integer - Total supply"
},
"max_supply": {
"value": "String - Maximum supply of a cryptocurrency",
"extracted_value": "Integer - Maximum supply"
},
"all_time_high": {
"value": "String - All-time high of a cryptocurrency",
"extracted_value": "Float - All-time high"
},
"all_time_low": {
"value": "String - All-time low of a cryptocurrency",
"extracted_value": "Float - All-time low"
},
"start_date": "String - Start date of a cryptocurrency (YYYY-MM-DD)",
"settlement_date": "String - Settlement date of futures (YYYY-MM-DD)",
"net_assets": {
"value": "String - Net assets of an ETF or a mutual fund",
"extracted_value": "Integer - Net assets"
},
"nav": {
"value": "String - Net asset value of an ETF",
"extracted_value": "Float - Net asset value"
},
"yield": {
"value": "String - Yield of an ETF or a mutual fund (e.g., '1.00%')",
"extracted_value": "Float - Yield as a fraction"
},
"ytd_return": {
"value": "String - Year-to-date return of an ETF or a mutual fund",
"extracted_value": "Float - Year-to-date return as a fraction"
},
"expense_ratio": {
"value": "String - Expense ratio of an ETF or a mutual fund",
"extracted_value": "Float - Expense ratio as a fraction"
},
"category": "String - Category of an ETF or a mutual fund (e.g., 'Large Blend')",
"morningstar_rating": {
"value": "String - Morningstar rating of a mutual fund",
"extracted_value": "Integer - Morningstar rating, from 1 to 5 stars"
},
"last_dividend": {
"value": "String - Last dividend of a mutual fund",
"extracted_value": "Float - Last dividend"
},
"last_cap_gain": {
"value": "String - Last capital gain of a mutual fund",
"extracted_value": "Float - Last capital gain"
},
"five_year_average_return": {
"value": "String - 5-year average return of a mutual fund",
"extracted_value": "Float - 5-year average return as a fraction"
},
"holdings_turnover": {
"value": "String - Holdings turnover of a mutual fund",
"extracted_value": "Float - Holdings turnover as a fraction"
},
"inception_date": "String - Inception date of an ETF or a mutual fund (YYYY-MM-DD)",
"beta": {
"value": "String - Beta (5Y monthly)",
"extracted_value": "Float - Beta (5Y monthly)"
},
"trailing_pe": {
"value": "String - Price/earnings ratio (TTM)",
"extracted_value": "Float - Price/earnings ratio (TTM)"
},
"diluted_eps": {
"value": "String - Diluted earnings per share (TTM)",
"extracted_value": "Float - Diluted earnings per share (TTM)"
},
"earnings_date": "String - Next earnings date (YYYY-MM-DD)",
"dividend_rate": {
"value": "String - Forward dividend",
"extracted_value": "Float - Forward dividend"
},
"dividend_yield": {
"value": "String - Forward dividend yield (e.g., '0.30%')",
"extracted_value": "Float - Forward dividend yield as a fraction"
},
"ex_dividend_date": "String - Ex-dividend date (YYYY-MM-DD)"
},
"company_overview": {
"description": "String - Description of the company, fund, or cryptocurrency",
"website": "String - Website",
"whitepaper": "String - Whitepaper of a cryptocurrency",
"full_time_employees": "Integer - Number of full-time employees",
"fiscal_year_ends": "String - Month and day of the end of the fiscal year (e.g., 'September 26')",
"sector": "String - Sector",
"industry": "String - Industry"
},
"performance_overview": {
"benchmark": {
"stock": "String - Symbol of the benchmark index of a stock (e.g., '^GSPC')",
"name": "String - Name of the benchmark index (e.g., 'S&P 500'), or category of an ETF or a mutual fund (e.g., 'Large Blend')"
},
"ytd": {
"value": "String - Year-to-date return (e.g., '31.17%')",
"extracted_value": "Float - Year-to-date return as a fraction",
"benchmark": {
"value": "String - Year-to-date return of the benchmark",
"extracted_value": "Float - Year-to-date return of the benchmark as a fraction"
}
},
"one_year": "Hash - 1-year return, with the same keys as ytd",
"two_years": "Hash - 2-year return of a stock, with the same keys as ytd",
"three_years": "Hash - 3-year return, with the same keys as ytd",
"five_years": "Hash - 5-year return of a stock or a mutual fund, with the same keys as ytd"
},
"analyst_insights": {
"price_targets": {
"current": {
"value": "String - Current price",
"extracted_value": "Float - Current price"
},
"target_high": {
"value": "String - Highest price target",
"extracted_value": "Float - Highest price target"
},
"target_low": {
"value": "String - Lowest price target",
"extracted_value": "Float - Lowest price target"
},
"target_avg": {
"value": "String - Average price target",
"extracted_value": "Float - Average price target"
},
"target_median": {
"value": "String - Median price target",
"extracted_value": "Float - Median price target"
},
"number_of_analysts": "Integer - Number of analyst opinions"
},
"recommendation": "String - Overall recommendation (e.g., 'strong_buy', 'buy', 'hold')",
"recommendation_mean": {
"value": "String - Mean recommendation score",
"extracted_value": "Float - Mean recommendation score, from 1 (Strong Buy) to 5 (Sell)"
},
"recommendation_trend": [
{
"period": "String - 'Current Month', '1 Month Ago', '2 Months Ago', or '3 Months Ago'",
"strong_buy": "Integer - Number of Strong Buy ratings",
"buy": "Integer - Number of Buy ratings",
"hold": "Integer - Number of Hold ratings",
"sell": "Integer - Number of Underperform ratings",
"strong_sell": "Integer - Number of Sell ratings"
}
],
"latest_rating": {
"date": "String - Date of the rating (YYYY-MM-DD)",
"firm": "String - Analyst firm",
"to_grade": "String - New rating",
"from_grade": "String - Previous rating",
"action": "String - Rating action: 'Upgrade', 'Downgrade', 'Initiated', 'Maintains', or 'Reiterates'",
"price_target_action": "String - Price target action (e.g., 'Raises', 'Lowers', 'Maintains')",
"current_price_target": "Float - New price target",
"prior_price_target": "Float - Previous price target"
}
},
"earnings": {
"quarterly": [
{
"date": "String - Calendar quarter (e.g., '4Q2025')",
"fiscal_quarter": "String - Fiscal quarter (e.g., '1Q2026')",
"actual": {
"value": "String - Actual earnings per share",
"extracted_value": "Float - Actual earnings per share"
},
"estimate": {
"value": "String - Estimated earnings per share",
"extracted_value": "Float - Estimated earnings per share"
},
"difference": "Float - Actual minus estimated earnings per share",
"surprise_percent": "Float - Earnings surprise, in percent",
"period_end_date": "String - End date of the quarter (YYYY-MM-DD)",
"reported_date": "String - Date of the report (YYYY-MM-DD)"
}
],
"current_quarter": {
"estimate": {
"value": "String - Estimated earnings per share",
"extracted_value": "Float - Estimated earnings per share"
},
"estimate_date": "String - Quarter of the estimate (e.g., '4Q')",
"estimate_year": "Integer - Year of the estimate",
"fiscal_quarter": "String - Fiscal quarter",
"calendar_quarter": "String - Calendar quarter",
"period_end_date": "String - End date of the quarter (YYYY-MM-DD)"
},
"next_earnings_date": "String - Next earnings date (YYYY-MM-DD)",
"yearly_financials": [
{
"year": "Integer - Fiscal year",
"revenue": {
"value": "String - Revenue of the year",
"extracted_value": "Integer - Revenue of the year"
},
"earnings": {
"value": "String - Earnings of the year",
"extracted_value": "Integer - Earnings of the year"
},
"profit_margin": {
"value": "String - Profit margin of the year (e.g., '25.31%')",
"extracted_value": "Float - Profit margin of the year as a fraction"
}
}
],
"quarterly_financials": [
{
"date": "String - Calendar quarter (e.g., '4Q2025')",
"fiscal_quarter": "String - Fiscal quarter (e.g., '1Q2026')",
"revenue": {
"value": "String - Revenue of the quarter",
"extracted_value": "Integer - Revenue of the quarter"
},
"earnings": {
"value": "String - Earnings of the quarter",
"extracted_value": "Integer - Earnings of the quarter"
},
"profit_margin": {
"value": "String - Profit margin of the quarter (e.g., '29.28%')",
"extracted_value": "Float - Profit margin of the quarter as a fraction"
}
}
],
"is_earnings_date_estimate": "Boolean - Whether the next earnings date is an estimate"
},
"key_statistics": {
"valuation_measures": {
"market_cap": {
"value": "String - Market capitalization",
"extracted_value": "Integer - Market capitalization"
},
"enterprise_value": "Hash - Enterprise value, with the same keys as market_cap",
"trailing_pe": "Hash - Trailing price/earnings ratio",
"forward_pe": "Hash - Forward price/earnings ratio",
"peg_ratio": "Hash - PEG ratio (5Y expected)",
"price_to_sales": "Hash - Price/sales ratio (TTM)",
"price_to_book": "Hash - Price/book ratio (MRQ)",
"enterprise_to_revenue": "Hash - Enterprise value/revenue ratio",
"enterprise_to_ebitda": "Hash - Enterprise value/EBITDA ratio"
},
"financial_highlights": {
"profit_margin": {
"value": "String - Profit margin (e.g., '27.60%')",
"extracted_value": "Float - Profit margin as a fraction"
},
"return_on_assets": "Hash - Return on assets (TTM), with the same keys as profit_margin",
"return_on_equity": "Hash - Return on equity (TTM)",
"revenue": "Hash - Revenue (TTM)",
"net_income_to_common": "Hash - Net income available to common shareholders (TTM)",
"diluted_eps": "Hash - Diluted earnings per share (TTM)",
"total_cash": "Hash - Total cash (MRQ)",
"total_debt_to_equity": "Hash - Total debt/equity (MRQ), with the same keys as profit_margin",
"levered_free_cash_flow": "Hash - Levered free cash flow (TTM)"
}
},
"people_also_watch": [
{
"stock": "String - Symbol of the quote",
"link": "String - Link to the quote on Yahoo! Finance",
"serpapi_link": "String - SerpApi link to search the quote",
"name": "String - Name of the quote, when the page has its quote",
"price": "String - Latest price, pre-market and after hours included, as Yahoo! Finance shows it",
"extracted_price": "Float - Latest price",
"price_movement": {
"percentage": "Float - Change since the previous close, in percent",
"value": "Float - Change since the previous close",
"movement": "String - 'Up' or 'Down', unless the price didn't change"
}
}
],
"trending_tickers": "Array - Trending quotes, with the same keys as people_also_watch",
"market_summary": "Array - Markets of the market bar, with the same keys as people_also_watch",
"suggestions": [
{
"stock": "String - Symbol of the quote",
"link": "String - Link to the quote on Yahoo! Finance",
"serpapi_link": "String - SerpApi link to search the quote",
"name": "String - Name of the quote",
"exchange": "String - Code of the exchange (e.g., 'NMS')",
"quote_type": "String - Type of the quote: 'Equity', 'ETF', 'Fund', 'Index', 'Cryptocurrency', 'Currency', or 'Futures'",
"sector": "String - Sector",
"price": "String - Latest price, pre-market and after hours included",
"extracted_price": "Float - Latest price",
"price_movement": {
"percentage": "Float - Change since the previous close, in percent",
"value": "Float - Change since the previous close",
"movement": "String - 'Up' or 'Down', unless the price didn't change"
}
}
]
}