Yahoo Finance

Search Yahoo Finance symbols

Search Yahoo Finance symbols by text and instrument kind.

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

API key (`sfk_...`)

Parameters
5
querystringrequiredquery

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

min 1 chars · max 200 chars

typestringoptionalquery

Instrument kind. Default: every kind.

one of: equity, etf, mutualfund, index, future, currency, cryptocurrency

limitintegeroptionalquery

Page size as an integer from 1 to 250. Default: 25.

≥ 1 · ≤ 250

offsetintegeroptionalquery

Zero-based position to begin the list at. Default: 0; maximum: 1,000,000. Only the first 10,000 rows are available; past that the page is empty.

≥ 0 · ≤ 1000000

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
16

Endpoint-specific response payload.

dataquery
string

Text that was looked up.

datatype
stringnullable

Instrument kind that was requested, or null for every kind.

datatotal
integernullable

Not reported by this endpoint; always null. Use `page.hasMore` and `count` to page.

≥ 0

datastart
integer

Zero-based position of the first row.

≥ 0

datacount
integer

Number of rows in this page.

≥ 0

Matching instrument documents.

datadocuments[]
objectoptional

A Yahoo Finance JSON record, normalised.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datawindowClamped
boolean

True when the requested start is past the reachable rows; only rows inside the requested window are returned.

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/lookup?query=apple" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance symbol lookup results.