Social Fetch
Start for freeStart free
Discord hub

Discord Server Search API

Keyword search across the public server directory, ordered by relevance.

GET /v1/discord/servers/search

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/discord/servers/search?query=python returns results ordered by relevance, up to 12 a page. Each row is the same directory shape as a browse row, with shape: search; search rows also carry verified and partnered flags, and their boosts, keywords, categories and primaryCategory are null or empty because those fields are not part of the search result.

Add category to search inside one of gaming, music, entertainment, science-tech or education. Page with page or the previous answer's page.nextCursor. Search returns up to six pages, so the walk stops on page 6 and limitReached is true when more rows were reported than those pages returned. page is capped at 6, so page 7 is a 400. reachableSoFar counts rows reached in this walk; the reported hit total is far larger than the rows returned, so the response does not present it as a total.

Discord Server Search API FAQ

How does the query match?

Words are matched case-insensitively, with whole-word and prefix matching. Keep the query under 200 characters.

How deep can I page search results?

Six pages of up to 12 rows. page is capped at 6, so page 7 is a 400. limitReached is true on page 6 when more rows were reported than those pages returned. There is no total count you can rely on.

Can I search inside one category?

Yes. Add category with a value such as gaming and the search stays inside that part of the directory. The category is echoed in data.category.

How many credits does a search 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