Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Industry API

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

GET /v1/yahoo-finance/industries/{industry}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

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

Other Yahoo Finance endpoints