Yahoo Finance

Search Yahoo Finance

Search Yahoo Finance entities, news, lists and research reports.

GET/v1/yahoo-finance/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

Text to search for, e.g. `apple`, `toyota` or `AAPL`.

min 1 chars · max 200 chars

regionstringoptionalquery

Market region, a two-letter code such as `US`, `GB` or `JP`.

pattern: ^[A-Z]{2}$

languagestringoptionalquery

Language tag for names and news, e.g. `en-US` or `ja-JP`.

max 24 chars · pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$

Response fields
17

Endpoint-specific response payload.

dataquery
string

Text that was searched for.

datacount
integernullable

Total matches; null when not reported.

≥ 0

Matching instruments.

dataquotes[]
objectoptional

A Yahoo Finance JSON record, normalised.

Matching news stories.

datanews[]
objectoptional

A Yahoo Finance JSON record, normalised.

Matching curated lists.

datalists[]
objectoptional

A Yahoo Finance JSON record, normalised.

Matching research reports.

dataresearchReports[]
objectoptional

A Yahoo Finance JSON record, normalised.

Matching screener fields.

datascreenerFieldResults[]
objectoptional

A Yahoo Finance JSON record, normalised.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/search?query=apple" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance search results.