Social Fetch
Start for freeStart free
Discord hub

Discord Server Directory API

The public server directory as paged JSON, one category at a time.

GET /v1/discord/servers

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/discord/servers returns a page of results from the public directory. The first page lists the largest servers first; later pages follow the directory's own order. Each row has id, name, description, image URLs, members, online, countsAsOf (index for directory rows), boosts.count, locale, vanityCode, keywords, features, categories, primaryCategory, shape: browse, and a few flags that are null on browse rows.

A page holds 12 rows. Pick a category from gaming, music, entertainment, science-tech or education, and step through with page or the previous answer's page.nextCursor. The directory reorders between requests; numbered pages can repeat servers. Follow page.nextCursor to skip ones already returned. reachableSoFar counts rows in this walk, not the directory total, which is approximate. The directory stops at 3,000 rows; when limitReached is true the walk has reached that depth. Use the server index route to go past it.

Discord Server Directory API FAQ

Which categories can I browse?

gaming, music, entertainment, science-tech and education. Omit category for the whole directory.

How many servers can I reach by browsing?

3,000 rows, or 250 pages of 12. limitReached turns true when the walk stops at that depth while more rows exist. The server index route returns ids past it.

How do I continue to the next page?

Send page.nextCursor from the previous response as cursor. A cursor only works with the same category, so a cursor issued for gaming cannot be used on music. The directory reorders between requests; numbered pages can repeat servers, so the cursor drops ids already returned.

How are the rows ordered?

The first page lists the largest servers first. Later pages follow the directory's own order, so member counts are not strictly descending. Members and online are indexed counts on directory rows, so they can lag the live count you get from an invite.

How many credits does a browse page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

Other Discord endpoints