Steam

List Steam app news

List a Steam app's news and announcements, newest first.

GET/v1/steam/apps/{appId}/news
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
appIdintegerrequiredpath

Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.

≥ 1 · ≤ 2147483647

limitintegeroptionalquery

News items per page, 1 to 100. Default: 20.

≥ 1 · ≤ 100

beforestringoptionalquery

Only items published before this date or timestamp (UTC).

feedsstringoptionalquery

Only these feeds, comma-separated by feed name, e.g. `steam_community_announcements`. Each item's `feed.name` says which feed it came from.

min 1 chars · max 200 chars · pattern: ^[\w ,.\-|']+$

fullbooleanoptionalquery

Return each item's full contents. By default contents are cut at 500 characters.

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response, with the same filters, to get the next page.

min 1 chars · max 512 chars · pattern: ^[A-Za-z0-9_-]+$

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

Whether the app was found.

one of: found, not_found

dataappId
integer

Steam app id, the number in the store URL, e.g. `570` for Dota 2. A store app URL is also accepted.

≥ 1 · ≤ 2147483647

dataitemCount
integernullable

News items for the app in all, or matching `feeds` when given. Null when the app was not found.

News items, newest first.

datanews[]id
string

News item id.

datanews[]title
string

Headline.

datanews[]url
stringnullable

Link to the item.

datanews[]author
stringnullable

Author, when given.

datanews[]contents
string

Body. Steam announcements (`feed.type` 1) use Steam's BBCode; items from other feeds are HTML. `{STEAM_CLAN_IMAGE}` markers are replaced with `https://clan.akamai.steamstatic.com/images` so image paths resolve.

datanews[]publishedAt
stringnullable

When the item was published (ISO 8601 UTC).

Where the item comes from.

datanews[]feedname
stringnullable

Feed name, e.g. `steam_community_announcements`.

datanews[]feedlabel
stringnullable

Feed label, e.g. a site's name.

datanews[]feedtype
integernullable

`1` for the developer's Steam announcements, `0` for other feeds.

datanews[]isExternal
boolean

Whether the item links to another site rather than Steam. Developer announcements on Steam are false even when Steam's own flag is set.

Tags such as `patchnotes`.

datanews[]tags[]
stringoptional

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.

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/steam/apps/620/news?limit=20" \
  -H "x-api-key: YOUR_API_KEY"

Responses

News listing.