> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/discord/servers>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/discord/servers.mdx>

---

# Discord Server Directory API

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

`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.

## Request

- **Endpoint:** `GET /v1/discord/servers`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by category and page
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/discord/servers/get)
- **Platform page:** [/platforms/discord](https://www.socialfetch.dev/platforms/discord)

## 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.