# Yahoo Finance Scraper - Most Comprehensive (`kaix/yahoo-finance-scraper`) Actor
🔥 ~$0.5/1K stocks 🔥 Scrape Yahoo Finance for stock quotes, financials, charts, news, options, and more
- **URL**: https://apify.com/kaix/yahoo-finance-scraper.md
- **Developed by:** [Kai](https://apify.com/kaix) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 392 total users, 83 monthly users, 99.2% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.40 / 1,000 stocks
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
## Yahoo Finance Scraper
Collect Yahoo Finance market and company data for stocks, ETFs, indices,
cryptocurrencies, currencies, futures, and mutual funds. Provide symbols or
discover them by search, trending results, or a predefined screener.
### Choose a symbol source
| What you have | Input | Result order |
|---|---|---|
| Exact Yahoo Finance symbols | `symbols` | Supplied order, including repetitions |
| A company, fund, or instrument name | `searchQuery` | Yahoo Finance search order |
| A market region | `trending` and `trendingRegion` | Yahoo Finance trending order |
| A predefined market list | `screener` | Yahoo Finance screener order |
Use one source per run. If you supply more than one, the Actor uses the first
populated source in this table.
### Choose the record contents
Most data sections are on by default. Ownership and options are off by default.
| Data you need | Input |
|---|---|
| Current quote fields | `includeQuote` |
| Company or fund profile | `includeProfile` |
| Financial time series | `includeFinancials` |
| Chart series and events | `includeChart` |
| News and related symbols | `includeNews`, `includeRecommendations` |
| Research and technical events | `includeInsights` |
| Analyst, rating, and calendar data | `includeAnalyst` |
| Ownership data | `includeOwnership` |
| Option chains | `includeOptions` |
### Build a market record
In Apify Console, select **Input**, paste an example, and select **Run**. Open
the default Dataset when the run finishes. Each resolved symbol has one
combined record.
Look up one symbol with the default sections:
```json
{
"symbols": ["AAPL"]
}
```
Look up several instrument types and return quotes only:
```json
{
"symbols": ["SPY", "^GSPC", "BTC-USD", "EURUSD=X", "GC=F", "VFIAX"],
"includeProfile": false,
"includeFinancials": false,
"includeChart": false,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false
}
```
Discover up to two symbols by search:
```json
{
"searchQuery": "Apple",
"maxSearchResults": 2
}
```
Fetch a custom chart window without populating the quote field:
```json
{
"symbols": ["AAPL"],
"includeQuote": false,
"includeProfile": false,
"includeFinancials": false,
"includeChart": true,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"chartStartDate": "2026-07-01",
"chartEndDate": "2026-07-15",
"chartInterval": "1d"
}
```
Fetch options for a specific expiration:
```json
{
"symbols": ["AAPL"],
"includeOptions": true,
"optionDates": ["2026-12-18"]
}
```
### Input
The symbol-source precedence is `symbols`, `searchQuery`, `trending`, and
`screener`. `maxSearchResults` limits discovery results, but it does not limit a
direct `symbols` array.
| Field | Type | Default | Behaviour |
| --- | --- | --- | --- |
| `symbols` | string\[] | | Yahoo Finance symbols. Direct values retain their supplied order and repetitions. |
| `searchQuery` | string | | Text for symbol discovery. The Actor keeps Yahoo Finance order and removes repeated discovered symbols. |
| `trending` | boolean | `false` | Set to `true` to use trending-symbol discovery. |
| `trendingRegion` | string | `US` | Region for trending discovery. This field does not replace `region`. |
| `screener` | enum | | A supported predefined screener. |
| `maxSearchResults` | integer | `10` | Maximum number of symbols kept from search, trending, or screener discovery. Range: 1 to 50. |
| `includeQuote` | boolean | `true` | Include the quote object when data is available. |
| `includeProfile` | boolean | `true` | Include the company or fund profile when data is available. |
| `includeFinancials` | boolean | `true` | Include annual and quarterly financial time-series rows when data is available. |
| `includeChart` | boolean | `true` | Include chart metadata, OHLCV rows, adjusted close values, and available events. |
| `includeNews` | boolean | `true` | Include symbol-related news items. |
| `maxNewsResults` | integer | `10` | Maximum number of news items per symbol. Range: 1 to 200. Yahoo returns at most 50 news items per symbol, and most symbols return fewer, so a value above 50 returns the same items as 50. |
| `includeRecommendations` | boolean | `true` | Include related symbols and their scores. |
| `includeInsights` | boolean | `true` | Include research, price insight, and technical-event sections. |
| `includeAnalyst` | boolean | `true` | Include analyst, consensus, rating, calendar, and scheduled-event sections. |
| `includeOwnership` | boolean | `false` | Include holder, institution, fund, and transaction sections when data is available. |
| `includeOptions` | boolean | `false` | Include the options chain. |
| `optionAllExpirations` | boolean | `false` | Fetch all available expirations. If this is `true`, this branch takes precedence over `optionDates`. |
| `optionDates` | string\[] | | Requested expiration date strings. If this array is absent or empty, the Actor returns the nearest available expiration. |
| `chartRange` | enum | `1mo` | `1d`, `5d`, `1mo`, `3mo`, `6mo`, `1y`, `2y`, `5y`, `10y`, `ytd`, or `max`. |
| `chartStartDate` | string | | Start value for a custom chart window. The custom-window branch needs both date fields. One date by itself is accepted and `chartRange` is used. |
| `chartEndDate` | string | | End value for a custom chart window. The Actor uses both date strings when both fields are present. |
| `chartInterval` | enum | `1d` | `1m`, `5m`, `15m`, `30m`, `1h`, `1d`, `1wk`, or `1mo`. |
| `lang` | string | `en-US` | Language locale for returned data. |
| `region` | string | `US` | Market-data region. |
| `proxyConfiguration` | object | Apify Proxy | Connection settings for the run. |
When both custom chart dates are present, they replace `chartRange`. The input contract accepts date strings without a syntax or order check. Yahoo Finance can reject a date or interval combination that it does not support.
View all supported screener values
| Group | `screener` values |
|---|---|
| Stocks | `DAY_GAINERS`, `DAY_LOSERS`, `MOST_ACTIVES`, `MOST_SHORTED_STOCKS`, `UNDERVALUED_GROWTH_STOCKS`, `GROWTH_TECHNOLOGY_STOCKS`, `AGGRESSIVE_SMALL_CAPS`, `SMALL_CAP_GAINERS` |
| Cryptocurrencies | `ALL_CRYPTOCURRENCIES_US`, `DAY_GAINERS_CRYPTOCURRENCIES`, `DAY_LOSERS_CRYPTOCURRENCIES`, `MOST_ACTIVES_CRYPTOCURRENCIES` |
| Private companies | `HIGHEST_VALUATION_PRIVATE_COMPANY`, `WEEK_GAINERS_PRIVATE_COMPANY`, `RECENTLY_FUNDED_PRIVATE_COMPANY`, `MOST_FUNDED_PRIVATE_COMPANY` |
| Funds | `TOP_MUTUAL_FUNDS`, `DAY_GAINERS_MUTUAL_FUNDS`, `PORTFOLIO_ANCHORS`, `SOLID_LARGE_GROWTH_FUNDS`, `SOLID_MIDCAP_GROWTH_FUNDS`, `CONSERVATIVE_FOREIGN_FUNDS`, `HIGH_YIELD_BOND` |
#### Complete input examples
View examples for sections and discovery methods
Together, these examples cover every input field.
##### AAPL input with all data sections and one option date
```jsonc
{
"symbols": [
"AAPL"
],
"includeQuote": true,
"includeProfile": true,
"includeFinancials": true,
"includeChart": true,
"includeNews": true,
"includeRecommendations": true,
"includeInsights": true,
"includeAnalyst": true,
"includeOwnership": true,
"includeOptions": true,
"optionAllExpirations": false,
"optionDates": [
"2026-12-18"
],
"chartStartDate": "2025-08-01",
"chartEndDate": "2026-08-01",
"chartInterval": "1wk",
"maxNewsResults": 3,
"lang": "en-US",
"region": "US",
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
##### Mutual fund with a long chart range
```jsonc
{
"symbols": [
"VFIAX"
],
"includeQuote": true,
"includeProfile": true,
"includeFinancials": false,
"includeChart": true,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": false,
"chartRange": "10y",
"chartInterval": "1mo"
}
```
##### Search discovery
```jsonc
{
"searchQuery": "Apple",
"maxSearchResults": 1,
"includeQuote": true,
"includeProfile": false,
"includeFinancials": false,
"includeChart": false,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": false
}
```
##### Trending discovery with a separate locale and region
```jsonc
{
"trending": true,
"trendingRegion": "GB",
"maxSearchResults": 1,
"includeQuote": true,
"includeProfile": false,
"includeFinancials": false,
"includeChart": false,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": false,
"lang": "en-GB",
"region": "GB"
}
```
##### Screener discovery
```jsonc
{
"screener": "DAY_GAINERS",
"maxSearchResults": 1,
"includeQuote": true,
"includeProfile": false,
"includeFinancials": false,
"includeChart": false,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": false
}
```
##### All available option expirations
```jsonc
{
"symbols": [
"AAPL"
],
"includeQuote": true,
"includeProfile": false,
"includeFinancials": false,
"includeChart": false,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": true,
"optionAllExpirations": true
}
```
##### Known and unknown symbols in one request
```jsonc
{
"symbols": [
"AAPL",
"UNKNOWN-SYMBOL"
],
"includeQuote": true,
"includeProfile": false,
"includeFinancials": false,
"includeChart": true,
"includeNews": false,
"includeRecommendations": false,
"includeInsights": false,
"includeAnalyst": false,
"includeOwnership": false,
"includeOptions": false,
"chartRange": "5d",
"chartInterval": "1d"
}
```
### Output
The default dataset contains one `symbol` record for each resolved symbol.
Direct symbols keep their supplied order and repetitions. Discovery results
keep Yahoo Finance order, remove repeated symbols, and stop at
`maxSearchResults`.
Each record uses the same top-level shape. A data section is `null` when you
disable it, it does not apply to the instrument, or Yahoo Finance returns no
data for it.
| Field | Type | Meaning |
| --- | --- | --- |
| `recordType` | string | Always `symbol`. |
| `status` | string | `complete`, `partial`, or `not_found`. |
| `failedSections` | string\[] | Names of sections that could not be collected. |
| `symbol` | string | The direct or discovered Yahoo Finance symbol. |
| `quote` | object or null | Quote fields. Controlled by `includeQuote`. |
| `profile` | object or null | Company or fund profile. Controlled by `includeProfile`. |
| `financials` | object or null | Financial time-series rows. Controlled by `includeFinancials`. |
| `chart` | object or null | Chart metadata, series, and events. Controlled by `includeChart`. |
| `news` | object\[] or null | News items. Controlled by `includeNews`. |
| `recommendations` | object\[] or null | Related symbols and scores. Controlled by `includeRecommendations`. |
| `insights` | object or object\[] or null | Research and event data. Controlled by `includeInsights`. |
| `priceInsights` | object or null | Symbol price-insight data. Controlled by `includeInsights`. |
| `options` | object or null | Option expiration and contract data. Controlled by `includeOptions`. |
| `ownership` | object or null | Ownership data. Controlled by `includeOwnership`. |
| `analyst` | object or null | Analyst and earnings data. Controlled by `includeAnalyst`. |
| `analystConsensus` | object or null | Generated analyst insights. Controlled by `includeAnalyst`. |
| `ratings` | object or null | Four rating slots. Controlled by `includeAnalyst`. |
| `technicalEvents` | object or null | Technical summary and event rows. Controlled by `includeInsights`. |
| `keyStatistics` | object or null | Key statistics and summary values. Available when profile, analyst, or ownership data is requested. |
| `calendarEvents` | object or null | Earnings and dividend calendar values. Available with `keyStatistics`. |
| `scheduledEvents` | object or null | Earnings and economic event days. Controlled by `includeAnalyst`. |
| `marketSummary` | object\[] or null | Run-level market rows copied to each symbol record. |
| `sectors` | object or null | Run-level sector summary copied to each symbol record. |
Use `status` to decide how to process a record:
- `complete`: no requested section failed. A section can still be `null`.
- `partial`: usable data was saved, and `failedSections` lists sections that
could not be collected.
- `not_found`: quote or chart identity data was requested, but neither was
available.
A discovery search that completes with no matches saves an empty Dataset. If
the discovery search or a Dataset write cannot complete, the run stops. If one
data section fails, the Actor saves a `partial` record for that symbol and
continues with other symbols.
#### Selected recorded fields at a glance
The values below are unchanged fields from a recorded AAPL run on 29 July 2026.
Other sections and array items are not shown, so this is not a saved Dataset
item.
```jsonc
{
"recordType": "symbol",
"status": "complete",
"failedSections": [],
"symbol": "AAPL",
"quote": {
"symbol": "AAPL",
"shortName": "Apple Inc.",
"quoteType": "EQUITY",
"currency": "USD",
"regularMarketPrice": 338.19,
"regularMarketPreviousClose": 340.08,
"regularMarketVolume": 48852885,
"marketState": "POST"
},
"chart": {
"meta": {
"symbol": "AAPL",
"currency": "USD",
"instrumentType": "EQUITY",
"regularMarketPrice": 338.19,
"dataGranularity": "1d",
"range": "5d"
},
"series": [
{
"timestamp": 1784813400,
"date": "2026-07-23T13:30:00.000Z",
"open": 321.7300109863281,
"high": 323.29998779296875,
"low": 319.3500061035156,
"close": 321.6600036621094,
"volume": 40840800,
"adjclose": 321.6600036621094
}
]
}
}
```
#### Field reference
Yahoo Finance can add keys to some objects. The Actor keeps those keys. The
tables below list the declared fields and their JSON types. A `?` after a field
name means that the field can be absent. `or null` means that the field can be
present with a `null` value. An open object can contain other keys that Yahoo
Finance defines, with any JSON value. The top-level section types and nullability are in the
table above.
View nested fields for all data sections
##### Quote, profile, financials, chart, and news
| Path | Field types |
| --- | --- |
| `quote` | `symbol`: string. Optional strings: `shortName?`, `longName?`, `quoteType?`, `currency?`, `exchange?`, `fullExchangeName?`, `market?`, `marketState?`, and `fiftyTwoWeekRange?`. Optional numbers: `regularMarketPrice?`, `regularMarketChange?`, `regularMarketChangePercent?`, `regularMarketOpen?`, `regularMarketDayHigh?`, `regularMarketDayLow?`, `regularMarketVolume?`, `regularMarketPreviousClose?`, `fiftyTwoWeekHigh?`, `fiftyTwoWeekLow?`, `marketCap?`, `trailingPE?`, `forwardPE?`, `epsTrailingTwelveMonths?`, `epsForward?`, `dividendRate?`, `dividendYield?`, `sharesOutstanding?`, `bookValue?`, `averageDailyVolume3Month?`, `fiftyDayAverage?`, `twoHundredDayAverage?`, `postMarketPrice?`, `postMarketChange?`, `preMarketPrice?`, and `preMarketChange?`. Other quote keys can contain a string, number, boolean, array, or `null`. |
| `profile` | Optional strings: `address1?`, `city?`, `state?`, `zip?`, `country?`, `phone?`, `website?`, `sector?`, `industry?`, and `longBusinessSummary?`. `fullTimeEmployees?`: number. The profile is open and can contain more keys. |
| `profile.companyOfficers?[]` | `name`, `title`: string; `age?`, `totalPay?`: number. |
| `profile.topHoldings?` | Object with `holdings`: object\[]. Each item has `symbol`, `holdingName`: string and `holdingPercent`: number. The object can contain more keys that Yahoo Finance defines. |
| `profile.fundProfile?` | Object with `family`, `categoryName`: string and `legalType`: string or `null`. The object can contain more keys that Yahoo Finance defines. |
| `profile.fundPerformance?`, `profile.esgScores?` | Open objects. Yahoo Finance defines their child keys and nullability. |
| `financials` | `income`, `balanceSheet`, `cashFlow`: object\[]. Each row has `asOfDate`, `periodType`, `currencyCode`: string. Other measure values are number or `null`. |
| `chart.meta` | Optional strings: `currency?`, `symbol?`, `exchangeName?`, `fullExchangeName?`, `instrumentType?`, `dataGranularity?`, and `range?`. `regularMarketPrice?`, `chartPreviousClose?`: number. `validRanges?`: string\[]. The object can contain more keys that Yahoo Finance defines. |
| `chart.series[]` | `timestamp`: number; `date`: string; `open`, `high`, `low`, `close`, `volume`, `adjclose`: number or `null`. |
| `chart.events?` | Optional arrays: `dividends?` has numeric `amount` and `date`; `splits?` has numeric `date`, `numerator`, `denominator` and string `splitRatio`; `capitalGains?` and `earnings?` have numeric `amount` and `date`. |
| `news[]` | `uuid`, `title`, `description`, `link`, `pubDate`: string or `null`; `providerPublishTime`: number or `null`; `publisher?`: string or `null`; `type?`: string; `relatedTickers?`: string\[]; `thumbnail?`: object. |
| `news[].thumbnail.resolutions?[]` | `url`: string; `width`, `height`: number; `tag?`: string. |
| `recommendations[]` | `symbol`: string; `score`: number. |
##### Insights, options, ownership, and analyst data
| Path | Field types |
| --- | --- |
| Each `insights` object | `symbol?`: string; `events?`, `reports?`, `sigDevs?`: object\[]. The object is open and can contain more keys that Yahoo Finance defines. |
| `insights.events?[]` | `eventType`, `pricePeriod`, `tradingHorizon`, `tradeType`: string; `startDate`, `endDate`: number. |
| `insights.reports?[]` | `id`, `provider`, `reportDate`, `reportTitle`: string; `headHtml?`: string; `tickers?`: string\[]. |
| `insights.sigDevs?[]` | `headline`, `date`: string. |
| `priceInsights` | Open object with optional `symbol?`: string. The object can use the symbol as a dynamic key. |
| `options` | `underlyingSymbol`: string; `expirationDates`, `strikes`: number\[]; `hasMiniOptions`: boolean; `quote?`: quote object; `options`: object\[]. |
| `options.options[]` | `expirationDate`: number; `hasMiniOptions`: boolean; `calls`, `puts`: option-contract arrays. |
| Each call or put | `contractSymbol`, `currency`: string; `strike`: number; `inTheMoney`: boolean. Optional nullable numbers: `lastPrice?`, `change?`, `percentChange?`, `volume?`, `openInterest?`, `bid?`, `ask?`, `expiration?`, `lastTradeDate?`, and `impliedVolatility?`. `contractSize?`: string or `null`. |
| `ownership` | Optional objects: `insiderHolders?`, `institutionOwnership?`, `fundOwnership?`, `majorHoldersBreakdown?`, `insiderTransactions?`, `netSharePurchaseActivity?`, and `majorDirectHolders?`. |
| `ownership.insiderHolders?.holders[]` | `name`, `relation`, `transactionDescription`: string; `latestTransDate`, `positionDirect`: number. |
| Institution and fund ownership rows | `organization`: string; `pctHeld`, `position`, `value`: number. Rows are in `institutionOwnership?.ownershipList[]` and `fundOwnership?.ownershipList[]`. |
| `ownership.majorHoldersBreakdown?` | `insidersPercentHeld`, `institutionsPercentHeld`, `institutionsFloatPercentHeld`, `institutionsCount`: number. |
| `ownership.insiderTransactions?.transactions[]` | `filerName`, `transactionText`: string; `startDate`, `shares`, `value`: number. |
| `ownership.netSharePurchaseActivity?` | `buyInfoCount`, `sellInfoCount`, `buyInfoShares`, `sellInfoShares`: number. Yahoo Finance can add more measures. |
| `ownership.majorDirectHolders?.holders[]` | `name`: string. |
| `analyst` | Every object below is optional and can be absent. |
| `analyst.recommendationTrend?.trend[]` | `period`: string; `strongBuy`, `buy`, `hold`, `sell`, `strongSell`: number. |
| `analyst.upgradeDowngradeHistory?.history[]` | `epochGradeDate`: number; `firm`, `toGrade`, `fromGrade`, `action`: string; `priceTargetAction?`: string; `currentPriceTarget?`, `priorPriceTarget?`: number. |
| `analyst.earnings?.earningsChart` | `quarterly`: object\[]; `currentQuarterEstimate`: number; `currentCalendarQuarter`: string; `earningsDate?`: number\[]. Each quarterly item has `date`: string, `actual`, `estimate`: number, and optional string fields `fiscalQuarter?`, `calendarQuarter?`, `difference?`, `surprisePct?`. |
| `analyst.earnings?.financialsChart` | `yearly`: object\[] with numeric `date`, `revenue`, `earnings`; `quarterly`: object\[] with string `date`, `fiscalQuarter` and numeric `revenue`, `earnings`. `analyst.earnings.financialCurrency`: string. |
| `analyst.earningsHistory?.history[]` | `epsActual`, `epsEstimate`, `epsDifference`, `surprisePercent`, `quarter`: number; `period`: string. |
| `analyst.earningsTrend?.trend[]` | `period`, `endDate`: string; `growth`: number; `earningsEstimate`, `revenueEstimate`: open objects. |
| Other earnings objects | `earningsGaap?`, `earningsNonGaap?`, `earningsTrendGaap?`, `earningsTrendNonGaap?`, `earningsHistoryGaap?`, and `earningsHistoryNonGaap?` are open objects. |
| `analyst.secFilings?.filings[]` | `date`, `type`, `title`, `edgarUrl`: string; `epochDate`: number; `exhibits?`: object\[] with string `type` and `url`. |
| `analyst.earningsCallTranscripts?.transcripts[]` | `title`, `fiscalYear`, `fiscalPeriod`, `date`: string. |
| `analystConsensus` | Open object. Optional open objects are `options_analysis?`, `news_summary?`, `holdings_insights?`, `overview?`, `rtr?`, `financial_insights?`, `earnings_transcripts_insights?`, and `price_movement?`. |
| `ratings` | Required rating slots: `dir`, `mm`, `pt`, and `fin_score`. Each slot uses the rating shape below. |
| Each rating slot | `analyst`, `ticker`, `uuid`, `rating_current`, `announcement_date`: string; `datapoints`, `rating_sentiment`, `pt_current`, `adjusted_pt_current`: number; `dir`, `mm`, `pt`, `fin_score`: objects with numeric `raw` and `fmt`. |
##### Technical, statistics, calendar, and market data
| Path | Field types |
| --- | --- |
| `technicalEvents` | `total`: number; `technicalEvents`: object; `events`: object\[]. The summary has `shortTerm`, `midTerm`, `longTerm`: string and `support`, `resistance`, `stopLoss`: number. |
| `technicalEvents.events[]` | `endDate`, `duration`: number; `eventType`, `pricePeriod`, `tradingHorizon`, `tradeType`: string; `priceDate?`: number; `priceHigh?`, `priceLow?`, `priceOpen?`, `priceClose?`: objects with numeric `raw` and string `fmt`. |
| `keyStatistics` | Optional objects: `defaultKeyStatistics?`, `financialData?`, `summaryDetail?`, `indexTrend?`, `sectorTrend?`, `industryTrend?`, `pageViews?`, `price?`, `quoteType?`, `financialsTemplate?`, `equityPerformance?`, `quoteUnadjustedPerformanceOverview?`, and `corporateActions?`. |
| `keyStatistics.defaultKeyStatistics?` | Numeric fields: `enterpriseValue`, `forwardPE`, `profitMargins`, `beta`, `sharesOutstanding`, `trailingEps`, `forwardEps`, `pegRatio`, `shortRatio`, `heldPercentInstitutions`, and `earningsQuarterlyGrowth`. The object can contain more keys that Yahoo Finance defines. |
| `keyStatistics.financialData?` | `recommendationKey`: string. Numeric fields: `currentPrice`, `targetHighPrice`, `targetLowPrice`, `targetMeanPrice`, `numberOfAnalystOpinions`, `totalRevenue`, `revenueGrowth`, `grossMargins`, `operatingMargins`, `returnOnEquity`, `totalCash`, `totalDebt`, and `debtToEquity`. The object can contain more keys that Yahoo Finance defines. |
| `keyStatistics.summaryDetail?`, `keyStatistics.price?` | Open objects. Yahoo Finance defines their child keys and nullability. |
| Trend objects | `indexTrend?` has `symbol`: string. `sectorTrend?` and `industryTrend?` have `symbol`: string or `null`. Each object has `estimates`: object\[] with string `period` and numeric `growth`. |
| `keyStatistics.pageViews?` | `shortTermTrend`, `midTermTrend`, `longTermTrend`: string. |
| `keyStatistics.quoteType?` | `exchange`, `quoteType`, `symbol`, `shortName`, `longName`: string. Yahoo Finance can add more keys. |
| `keyStatistics.financialsTemplate?` | `code`: string. |
| Performance objects | `equityPerformance?` and `quoteUnadjustedPerformanceOverview?` each have `benchmark`, `performanceOverview`, and `performanceOverviewBenchmark`. `benchmark` has string `symbol` and `shortName`. |
| Each performance overview | Required numbers: `asOfDate`, `fiveDaysReturn`, `oneMonthReturn`, `threeMonthReturn`, `sixMonthReturn`, `ytdReturnPct`, and `oneYearTotalReturn`. Optional numbers: `twoYearTotalReturn?`, `threeYearTotalReturn?`, `fiveYearTotalReturn?`, `tenYearTotalReturn?`, and `maxReturn?`. |
| `keyStatistics.corporateActions?` | `corporateActions`: array of open items that Yahoo Finance defines. |
| `calendarEvents` | Optional fields: `earnings?`: object; `exDividendDate?`, `dividendDate?`: number. |
| `calendarEvents.earnings?` | `earningsDate`: number\[]; `earningsCallDate?`: number\[]; `isEarningsDateEstimate`: boolean; `earningsAverage`, `earningsLow`, `earningsHigh`, `revenueAverage`, `revenueLow`, `revenueHigh`: number. |
| `scheduledEvents` | Optional arrays: `earnings?` and `economicEvents?`. Each day has `timestamp`, `count`, `totalCount`: number; `timestampString`, `timezone`: string; `records`: array of open items that Yahoo Finance defines. |
| `marketSummary[]` | `symbol`, `fullExchangeName`, `quoteType`: string; `shortName?`: string; `regularMarketPrice`, `regularMarketChange`, `regularMarketChangePercent`, `regularMarketPreviousClose`: formatted-value objects. Each row can contain more keys that Yahoo Finance defines. |
| Formatted-value object | `raw`: number; `fmt`: string; `longFmt?`: string. |
| `sectors` | `marketCap`: formatted-value object; `sectorsCount`, `industriesCount`: number; `description`: string; `list`: object\[]. |
| `sectors.list[]` | `name`: string; `symbol?`: string; `regMarketChangePercent`, `ytdReturn`, `marketWeight`: formatted-value objects. |
#### Missing and optional values
Some fields can be absent, empty, or `null`. The Actor keeps the form that
Yahoo Finance uses.
| Group | Behaviour |
| --- | --- |
| Failure list | `failedSections[]` is empty when no section fails. |
| Pre-market quote values | `quote.preMarketPrice`, `quote.preMarketChange`, and the same two fields under `options.quote` are optional. |
| Chart event children | `splits[]` (`date`, `numerator`, `denominator`, `splitRatio`), `capitalGains[]` (`amount`, `date`), and `earnings[]` (`date`, `amount`) can be empty. |
| Optional news children | `publisher`, `type`, `thumbnail.resolutions[]` (`url`, `width`, `height`, `tag`), and `relatedTickers[]` can be absent. |
| Insight object form | `insights` can be one object or an array. Both forms use the stable `symbol`, `events[]`, `reports[]`, and `sigDevs[]` fields. |
| Price insight symbol | `priceInsights` can use the symbol as a dynamic key instead of a `symbol` child. |
| Direct-holder name | The name value in `majorDirectHolders.holders[]` is optional. |
| Technical event prices | `priceHigh`, `priceLow`, and `priceOpen`, with `raw` and `fmt` children, are optional. |
| Sector and industry trend estimates | The `period` and `growth` children can be absent from these estimate arrays. |
| Optional formatted long values | Market-summary and sector-list value objects can omit `longFmt`. |
#### Selected all-section fields
View the AAPL field example
This redacted AAPL example shows every top-level key. Long arrays contain one
item, and open objects contain selected fields. Square-bracket strings are
documentation markers. This is not a saved Dataset item.
```json
{
"recordType": "symbol",
"status": "complete",
"failedSections": [],
"symbol": "AAPL",
"quote": {
"symbol": "AAPL",
"shortName": "Apple Inc.",
"quoteType": "EQUITY",
"currency": "USD",
"exchange": "NMS",
"fullExchangeName": "NasdaqGS",
"marketState": "CLOSED",
"regularMarketPrice": 305.93,
"regularMarketChange": 0.669983,
"regularMarketChangePercent": 0.219479,
"regularMarketVolume": 26054077,
"regularMarketPreviousClose": 305.26,
"marketCap": 4464797286400
},
"profile": {
"website": "https://www.apple.com",
"sector": "Technology",
"industry": "Consumer Electronics",
"fullTimeEmployees": 150000
},
"financials": {
"income": [
{
"asOfDate": "2025-09-30",
"periodType": "12M",
"currencyCode": "USD",
"totalRevenue": 416161000000,
"grossProfit": 195201000000,
"operatingIncome": 133050000000,
"netIncome": 112010000000
}
],
"balanceSheet": [
{
"asOfDate": "2025-09-30",
"periodType": "12M",
"currencyCode": "USD",
"totalAssets": 359241000000,
"stockholdersEquity": 73733000000,
"totalDebt": 98657000000
}
],
"cashFlow": [
{
"asOfDate": "2025-09-30",
"periodType": "12M",
"currencyCode": "USD",
"operatingCashFlow": 111482000000,
"capitalExpenditure": -12715000000,
"freeCashFlow": 98767000000
}
]
},
"chart": {
"meta": {
"currency": "USD",
"symbol": "AAPL",
"exchangeName": "NMS",
"fullExchangeName": "NasdaqGS",
"instrumentType": "EQUITY",
"regularMarketPrice": 305.93,
"chartPreviousClose": 207.57,
"dataGranularity": "1wk",
"range": ""
},
"series": [
{
"timestamp": 1753675200,
"date": "2025-07-28T04:00:00.000Z",
"open": 208.49000549316406,
"high": 213.5800018310547,
"low": 201.5,
"close": 202.3800048828125,
"volume": 185132900,
"adjclose": 201.40658569335938
}
],
"events": {
"dividends": [
{
"amount": 0.26,
"date": 1754919000
}
]
}
},
"news": [
{
"uuid": "[removed: ID]",
"title": "[removed: headline]",
"description": "[removed: summary]",
"pubDate": "Sun, 16 Aug 2026 15:20:00 +0000",
"providerPublishTime": 1786893600
}
],
"recommendations": [
{
"symbol": "AMZN",
"score": 0.187666
}
],
"insights": [
{
"symbol": "AAPL",
"events": [
{
"eventType": "Moving Average Convergence/Divergence (MACD)",
"pricePeriod": "W",
"tradingHorizon": "I",
"tradeType": "S",
"startDate": 1786714200,
"endDate": 1786714200
}
]
}
],
"priceInsights": {
"AAPL": {
"hasPriceAnomaly": false
}
},
"options": {
"underlyingSymbol": "AAPL",
"expirationDates": [
1786924800,
1787097600,
1787270400
],
"strikes": [
5,
10,
15
],
"hasMiniOptions": false,
"quote": {
"symbol": "AAPL",
"shortName": "Apple Inc.",
"quoteType": "EQUITY",
"currency": "USD",
"regularMarketPrice": 305.93
},
"options": [
{
"expirationDate": 1797552000,
"hasMiniOptions": false,
"calls": [
{
"contractSymbol": "AAPL261218C00005000",
"strike": 5,
"currency": "USD",
"lastPrice": 300.83,
"change": -7.2700195,
"percentChange": -2.3596299,
"volume": 1,
"openInterest": 5,
"bid": 299.05,
"ask": 302.1,
"contractSize": "REGULAR",
"expiration": 1797552000,
"lastTradeDate": 1786721576,
"impliedVolatility": 4.289067138671875,
"inTheMoney": true
}
],
"puts": [
{
"contractSymbol": "AAPL261218P00005000",
"strike": 5,
"currency": "USD",
"lastPrice": 0.01,
"change": 0,
"percentChange": 0,
"volume": 1,
"openInterest": 128,
"bid": 0,
"ask": 0.02,
"contractSize": "REGULAR",
"expiration": 1797552000,
"lastTradeDate": 1786027131,
"impliedVolatility": 2.2500043749999996,
"inTheMoney": false
}
]
}
]
},
"ownership": {
"majorHoldersBreakdown": {
"insidersPercentHeld": 0.01648,
"institutionsPercentHeld": 0.66483,
"institutionsFloatPercentHeld": 0.67597,
"institutionsCount": 7709
},
"netSharePurchaseActivity": {
"period": "6m",
"buyInfoCount": 11,
"buyInfoShares": 434520,
"sellInfoCount": 8,
"sellInfoShares": 399314,
"netInfoCount": 19,
"netInfoShares": 35206
}
},
"analyst": {
"recommendationTrend": {
"trend": [
{
"period": "0m",
"strongBuy": 6,
"buy": 21,
"hold": 14,
"sell": 3,
"strongSell": 2
}
]
},
"earningsTrend": {
"trend": [
{
"period": "0q",
"endDate": "2026-09-30",
"growth": 0.070300005,
"earningsEstimate": {
"avg": 1.97656,
"low": 1.93,
"high": 2.07,
"numberOfAnalysts": 28
}
}
]
}
},
"analystConsensus": {
"options_analysis": {
"date": "2026-02-08 00:00:00",
"ticker": "AAPL",
"pcr": {
"pcr_volume": 0.5430885164828748,
"pcr_notional": 0.5340505600110216,
"underlying_symbol": "AAPL"
}
},
"financial_insights": {
"earnings_calendar": [
{
"fiscal_year": 2026,
"fiscal_period": "Q3",
"earnings_release": "2026-07-30T20:30:28+00:00"
}
]
},
"price_movement": {
"data": {
"beta": 1.086,
"sector": "Technology",
"industry": "Consumer Electronics",
"stock_ticker": "AAPL"
}
}
},
"ratings": {
"dir": {
"analyst": "[removed: analyst]",
"dir": {
"raw": 78.79034556648135,
"fmt": 79
},
"mm": {
"raw": 35.69498222141938,
"fmt": 36
},
"pt": {
"raw": 68.09676385312973,
"fmt": 68
},
"fin_score": {
"raw": 63.72302022029243,
"fmt": 64
},
"datapoints": 5,
"ticker": "AAPL",
"uuid": "[removed: ID]",
"rating_current": "Outperform",
"rating_sentiment": 1,
"pt_current": 330,
"adjusted_pt_current": 330,
"announcement_date": "2025-12-06"
}
},
"technicalEvents": {
"total": 19,
"technicalEvents": {
"shortTerm": "down",
"midTerm": "down",
"longTerm": "up",
"support": 229.82,
"resistance": 308.82,
"stopLoss": 290.372999
},
"events": [
{
"duration": 1,
"priceDate": 1786714200,
"priceClose": {
"raw": 305.93,
"fmt": "305.93"
},
"endDate": 1786714200,
"tradingHorizon": "S",
"eventType": "Williams %R",
"pricePeriod": "W",
"tradeType": "S"
}
]
},
"keyStatistics": {
"defaultKeyStatistics": {
"enterpriseValue": 4486742409216,
"forwardPE": 32.17704,
"profitMargins": 0.27618998,
"beta": 1.086,
"sharesOutstanding": 14594180000,
"trailingEps": 8.72,
"forwardEps": 9.50771,
"pegRatio": 2.47,
"shortRatio": 2.58,
"heldPercentInstitutions": 0.66483,
"earningsQuarterlyGrowth": 0.271
},
"financialData": {
"currentPrice": 305.93,
"targetHighPrice": 400,
"targetLowPrice": 215,
"targetMeanPrice": 322.2844,
"recommendationKey": "buy",
"numberOfAnalystOpinions": 41,
"totalRevenue": 466822987776,
"revenueGrowth": 0.164
},
"pageViews": {
"shortTermTrend": "NONE",
"midTermTrend": "UP",
"longTermTrend": "UP"
},
"quoteType": {
"exchange": "NMS",
"quoteType": "EQUITY",
"symbol": "AAPL",
"shortName": "Apple Inc.",
"longName": "Apple Inc."
},
"financialsTemplate": {
"code": "N"
}
},
"calendarEvents": {
"earnings": {
"earningsDate": [
1793304000
],
"earningsCallDate": [
1785441600
],
"isEarningsDateEstimate": true,
"earningsAverage": 1.98013,
"earningsLow": 1.93,
"earningsHigh": 2.07,
"revenueAverage": 113550860190,
"revenueLow": 112137000000,
"revenueHigh": 117219700000
},
"exDividendDate": 1786320000,
"dividendDate": 1786579200
},
"scheduledEvents": {
"earnings": [
{
"timestamp": 1746000000,
"timestampString": "1970-01-21",
"timezone": "America/New_York",
"count": 0,
"totalCount": 0,
"records": []
}
],
"economicEvents": [
{
"timestamp": 1746000000,
"timestampString": "1970-01-21",
"timezone": "America/New_York",
"count": 0,
"totalCount": 0,
"records": []
}
]
},
"marketSummary": [
{
"symbol": "^GSPC",
"fullExchangeName": "SNP",
"quoteType": "INDEX",
"shortName": "S&P 500",
"regularMarketPrice": {
"raw": 7785.76,
"fmt": "7,785.76"
},
"regularMarketChange": {
"raw": -13.230469,
"fmt": "-13.23"
},
"regularMarketChangePercent": {
"raw": -0.16964336,
"fmt": "-0.17%"
},
"regularMarketPreviousClose": {
"raw": 7798.99,
"fmt": "7,798.99"
}
}
],
"sectors": {
"marketCap": {
"raw": 90213549604864,
"fmt": "90.214T",
"longFmt": "90,213,549,604,864"
},
"sectorsCount": 11,
"industriesCount": 145,
"list": [
{
"name": "All Sectors",
"regMarketChangePercent": {
"raw": 0.0016284138,
"fmt": "0.16%"
},
"ytdReturn": {
"raw": 0.17223604,
"fmt": "17.22%"
},
"marketWeight": {
"raw": 1,
"fmt": "100.00%"
}
}
]
}
}
```
#### Selected mutual-fund fields
View a VFIAX fund profile
These selected VFIAX fields show values that apply to a mutual fund. This is not
a saved Dataset item.
```jsonc
{
"symbol": "VFIAX",
"status": "complete",
"profile": {
"topHoldings": {
"cashPosition": 0.0022,
"stockPosition": 0.9957,
"bondPosition": 0,
"otherPosition": 0.002,
"preferredPosition": 0,
"convertiblePosition": 0,
"holdings": [
{
"symbol": "NVDA",
"holdingName": "NVIDIA Corp",
"holdingPercent": 0.074991
}
]
},
"fundProfile": {
"family": "Vanguard",
"categoryName": "Large Blend",
"legalType": null,
"initInvestment": 3000
},
"fundPerformance": {
"fundCategoryName": "Large Blend",
"performanceOverview": {
"asOfDate": 1786579200,
"ytdReturnPct": 0.1469028,
"fiveYrAvgReturnPct": 0.1334809,
"oneYearTotalReturn": 0.2199243,
"threeYearTotalReturn": 0.2200188
},
"loadAdjustedReturns": {
"oneYear": 0.1951629,
"threeYear": 0.1927547,
"fiveYear": 0.1281144,
"tenYear": 0.15039091
}
}
}
}
```
#### Symbol not found
View a record with not_found status
An unknown symbol uses `not_found`. Its symbol sections are `null`, but run-level
market and sector data can still be present.
```jsonc
{
"recordType": "symbol",
"status": "not_found",
"failedSections": [],
"symbol": "UNKNOWN-SYMBOL",
"quote": null,
"profile": null,
"financials": null,
"chart": null,
"news": null,
"recommendations": null,
"insights": null,
"priceInsights": null,
"options": null,
"ownership": null,
"analyst": null,
"analystConsensus": null,
"ratings": null,
"technicalEvents": null,
"keyStatistics": null,
"calendarEvents": null,
"scheduledEvents": null,
"marketSummary": [
{
"symbol": "^GSPC",
"regularMarketPrice": {
"raw": 7785.76,
"fmt": "7,785.76"
}
}
],
"sectors": {
"marketCap": {
"raw": 90216873590784,
"fmt": "90.217T",
"longFmt": "90,216,873,590,784"
},
"sectorsCount": 11,
"industriesCount": 145
}
}
```
Yahoo Finance can add or remove keys in the open objects listed above. A
documented optional field can be absent, and an enabled section can be `null`
when it does not apply or has no data. The selected examples shorten
arrays and replace some values with documentation markers.
### Data and request constraints
- Availability differs by instrument, market, locale, and date. A supported
field can be absent.
- Quote timing and exchange delay come from Yahoo Finance and can differ by
instrument.
- Historical option expirations are not available. A request for all available
expirations can produce a large record.
- Fine chart intervals support shorter date windows than daily, weekly, or
monthly intervals.
- Research and analyst sections can contain generated text and open nested
objects.
# Actor input Schema
## `symbols` (type: `array`):
Yahoo Finance symbols. Formats: stocks (GOOGL, AAPL), international (7203.T, 005930.KS), ETFs (SPY, QQQ), indices (^DJI, ^GSPC), crypto (BTC-USD, ETH-USD), currencies (EURUSD=X), futures (GC=F, CL=F), mutual funds (VFIAX).
## `searchQuery` (type: `string`):
Search keyword to discover symbols (e.g. 'tech stocks', 'energy ETF').
## `trending` (type: `boolean`):
Fetch currently trending symbols from Yahoo Finance.
## `trendingRegion` (type: `string`):
Region for trending symbols (US, GB, DE, FR, JP, etc.).
## `screener` (type: `string`):
Predefined screener to discover symbols.
## `maxSearchResults` (type: `integer`):
Maximum number of symbols to return from search, trending, or screener.
## `includeQuote` (type: `boolean`):
Quote fields such as price, volume, 52-week range, market cap, P/E, dividends, and pre/post-market values when available.
## `includeProfile` (type: `boolean`):
Company profile, sector, industry, officers, ESG scores. For ETFs/funds: top holdings, fund family, expense ratio, performance.
## `includeFinancials` (type: `boolean`):
Available annual and quarterly income statement, balance sheet, and cash-flow fields.
## `includeChart` (type: `boolean`):
OHLCV price chart with pre/post market data and dividend/split/earnings events.
## `includeNews` (type: `boolean`):
News articles with headlines, descriptions, and links (up to 50 per symbol).
## `includeRecommendations` (type: `boolean`):
Similar/recommended symbols with relevance scores.
## `includeInsights` (type: `boolean`):
Research reports, AI-powered news/price analysis, technical events with support/resistance levels.
## `includeAnalyst` (type: `boolean`):
Recommendation trends, upgrade/downgrade history, earnings (GAAP + non-GAAP), SEC filings, earnings transcripts, top analyst ratings, scheduled events.
## `includeOwnership` (type: `boolean`):
Insider holdings, institutional ownership, fund ownership, insider transactions, net share purchase activity.
## `includeOptions` (type: `boolean`):
Options chain with expiration dates, strikes, calls, puts, and implied volatility when available.
## `optionAllExpirations` (type: `boolean`):
Fetch all available option expiration dates. Do not combine with specific dates.
## `optionDates` (type: `array`):
Fetch options for specific dates only (YYYY-MM-DD, e.g. '2026-12-18'). Leave unset for the nearest expiration.
## `chartRange` (type: `string`):
Time range for chart data.
## `chartStartDate` (type: `string`):
Start date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set.
## `chartEndDate` (type: `string`):
End date for chart data (YYYY-MM-DD). Overrides chart range when both start and end dates are set.
## `chartInterval` (type: `string`):
Data interval for chart. Availability of fine intervals depends on the requested date range.
## `maxNewsResults` (type: `integer`):
Maximum number of news articles per symbol (1-200). Yahoo returns at most 50 news articles per symbol, and most symbols return fewer, so a value above 50 returns the same articles as 50.
## `lang` (type: `string`):
Language for API responses (e.g. en-US, ja-JP, de-DE, fr-FR, zh-Hant-HK).
## `region` (type: `string`):
Region for market data (e.g. US, GB, DE, JP, HK, AU, CA, FR).
## `proxyConfiguration` (type: `object`):
Connection settings. Defaults to Apify Proxy; you can choose groups, a country, or your own proxy URLs.
## Actor input object example
```json
{
"symbols": [
"GOOGL",
"AAPL"
],
"trending": false,
"trendingRegion": "US",
"maxSearchResults": 10,
"includeQuote": true,
"includeProfile": true,
"includeFinancials": true,
"includeChart": true,
"includeNews": true,
"includeRecommendations": true,
"includeInsights": true,
"includeAnalyst": true,
"includeOwnership": false,
"includeOptions": false,
"optionAllExpirations": false,
"chartRange": "1mo",
"chartInterval": "1d",
"maxNewsResults": 10,
"lang": "en-US",
"region": "US",
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"symbols": [
"GOOGL",
"AAPL"
],
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("kaix/yahoo-finance-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"symbols": [
"GOOGL",
"AAPL",
],
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("kaix/yahoo-finance-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"symbols": [
"GOOGL",
"AAPL"
],
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call kaix/yahoo-finance-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,kaix/yahoo-finance-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/8f8G2HzcxluxkaqHZ/builds/fylTdENdDiFEeEK59/openapi.json