> **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/sectors-sector>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/sectors-sector.mdx>

---

# Yahoo Finance Sector API

One sector: overview, performance, top companies, funds and industries.

`GET /v1/yahoo-finance/sectors/{sector}` returns `data.lookupStatus`, `data.sector` and `data.data`. The data record carries the overview, performance, top companies, top ETFs, top mutual funds, industries and research reports for the sector. Sector keys follow Yahoo Finance's own names, for example `technology`, `financial-services` and `healthcare`. The key is case-insensitive and spaces or underscores become hyphens, so `Technology` and `Financial Services` work.

An unknown sector key returns `lookupStatus: not_found` and `data.data` null, rather than an error page. A string that cannot be a sector key is a 400 before any request. Use the industry route when you need a narrower group, and the screener routes when you need a list of instruments rather than a sector summary. Read the performance block before comparing sectors, because each row reports its own period.

## Request

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

## FAQ

### Which sector keys can I use?

Keys such as technology, financial-services and healthcare. The response echoes the sector key you sent, and an unknown key is returned as lookupStatus: not_found.

### What is in the sector data?

Overview, performance, top companies, top ETFs, top mutual funds, industries and research reports, each in its own section where available.

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

The sector route summarises a whole sector and lists its industries. The industry route goes one level deeper for a single industry key.

### 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.