Public API
Show directory servers on your site or in your bot. Create your key in My space, API tab.
- Read-onlySearch and public listings
- 60 requests per minutePer key
- One key per developerAuthorization: Bearer header
GET/api/v1/servers
Search published servers.
| Parameter | Purpose |
|---|---|
| q | Search text |
| category | Category slug, e.g. gaming |
| tags | Comma-separated tags |
| lang | Main language, e.g. fr |
| size | xs, s, m, l |
| premium | 1 for Premium servers only |
| sort | relevance, bumped, members, rating, newest |
| page, perPage | Pagination, 50 results max per page |
curl
curl -H "Authorization: Bearer ak_..." "https://listcord.me/api/v1/servers?q=minecraft&sort=members"
GET/api/v1/servers/{id}
One public listing.
curl
curl -H "Authorization: Bearer ak_..." "https://listcord.me/api/v1/servers/42"
Response
{
"id": 42, "guild_id": "1234567890", "name": "…", "slug": "…", "short_description": "…",
"category": "gaming", "tags": ["minecraft"], "language": "fr", "member_count": 1200,
"online_count": 310, "last_bump_at": "2026-11-05T10:00:00Z", "premium": false,
"rating": 4.6, "review_count": 18
}Widget
For a listed server's website. Ready-to-copy code is also in Manage, Settings tab.
HTML
<iframe src="https://listcord.me/widget/42?lang=en&theme=dark" width="420" height="80" style="border:0"></iframe> <img src="https://listcord.me/api/badge/42?lang=en" alt="">
Errors
- 401
- Missing or invalid key
- 404
- Server not found
- 429
- Rate limited: retry after the Retry-After header delay