List Discord servers
List the public Discord server directory by category, with the largest servers first on the first page.
Headers
Get your API keyAPI key (`sfk_...`)
Directory category: `gaming`, `music`, `entertainment`, `science-tech` or `education`.
one of: gaming, music, entertainment, science-tech, education
Page number, 1 to 250. Omit for the first page. The directory reorders between requests, so numbered pages can repeat servers; follow `page.nextCursor` instead.
≥ 1 · ≤ 250
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
`found` for a page of the directory, including an empty page past the last row.
one of: found, not_found, restricted
The directory category of this page; null for the home page.
one of: gaming, music, entertainment, science-tech, education, null
The servers on this page.
Server id.
Server name.
Short description.
Server icon URL.
Invite splash URL.
Discovery splash URL.
Banner URL.
Indexed member count.
Indexed online count.
Always `index` for directory rows.
one of: live, index
Boost count; browse rows only.
Boost count.
Preferred locale.
Verification level; not present on directory rows.
one of: none, low, medium, high, very_high, unknown, null
Age restriction; not present on directory rows.
NSFW level; not present on directory rows.
Vanity invite code; browse rows only.
Search keywords; browse rows only.
Feature flags, passed through.
Categories; browse rows only.
Category id.
Category name; null when unknown.
True on `primaryCategory`, which is primary by definition. On a list entry, whether it is the server's primary category, or null when the page names no primary.
Localised category names, keyed by locale, passed through.
Primary category; browse rows only.
Category id.
Category name; null when unknown.
True on `primaryCategory`, which is primary by definition. On a list entry, whether it is the server's primary category, or null when the page names no primary.
Localised category names, keyed by locale, passed through.
Verified flag. Search rows carry it directly; browse rows derive it from the `VERIFIED` feature.
Partnered flag. Search rows carry it directly; browse rows derive it from the `PARTNERED` feature.
Whether the row is marked auto-removed; browse only.
Whether the row is published; browse only.
Which directory result shape this row came from.
one of: browse, search
Pagination state for the current page. A list that reorders between requests can repeat rows on numbered pages; follow `page.nextCursor` to continue from the previous page's position.
The page this response is.
Whether another page is available.
Cursor for the next page; null on the last page.
How many rows this walk has reached, counting this page. It is not the directory total, which is approximate.
True when the walk stopped at the directory's 3,000-row browse depth rather than at the end of the results.
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/servers?category=gaming" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of the server directory.