Developer API | DBase IRC Database

Developer API

A free, read-only JSON API over our directory of IRC networks, servers and channels. Use it to embed live IRC data in your own app, bot or website (for example an IRC client that lets users browse and join networks). Data comes from scanning public IRC networks.

Basics

  • Base URL: https://irc.dbase.in.rs
  • All responses are JSON (the badge endpoint returns SVG).
  • Public endpoints need no authentication.
  • Rate limits: 120 req/min for the directory, 60 req/min for server presets (per IP).
  • Please cache responses; the data changes only when networks are rescanned.

Public endpoints

GET /api/v1/public/networks

All approved networks, busiest first. Optional cap: only networks with at least one listed server supporting that IRCv3 capability (see capabilities).

curl https://irc.dbase.in.rs/api/v1/public/networks
curl "https://irc.dbase.in.rs/api/v1/public/networks?cap=draft/chathistory"
{
  "data": [
    {
      "rank": 1,
      "name": "DBase",
      "slug": "dbase",
      "average_users": 73,
      "scanned_servers": 2,
      "url": "https://irc.dbase.in.rs/irc/networks/dbase",
      "badge_url": "https://irc.dbase.in.rs/api/v1/public/networks/dbase/badge"
    }
  ]
}
GET /api/v1/public/capabilities

Every IRCv3 capability (CAP LS) seen on listed servers, most common first, with how many servers and networks support it. Use a name as the cap filter on the networks list and on server presets, e.g. to offer only servers with sasl, draft/chathistory (scrollback), message-tags, echo-message or draft/multiline in your client. Names are normalized so each feature is counted once: draft/ and vendor-prefixed spellings of a standard capability are merged (draft/chathistory = chathistory, ircnet.com/extended-join = extended-join), and every network counts once however many servers it has. The cap filter accepts either spelling. Per-server capabilities lists keep the raw names the IRCd announced. Values are lowercase; the same filter exists on the website: servers and networks.

curl https://irc.dbase.in.rs/api/v1/public/capabilities
{
  "data": [
    { "name": "multi-prefix", "servers": 80, "networks": 32, "network_percent": 88.9 },
    { "name": "sasl", "servers": 63, "networks": 30, "network_percent": 83.3 },
    { "name": "chathistory", "servers": 34, "networks": 14, "network_percent": 38.9 }
  ]
}
GET /api/v1/public/networks/{slug}

One network with its servers and busiest channels.

curl https://irc.dbase.in.rs/api/v1/public/networks/dbase
{
  "data": {
    "name": "DBase",
    "slug": "dbase",
    "description": "...",
    "website": "https://...",
    "country": "RS",
    "languages": ["en", "sr"],
    "rank": 1,
    "average_users": 73,
    "url": "https://irc.dbase.in.rs/irc/networks/dbase",
    "servers": [
      {
        "hostname": "irc.dbase.in.rs",
        "port": 6697,
        "tls": true,
        "country": "RS",
        "ircd": "UnrealIRCd-6",
        "last_scanned_at": "2026-11-08T12:00:00+00:00",
        "online": true,
        "tls_cert_expires_at": "2027-01-01T00:00:00+00:00",
        "capabilities": ["sasl", "message-tags", "server-time"]
      }
    ],
    "top_channels": [
      { "name": "#DBase", "users": 73, "topic": "plain text", "topic_raw": "with IRC colour codes", "url": "https://irc.dbase.in.rs/irc/networks/dbase/channels/dbase" }
    ]
  }
}
GET /api/v1/public/networks/{slug}/channels

Paginated channel list. Query params: page, per_page (1-100, default 50), include_archived=1 (also channels not seen for 69+ days; hidden by default).

curl "https://irc.dbase.in.rs/api/v1/public/networks/dbase/channels?per_page=50&page=1"
{
  "data": [
    { "name": "#DBase", "users": 73, "topic": "...", "updated_at": "2026-11-08T12:00:00+00:00", "url": "..." }
  ],
  "meta": { "current_page": 1, "per_page": 50, "total": 120, "last_page": 3 }
}
GET /api/v1/public/networks/{slug}/badge

An SVG status badge you can embed anywhere.

<img src="https://irc.dbase.in.rs/api/v1/public/networks/dbase/badge" alt="dbase on DBase">
badge preview
GET /api/v1/public/networks/{slug}/channels/{channel}/badge

Live user count of one channel as an SVG badge. {channel} is the name without the leading #, as in the channel page URL.

<img src="https://irc.dbase.in.rs/api/v1/public/networks/dbase/channels/DBase/badge" alt="#DBase on DBase">
channel badge preview
GET /api/irc/server-presets

Ready-to-use connection presets (host, port, TLS, IRCd, IRCv3 capabilities) for approved networks with a scanned server. Handy to pre-fill an IRC client. Paginated: page, per_page (1-100). Optional cap: keep only servers supporting that capability (networks left without a server are dropped), so an app can show, for example, only servers with SASL or chat history.

curl https://irc.dbase.in.rs/api/irc/server-presets
curl "https://irc.dbase.in.rs/api/irc/server-presets?cap=sasl&per_page=100"
{
  "data": [
    {
      "network_name": "DBase",
      "average_users": 73,
      "server_list": [
        {
          "hostname": "irc.dbase.in.rs",
          "port": 6697,
          "use_ssl": true,
          "ircd": "UnrealIRCd-6.2.x",
          "last_scanned_at": "2026-11-09T20:00:00+01:00",
          "capabilities": ["sasl", "message-tags", "draft/chathistory", "..."]
        }
      ]
    }
  ],
  "meta": { "pagination": { "current_page": 1, "per_page": 100, "total": 40 } }
}

Authenticated content API

Richer, token-protected endpoints under /api/v1/content/* (networks and blog posts). Create an API token in your account under API Tokens with the content:read ability, then send it as a Bearer token.

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     https://irc.dbase.in.rs/api/v1/content/networks

Fair use

The API is free. Please cache results, stay within the rate limits, and a link back to irc.dbase.in.rs is appreciated. Questions or need higher limits? Ask a network admin.

Consentement aux Cookies

Nous utilisons des cookies pour améliorer votre expérience de navigation, analyser le trafic du site et personnaliser le contenu. En cliquant sur "Accepter", vous acceptez notre utilisation des cookies conformément à notre Politique de Confidentialité et aux réglementations GDPR. En savoir plus sur notre politique de confidentialité