Public API

Free, unauthenticated JSON API for searching XDCC packs, querying site statistics, and listing networks. No API key required for the public endpoints.

Base URL https://xdcc.info/api/v1

Format All responses are JSON. Pass Content-Type: application/json on POST requests.

GET /api/v1/search Search packs

Full-text search across all indexed XDCC packs. Returns paginated results with bot, network, and file metadata.

Query Parameters

Parameter	Type	Required	Description
`q`	string	required	Search query. Matched against filenames using full-text search.
`network`	string	optional	Filter by network name (e.g. `Rizon`).
`category`	string	optional	Filter by content category: `movies`, `tv`, `music`, `games`, `software`, `books`, `other`.
`quality`	string	optional	Filter by quality tag (e.g. `1080p`, `720p`, `4K`).
`sort`	string	optional	Sort field. One of `last_seen` (default), `filename`, `filesize`, `gets`.
`sortDir`	string	optional	`desc` (default) or `asc`.
`page`	integer	optional	Page number, 1-based. Default: `1`.
`limit`	integer	optional	Results per page. Default: `50`. Max: `200`.

Response

{
  "total":   1842,
  "page":    1,
  "limit":   50,
  "sort":    "last_seen",
  "sortDir": "desc",
  "results": [
    {
      "id":              12345,
      "pack_num":        42,
      "filename":        "The.Movie.2024.1080p.BluRay.mkv",
      "filesize":        9663676416,
      "filesize_fmt":    "9.00 GB",
      "gets":            87,
      "bot":             "|BestBot|",
      "bot_channel":     "#movies",
      "network":         "Rizon",
      "network_address": "irc.rizon.net",
      "last_seen":       "2025-11-14 08:32:11",
      "category":        "movies",
      "quality":         "1080p",
      "source":          "bluray"
    }
  ]
}

Example

curl "https://xdcc.info/api/v1/search?q=the+movie&network=Rizon&limit=10"

GET /api/v1/stats Site statistics

Returns aggregate counts for the whole index — useful for status dashboards or checking index freshness.

Response

{
  "pack_count":    4200000,
  "bot_count":     1240,
  "network_count": 8,
  "last_updated":  "2025-11-14 12:00:00"
}

Example

curl "https://xdcc.info/api/v1/stats"

GET /api/v1/networks List networks

Returns all indexed IRC networks with their pack and bot counts. Useful for building network filter UIs or aggregating stats per network.

Response

[
  {
    "id":         1,
    "name":       "Rizon",
    "address":    "irc.rizon.net",
    "pack_count": 1200000,
    "bot_count":  340
  }
]

Example

curl "https://xdcc.info/api/v1/networks"

Errors

All errors return a JSON object with an error key and an appropriate HTTP status code.

// 400 Bad Request
{ "error": "Missing required parameter: q" }

// 500 Internal Server Error
{ "error": "Search failed", "detail": "..." }

Usage Notes

The public endpoints are rate-limited per IP. Please cache responses on your end and avoid hammering the search endpoint in tight loops. If you're building something cool and need higher limits, get in touch.

The index is updated continuously as bots announce new packs on IRC. last_seen reflects when a pack was last seen advertised — not when the file was created.

This API is provided free of charge with no guarantees of uptime or stability. It is intended for personal projects and tools — not for commercial redistribution of the index data.