Search Discord servers
Search the public Discord server directory by relevance, with an optional category filter.
Headers
Get your API keyAPI key (`sfk_...`)
Words to search the public server directory for. Case-insensitive; whole-word and prefix matching.
min 1 chars · max 200 chars
Directory category: `gaming`, `music`, `entertainment`, `science-tech` or `education`.
one of: gaming, music, entertainment, science-tech, education
Page number, 1 to 6. Each page returns up to 12 servers; omit for the first page and pass `page.nextCursor` to continue.
≥ 1 · ≤ 6
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 search results, including an empty page.
one of: found, not_found, restricted
The query that was searched.
The category filter; null when searching the whole directory.
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 a reported total.
True when the walk stopped at the sixth page while Discord reported more results than those pages hold.
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/search?query=python" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of server search results.