List Discord trending games
List Discord's ten weekly trending games, by week and optional category, with their official servers.
Headers
Get your API keyAPI key (`sfk_...`)
Week date, YYYY-MM-DD (Discord publishes on Thursdays). Omit for the latest week.
Trending category, one of the 18 slugs Discord publishes (e.g. `shooter`, `rpg`, `survival`).
one of: adventure, crafting, fantasy, fps, horror, indie, mmo, open-world, rpg, sandbox, sci-fi, shooter, simulation, sports, story-rich, strategy, survival, tactical
`weeks` adds the published week list (overall and per category). Default: none.
any of: weeks (comma-separated)
Endpoint-specific response payload.
`found` when a published week is returned.
one of: found, not_found, restricted
The week asked for; null when the latest week was asked for.
The category filter; null for the overall list.
one of: adventure, crafting, fantasy, fps, horror, indie, mmo, open-world, rpg, sandbox, sci-fi, shooter, simulation, sports, story-rich, strategy, survival, tactical, null
The week the response is for; null when not found.
The published week date, YYYY-MM-DD.
The previous published week, or null.
The next published week, or null for the latest week.
When the week was published, ISO 8601 UTC.
True when the requested date is not a published week and Discord returns another (usually the latest) week. The response is still a real week; compare `requestedWeek` with `week.date`.
The ten trending games for the week, ranked.
Rank in the weekly list.
Application id.
Game name.
The game page's slug.
Game description.
Release date, YYYY-MM-DD, when given.
Change in total players, as Discord displays it.
Seven-day streaming activity change.
Weeks this game has been trending.
Cover image URL.
Screenshot URL.
Number of servers that match the game.
Categories and the game's rank in each.
Category name.
Category slug.
The game's rank in the category.
The game's official server, when it has one.
Server id.
Server name.
Server icon URL.
Server banner URL.
Server description.
The server's invite link, when it has one.
Member count.
Online count.
Whether the server has a public web page.
The server's web page slug, when it has one.
Whether the server is verified.
Whether the server is partnered.
Leaderboards for the other categories, on a category list. Empty on the overall list.
The sibling category slug.
The sibling category image URL.
A few top games in the sibling category.
Application id.
Game name.
Published weeks and category-weeks when `include=weeks` was asked for; otherwise empty.
The published week date, YYYY-MM-DD.
The category the week belongs to; null for overall.
The catalogue's last-modified date, when it has one.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/discord/games/trending?category=shooter" \
-H "x-api-key: YOUR_API_KEY"Responses
A weekly trending list.