> **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):** - **Markdown (.mdx) URL:** --- # Discord Server Search API Keyword search across the public server directory, ordered by relevance. `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. ## Request - **Endpoint:** `GET /v1/discord/servers/search` - **Credits:** 1 credit Failed requests are free - **Input:** by query - **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/discord/servers/search/get) - **Platform page:** [/platforms/discord](https://www.socialfetch.dev/platforms/discord) ## 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.