Yahoo Finance

List Yahoo Finance headlines

List Yahoo Finance news headlines for a symbol with publisher links.

GET/v1/yahoo-finance/instruments/{symbol}/news
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
symbolstringrequiredpath

Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.

min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$

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
19

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

Ticker symbol the headlines are for.

Headlines, de-duplicated by link and id.

dataitems[]id
stringnullable

Story id when the headline carries one.

dataitems[]title
stringnullable

Headline title.

dataitems[]description
stringnullable

Short summary when one is available.

dataitems[]publisher
stringnullable

Publisher name, or the article's domain when no name is provided.

dataitems[]link
stringnullable

Link to the article.

dataitems[]publishedAt
stringnullable

Publication time, ISO 8601 UTC.

dataitems[]type
stringnullable

Story kind, such as `STORY` or `VIDEO`.

dataitems[]thumbnailUrl
stringnullable

Thumbnail image URL when one is available.

Tickers the story mentions.

dataitems[]relatedTickers[]
stringoptional
datasources
object

Status of each optional part of the result.

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/instruments/AAPL/news" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance headlines.