Skip to main content

​
Overview

The yf_industry tool provides granular industry-level information, including performance metrics, top companies, and growth indicators within specific industries.

​
Tool Name

yf_industry

​
Parameters

​
key
string
required
Industry key identifier (e.g., ‘software-infrastructure’, ‘biotechnology’, ‘semiconductors’)
​
field
enum
Specific industry field to retrieve. Available fields:
  • key - Industry key identifier
  • name - Industry display name
  • symbol - Industry symbol
  • ticker - Industry ticker representation
  • overview - Comprehensive industry overview and statistics
  • top_companies - Leading companies in the industry
  • research_reports - Available research reports for the industry
  • sector_key - Parent sector key identifier
  • sector_name - Parent sector display name
  • top_performing_companies - Best performing companies by returns
  • top_growth_companies - Highest growth companies in the industry
​
response_format
enum
default:"json"
Output format:
  • json - Structured JSON data
  • markdown - Formatted markdown tables
​
preview_limit
number
default:25
Number of rows to preview (1-200) when using markdown format
​
save
object
Save options for exporting data:

​
Common Industry Keys

Industry keys follow a hyphenated format: Technology Sector:
  • software-infrastructure
  • software-application
  • semiconductors
  • computer-hardware
  • electronics-computer-distribution
Healthcare Sector:
  • biotechnology
  • drug-manufacturers-general
  • medical-devices
  • diagnostics-research
Financial Services:
  • banks-regional
  • asset-management
  • insurance-diversified
  • credit-services
Consumer:
  • auto-manufacturers
  • retail-apparel
  • restaurants
  • beverages-non-alcoholic

​
Field Details

​
Overview

Provides comprehensive industry statistics including:
  • Market capitalization
  • Performance metrics across multiple timeframes
  • Valuation ratios (P/E, P/B, P/S, PEG)
  • Growth rates and profitability metrics
  • Trading volume and momentum indicators

​
Top Companies

Returns leading companies by market cap within the industry, including:
  • Company name and ticker symbol
  • Market capitalization
  • Price and performance data
  • Key financial metrics

​
Top Performing Companies

Identifies companies with the strongest recent returns, useful for:
  • Momentum analysis
  • Identifying market leaders
  • Performance comparison

​
Top Growth Companies

Highlights companies with highest growth rates in:
  • Revenue growth
  • Earnings growth
  • User/customer growth

​
Sector Relationship

Use sector_key and sector_name to understand the parent sector and navigate between sector and industry levels.

​
Usage Examples

{
  "key": "software-infrastructure",
  "field": "overview",
  "response_format": "json"
}

​
Industry vs Sector

Industries provide more granular data than sectors:
  • Sector (technology) → Industries (software-infrastructure, semiconductors, software-application)
  • Sector (healthcare) → Industries (biotechnology, drug-manufacturers-general, medical-devices)
Use yf_sector with the industries field to discover all industries within a sector.

Build docs developers (and LLMs) love

Get started for freeTalk to us