Get Discord game

GET/v1/discord/games/{applicationId}

1credit

Headers

x-api-keystringheader

API key (`sfk_...`)

Parameters

applicationIdstringrequiredpath

Application id, 1 to 20 digits and at most 9223372036854775807, e.g. `457300488199733265`. Bots and applications without a game page return `not_found`.

pattern: ^[0-9]{1,20}$

Response fields

Endpoint-specific response payload.

datalookupStatus

string

`not_found` when no game page exists for the application id.

one of: found, not_found, restricted

The game when `lookupStatus` is `found`; otherwise null.

datagameapplicationId

string

Application id.

datagamename

string

Game name.

datagamesummary

stringnullable

Game summary.

Genres.

datagamegenres[]

stringoptional

Platforms.

datagameplatforms[]

stringoptional

Publishers.

datagamepublishers[]

stringoptional

Developers.

datagamedevelopers[]

stringoptional

datagamereleaseDate

stringnullable

Release date.

datagamerank30d

integernullable

Rank over the last 30 days, when given.

Official and social links.

datagamelinks[]type

integernullable

Discord's link type.

datagamelinks[]label

stringnullable

The link label.

datagamelinks[]url

string

The link URL.

The game's images.

datagamemediacoverImageUrl

stringnullable

Cover image URL.

datagamemediabannerImageUrl

stringnullable

Banner URL.

Screenshot URLs.

datagamemediascreenshotUrls[]

stringoptional

Artwork URLs.

datagamemediaartworkUrls[]

stringoptional

The game's trailers.

datagametrailers[]id

stringnullable

Trailer id.

datagametrailers[]contentUrl

stringnullable

Video URL.

datagametrailers[]thumbnailUrl

stringnullable

Thumbnail URL.

datagametrailers[]width

integernullable

Video width in pixels.

datagametrailers[]height

integernullable

Video height in pixels.

datagametrailers[]mimeType

stringnullable

MIME type.

datagametrailers[]uploadedAt

stringnullable

Upload time, ISO 8601 UTC.

Review scores, when shown.

The game's Steam review scores.

datagamereviewssteamrating

integernullable

Steam rating as the percentage of positive reviews.

datagamereviewssteamratingCount

integernullable

Total reviews.

datagamereviewssteamrecentRating

integernullable

Steam recent rating as the percentage of positive reviews.

datagamereviewssteamrecentRatingCount

integernullable

Recent reviews.

The game's OpenCritic scores.

datagamereviewsopencritictopCriticRating

numbernullable

OpenCritic top-critic rating.

datagamereviewsopencritictopCriticRatingCount

integernullable

How many critics make up the top-critic rating.

datagamereviewsopencritictier

integernullable

OpenCritic tier.

datagamereviewsopencriticurl

stringnullable

OpenCritic page.

The game's official server.

datagameofficialServerid

string

Server id.

datagameofficialServername

string

Server name.

datagameofficialServericonUrl

stringnullable

Server icon URL.

datagameofficialServerbannerUrl

stringnullable

Server banner URL.

datagameofficialServerdescription

stringnullable

Server description.

datagameofficialServerinviteUrl

stringnullable

The server's invite link, when it has one.

datagameofficialServermembers

integernullable

Member count.

datagameofficialServeronline

integernullable

Online count.

datagameofficialServerhasWebPage

booleannullable

Whether the server has a public web page.

datagameofficialServerwebPageSlug

stringnullable

The server's web page slug, when it has one.

datagameofficialSerververified

booleannullable

Whether the server is verified.

datagameofficialServerpartnered

booleannullable

Whether the server is partnered.

The game's trending tags.

datagametrending[]name

string

Trending tag name.

datagametrending[]slug

stringnullable

Trending tag slug; null for `All`.

datagametrending[]rank

integer

The game's rank under this trending tag.

datagametrending[]weekTrendingStreak

integernullable

Weeks the game has been trending under this tag.

The page's announcement block, when present.

The channel the block belongs to.

datagameannouncementschannelid

string

Channel id.

datagameannouncementschannelname

stringnullable

Channel name.

datagameannouncementschanneltopic

stringnullable

Channel topic.

The latest announcement messages, capped at ten.

datagameannouncementsmessages[]id

string

Message id.

datagameannouncementsmessages[]text

string

The message text.

datagameannouncementsmessages[]postedAt

stringnullable

When it was posted, ISO 8601 UTC.

datagameannouncementsmessages[]editedAt

stringnullable

When it was edited, ISO 8601 UTC; null when never edited.

Files attached to the post.

datagameannouncementsmessages[]attachments[]url

string

The attachment URL. Its signed query parameters expire, so the link is time-limited.

datagameannouncementsmessages[]attachments[]mediaUrl

stringnullableoptional

A second URL for the attachment on Discord's media host, when present.

datagameannouncementsmessages[]attachments[]contentType

stringnullable

MIME type, when given.

datagameannouncementsmessages[]attachments[]width

integernullable

Width in pixels, when given.

datagameannouncementsmessages[]attachments[]height

integernullable

Height in pixels, when given.

datagameannouncementsmessages[]attachments[]description

stringnullable

Alt text, when present.

Reactions on the post.

datagameannouncementsmessages[]reactions[]emojiId

stringnullable

Custom emoji id, or null.

datagameannouncementsmessages[]reactions[]emojiName

stringnullable

Emoji name, or null.

datagameannouncementsmessages[]reactions[]animated

booleannullable

Whether the emoji is animated.

datagameannouncementsmessages[]reactions[]count

integer

How many people reacted.

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

Headers

Code example

Responses