Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Sector API

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

GET /v1/yahoo-finance/sectors/{sector}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Yahoo Finance Sector API 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.

Other Yahoo Finance endpoints