scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTQuote
  • POSTFundamentals
  • POSTChart
  • POSTNews
  • POSTOptions
  • POSTSearch

Yahoo Finance Search

1 credit

Search for ticker symbols or fetch trending symbols.

POST/api/v1/tools/yahoo-finance/search

Parameters

querystring

Search keyword (e.g. "Apple", "tech ETF"). At least one of query or trending must be provided.

trendingboolean

Fetch trending symbols instead of searching.

regionstring

Region for trending symbols. Defaults to "US".

maxResultsnumber

Maximum results (1-50). Defaults to 10.

fieldsstring[]

Fields to include in response. Omit or pass ["*"] for all fields.

Response Schema

dataobject

Yahoo Finance search result

quotesobject[]

Array of matching symbols

metaobject

Request metadata

toolstring

Tool name (yahoo-finance-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yahoo-finance/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "Apple",
"maxResults": 5
}'

Response Example

{
"data": {
"quotes": [
{
"symbol": "AAPL",
"shortName": "Apple Inc.",
"exchange": "NMS",
"quoteType": "EQUITY",
"score": 100000
},
{
"symbol": "APLE",
"shortName": "Apple Hospitality REIT, Inc.",
"exchange": "NYQ",
"quoteType": "EQUITY",
"score": 20000
}
]
},
"meta": {
"tool": "yahoo-finance-search",
"creditsUsed": 1,
"requestId": "req_abc123"
}
}