disdex: Discord server search

Search public Discord servers indexed by disdex. Matches words against the server name, vanity URL, description, profile traits and guild tag. With a query, results are ranked by relevance (servers named for the query first, then matches in traits and descriptions, with bigger and more active servers first among similar matches); without one, by member count. Each result has its member and online counts, language, and a joinable invite link when one is known. If no server matches every word of a longer query, results match all but one word and partial_match is true. NSFW servers are never returned.

{
  "type": "object",
  "properties": {
    "growing_within_days": {
      "description": "Only servers whose member count was seen going up within this many days. A quick filter for active, growing communities.",
      "maximum": 365,
      "minimum": 1,
      "type": "integer"
    },
    "language": {
      "description": "Only servers whose name and description are in this language: an ISO 639-1 code such as en, es, de, pt, ru, ja.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    },
    "query": {
      "description": "Search words, at least 3 letters or digits (e.g. \"minecraft survival\", \"study group\"). Omit to browse everything by the chosen sort.",
      "type": "string"
    },
    "sort": {
      "description": "Defaults to relevance with a query and members without one. members/online/boosts sort largest first; newest/oldest sort by when the server was created on Discord.",
      "enum": [
        "relevance",
        "members",
        "online",
        "boosts",
        "newest",
        "oldest"
      ],
      "type": "string"
    },
    "tag": {
      "description": "Only servers with this Discord guild tag (the short tag members can show next to their name), case-insensitive exact match.",
      "type": "string"
    }
  },
  "additionalProperties": false
}

Full details for one Discord server: description, member/online/boost counts, language, guild tag, Discord features, invite link, and how its member count changed over the last 30 days.

{
  "type": "object",
  "properties": {
    "server_id": {
      "description": "Discord server (guild) id, as returned by search_servers.",
      "pattern": "^[0-9]{15,21}$",
      "type": "string"
    }
  },
  "required": [
    "server_id"
  ],
  "additionalProperties": false
}

Daily member and online counts for one Discord server over a time window, for questions like "is this server growing?" or "how big was it in March?". Values are daily averages of disdex's scans.

{
  "type": "object",
  "properties": {
    "range": {
      "default": "30d",
      "enum": [
        "7d",
        "30d",
        "90d",
        "1y"
      ],
      "type": "string"
    },
    "server_id": {
      "description": "Discord server (guild) id, as returned by search_servers.",
      "pattern": "^[0-9]{15,21}$",
      "type": "string"
    }
  },
  "required": [
    "server_id"
  ],
  "additionalProperties": false
}

Look up a Discord invite link or code (discord.gg/abc, discord.com/invite/abc, or just abc). Says whether disdex last saw it working (live), confirmed it dead, is still checking it (pending), or has never seen it (unknown), and which server it leads to, including dead invites, together with other working invites for that server when known.

{
  "type": "object",
  "properties": {
    "invite": {
      "description": "Invite URL or bare invite code.",
      "type": "string"
    }
  },
  "required": [
    "invite"
  ],
  "additionalProperties": false
}

How many Discord servers, users, bots, games and invites disdex has indexed, and when those totals were last refreshed.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}