Skip to main content
The yf_search tool lets you search for ticker symbols, company information, news articles, and research reports using Yahoo Finance’s search functionality.

​
Parameters

​
query
string
required
Search query string. Can be a ticker symbol (e.g., “AAPL”), company name (e.g., “Apple Inc”), or general search term.
​
max_results
integer
default:10
Maximum number of search results to return.Constraints: Min: 1, Max: 50
​
news_count
integer
default:0
Number of news articles to include with the search results.Constraints: Min: 0, Max: 20
​
include_research
boolean
default:false
Whether to include research reports in the search results.

​
Output Options

​
response_format
string
default:"json"
Format of the response data.Options: json, markdown
​
preview_limit
integer
default:25
Number of rows to preview when using markdown format.Constraints: Min: 1, Max: 200
​
save
object
Save the results to a file.

​
Use Cases

​
Discover Ticker Symbols

Use yf_search to find the correct ticker symbol for a company: 
{
  "query": "Tesla",
  "max_results": 5
}
This returns ticker symbols, company names, and basic information for Tesla-related securities.

​
Search with News

Get search results along with recent news articles: 
{
  "query": "NVDA",
  "max_results": 3,
  "news_count": 10
}

​
Include Research Reports

Search for securities and include analyst research: 
{
  "query": "technology ETF",
  "max_results": 10,
  "include_research": true
}

​
Response Structure

The search returns:
  • Quotes: Matching ticker symbols with basic data (symbol, name, exchange, type)
  • News: News articles related to the search query (if news_count > 0)
  • Research: Analyst research reports (if include_research is true)

​
Tips

If you don’t know the exact ticker symbol, start with yf_search using the company name or description. The results will include the ticker symbols you need for other tools.
Search results may include multiple securities with similar names. Always verify the exchange and security type to ensure you have the correct ticker.

Build docs developers (and LLMs) love

Get started for freeTalk to us