{"uid":"cap_BZcz1kejQvwO-bvKZnrID","slug":"yahoo-finance-scraper-structured-stock-financial-data-def7462d","name":"Yahoo Finance Scraper — Structured Stock & Financial Data","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/yahoo-finance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tickers":{"type":"array","description":"Yahoo Finance ticker symbols. Each symbol produces one dataset item."},"end_date":{"type":"string","description":"Last calendar date to include in daily price history (YYYY-MM-DD), inclusive. Defaults to today."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many ticker records across the run. Zero means all supplied tickers."},"start_date":{"type":"string","description":"First calendar date to include in daily price history (YYYY-MM-DD). Defaults to one year ago."},"includeNews":{"type":"boolean","default":true,"description":"Fetch recent ticker headlines from the public finance news feed."},"includeHolders":{"type":"boolean","default":false,"description":"Fetch public institutional and fund holdings plus ownership summary."},"includeOptions":{"type":"boolean","default":false,"description":"Fetch expiration dates and calls and puts for the nearest expiry."},"maxNewsPerTicker":{"type":"integer","default":10,"maximum":50,"minimum":0,"description":"Maximum recent news items saved for each ticker."},"includeFinancials":{"type":"boolean","default":true,"description":"Fetch annual and quarterly income, balance sheet, and cash flow summaries."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"sector":null,"ticker":null,"currency":null,"exchange":null,"industry":null,"quoteUrl":null,"quoteType":null}],"product":"yahoo-finance"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_reCdP9hY8a_4Zq8znq0g6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured financial data for one or more stock tickers from Yahoo Finance, including price history, financials, news, holders, and options.","exampleAgentPrompt":"Pull Yahoo Finance data for AAPL, MSFT, and NVDA — I want daily price history from 2024-01-01 to 2024-12-31, their income statements and balance sheets, and the 10 most recent news headlines for each.","exampleUseCases":[{"title":"Portfolio price history analysis","prompt":"Fetch daily price history for TSLA, AMZN, and GOOGL from 2023-06-01 to 2024-06-01 from Yahoo Finance so I can analyze their performance over the past year."},{"title":"Earnings research with financials","prompt":"Get me the annual and quarterly income statements, balance sheets, and cash flow data for JPM and BAC from Yahoo Finance — I'm doing a banking sector comparison."},{"title":"Institutional ownership deep dive","prompt":"Pull the institutional and fund holders data for NVDA from Yahoo Finance, along with the latest 10 news headlines — I want to see who's holding it and what's been in the news recently."}],"resultDescription":"Returns a JSON object with a count and an array of items, one per ticker. Each item includes ticker symbol, company name, sector, industry, exchange, currency, quote type, and quote URL, plus optional arrays for daily price history, financial statements (income, balance sheet, cash flow), recent news headlines, institutional/fund holders, and nearest-expiry options (calls and puts).","failureModes":["Invalid or delisted ticker symbol returns empty item or null fields","Date range with no trading days (e.g. holidays only) returns empty price history","Yahoo Finance rate limiting or anti-scraping measures may cause failed runs (not charged)","Malformed date format (not YYYY-MM-DD) may cause errors","maxItems=0 with a large ticker list may take longer and time out"],"whenToPreferThis":"Choose this endpoint when you need structured, multi-dimensional Yahoo Finance data for one or more tickers in a single call — especially when you want to combine price history, financials, news, and holders without stitching together multiple APIs. It is pay-per-call with no charge on failed or empty runs, making it safe for exploratory queries. Prefer it over general web scraping when Yahoo Finance is the authoritative source you need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:45:31.828Z","isFirstParty":false,"canonicalSlug":"yahoo-finance-scraper-structured-stock-financial-data-def7462d"}