🔌 Wolffiles API

Free public REST API for Wolfenstein: Enemy Territory file data. No authentication required.

✅ Free 🔓 No Auth Required 📦 JSON Responses ⚡ 60 req/min

Base URL

https://wolffiles.eu/api/v1

📁 Files

Search through all approved files. Returns matching files with metadata.

Parameters

qSearch query (required)

gameFilter by game: ET, RtCW (optional)

categoryFilter by category slug (optional)

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/files/search?q=goldrush&limit=5

Returns the most recently uploaded and approved files.

Parameters

gameFilter by game: ET, RtCW (optional)

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/files/latest?limit=5

Returns a single random approved file. Great for discover features.

Parameters

gameFilter by game: ET, RtCW (optional)

Example Request

GET https://wolffiles.eu/api/v1/files/random

Returns files sorted by download count.

Parameters

periodTime period: all, month, week (optional)

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/files/top?period=month&limit=5

Returns files with highest trending score based on recent activity.

Parameters

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/files/trending?limit=5

Returns the currently featured editor pick file.

Example Request

GET https://wolffiles.eu/api/v1/files/featured

Returns full details for a specific file including readme content.

Path Parameters

idFile ID (required)

Response Fields

idinteger

titlestring

slugstring

categorystring

gamestring — ET, RtCW

map_namestring|null

file_sizestring — "4.2 MB"

download_countinteger

average_ratingfloat — 0.0–5.0

urlstring

download_urlstring

thumbnailstring|null

authorstring|null

published_atISO 8601

mod_compatibilitystring|null

readme_contentstring|null

descriptionstring|null

versionstring|null

tagsarray

screenshotsarray

Example Request

GET https://wolffiles.eu/api/v1/files/1

📊 Statistics

Returns aggregate statistics about the Wolffiles platform.

Example Request

GET https://wolffiles.eu/api/v1/stats

📖 Wiki & Tutorials

Search through wiki articles about ET gameplay, mapping and modding.

Parameters

qSearch query (required)

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/wiki/search?q=mapping

Search through ET tutorials and guides.

Parameters

qSearch query (required)

limitMax results (default: 10, max: 50) (optional)

Example Request

GET https://wolffiles.eu/api/v1/tutorials/search?q=install

📡 Tracker API

Returns the current number of players and servers online across all tracked games.

Example Request

GET https://wolffiles.eu/api/v1/tracker/online

Returns server and player counts broken down by game (ET 2.60b, ETL, RtCW, etc.).

Example Request

GET https://wolffiles.eu/api/v1/tracker/stats

Returns all currently online servers, sorted by player count. Filter by game slug.

Parameters

gameFilter by game slug (e.g. etl, et-260b) (optional)

Example Request

GET https://wolffiles.eu/api/v1/tracker/servers?game=etl

Returns the most populated servers currently online. Max 25.

Parameters

limitNumber of results, max 25 (optional, default 10)

Example Request

GET https://wolffiles.eu/api/v1/tracker/servers/top?limit=5

Returns all servers currently playing the given map, plus historical stats (times played, peak players, avg players).

Path Parameter

mapNameMap filename without extension (e.g. venice, supply) (required)

Example Request

GET https://wolffiles.eu/api/v1/tracker/maps/venice

Search tracked players by name. Minimum 2 characters required.

Parameters

qPlayer name (min 2 chars) (required)

Example Request

GET https://wolffiles.eu/api/v1/tracker/players/search?q=ninja

Returns top players sorted by ELO, kills, playtime, or K/D ratio. Max 25.

Parameters

sortelo / kills / playtime / kd (optional, default elo)

limitNumber of results, max 25 (optional, default 10)

Example Request

GET https://wolffiles.eu/api/v1/tracker/players/top?sort=elo&limit=10

Returns full profile for a tracked player including ELO, stats, and last 5 sessions.

Path Parameter

idPlayer ID (required)

Example Request

GET https://wolffiles.eu/api/v1/tracker/players/1

Returns paginated player rankings for a given period.

Parameters

periodalltime / month / week (optional, default alltime)

limitResults per page (optional, default 50)

Example Request

GET https://wolffiles.eu/api/v1/tracker/rankings?period=month&limit=10

Returns active clans sorted by member count. Optionally search by tag or name.

Parameters

qSearch by clan tag or name (optional)

limitResults per page (optional, default 50)

Example Request

GET https://wolffiles.eu/api/v1/tracker/clans?q=etj

⚠️ Rate Limits & Usage

The API is rate limited to 60 requests per minute. Please be respectful with your usage.

Need higher limits? Contact us. Kontakt

💻 Code Examples

curl -s "https://wolffiles.eu/api/v1/files/search?q=goldrush" | python3 -m json.tool

const res = await fetch('https://wolffiles.eu/api/v1/files/search?q=goldrush');
const data = await res.json();
data.results.forEach(f => console.log(`${f.title} — ${f.download_count} downloads`));

import requests

r = requests.get('https://wolffiles.eu/api/v1/files/search', params={'q': 'goldrush', 'limit': 5})
for f in r.json()['results']:
    print(f"{f['title']} — {f['download_count']} downloads")

$data = json_decode(file_get_contents(
    'https://wolffiles.eu/api/v1/files/search?q=goldrush'
), true);
foreach ($data['results'] as $file) {
    echo $file['title'] . ' — ' . $file['download_count'] . " downloads\n";
}

// Discord.js v14 slash command example
const res = await fetch('https://wolffiles.eu/api/v1/files/search?q=' + query);
const { results } = await res.json();
const embed = new EmbedBuilder()
    .setTitle(results[0].title)
    .setURL(results[0].url)
    .addFields(
        { name: 'Downloads', value: String(results[0].download_count), inline: true },
        { name: 'Game', value: results[0].game ?? 'ET', inline: true }
    );
await interaction.reply({ embeds: [embed] });

Returns full server details including IP, map, players, and banner/embed URLs ready for use.