> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/industries-industry>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/industries-industry.mdx>

---

# Yahoo Finance Industry API

One industry: overview, performance, top and growth companies.

`GET /v1/yahoo-finance/industries/{industry}` returns `data.lookupStatus`, `data.industry` and `data.data`. The data record carries the overview, performance, top companies, top performing companies, top growth companies and research reports for the industry. Industry keys follow Yahoo Finance's own names, for example `software-infrastructure`, `specialty-chemicals` and `basic-materials`. The key is case-insensitive and spaces or underscores become hyphens, so `Software Infrastructure` works.

An unknown industry key returns `lookupStatus: not_found` and `data.data` null. A string that cannot be an industry key is a 400 before any request. Use the sector route for the broader group and the screener routes when you need a list of instruments. The top performing and growth lists are separate, so read the one that matches the question.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/industries/{industry}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by industry key
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/industries/industry/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## FAQ

### Which industry keys can I use?

Keys such as software-infrastructure, specialty-chemicals and basic-materials. Case is ignored and spaces or underscores become hyphens; the response echoes the normalised key. An unknown key is returned as lookupStatus: not_found, and a string that cannot be a key is a 400.

### What is in the industry data?

Overview, performance, top companies, top performing companies, top growth companies and research reports, each where available.

### How is this different from the sector route?

The industry route is one level narrower. The sector response includes its industries, so you can move from a sector to an industry key and then request this route.

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
