Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Search API

One query across entities, news, lists, research reports and screener fields.

GET /v1/yahoo-finance/search

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/search?query=apple returns data.query, data.count, data.quotes, data.news, data.lists, data.researchReports and data.screenerFieldResults. The quote rows carry entity fields such as symbol, shortname, longname, exchDisp, typeDisp, quoteType, score and isYahooFinance. News rows carry headline metadata, and research report rows carry report metadata.

Send region and language to localise names and news, for example region=US&language=en-US or region=JP&language=ja-JP. data.count can be null when no total is available. Navigation links and server timings are not exposed. A query written wholly in a non-Latin script is refused with a clear 400; search by a Latin name or a ticker instead. Use lookup when you want typed symbol matches with offset paging.

Yahoo Finance Search API FAQ

What kind of results come back?

Entities, news, curated lists, research reports and screener field results, each in its own array. Empty arrays are normal when the query matches nothing in that category.

How do I localise the results?

Send region as a two-letter code and language as a tag such as en-US or ja-JP. The same query can return different names and news for a different region.

Can I search in Japanese or Cyrillic?

A wholly non-Latin query returns a 400. Use a Latin transliteration or the ticker; a mixed query that contains Latin text still works.

Why is data.count null?

No total is available for that search. The arrays are still complete for the query; treat count as optional.

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