🔌 Wolffiles API

API REST publique et gratuite pour les données de fichiers Wolfenstein: Enemy Territory. Aucune authentification requise.

✅ Gratuit 🔓 Sans authentification 📦 Réponses JSON ⚡ 60 req/min

URL de base

https://wolffiles.eu/api/v1

📁 Fichiers

Recherche dans tous les fichiers approuvés avec métadonnées.

Paramètres

qTerme de recherche (obligatoire)

gameFiltrer par jeu: ET, RtCW (optionnel)

categoryFiltrer par slug de catégorie (optionnel)

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

Retourne les fichiers les plus récemment uploadés et approuvés.

Paramètres

gameFiltrer par jeu: ET, RtCW (optionnel)

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

Retourne un fichier aléatoire approuvé.

Paramètres

gameFiltrer par jeu: ET, RtCW (optionnel)

Exemple de requête

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

Retourne les fichiers triés par nombre de téléchargements.

Paramètres

periodPériode: all, month, week (optionnel)

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

Retourne les fichiers avec le score tendance le plus élevé.

Paramètres

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

Retourne le fichier mis en avant par l'éditeur.

Exemple de requête

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

Retourne les détails complets pour un fichier spécifique.

Paramètres de chemin

idID du fichier (obligatoire)

Champs de réponse

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

Exemple de requête

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

📊 Statistiques

Retourne des statistiques agrégées sur la plateforme Wolffiles.

Exemple de requête

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

📖 Wiki & Tutoriels

Recherche dans les articles wiki sur ET, le mapping et le modding.

Paramètres

qTerme de recherche (obligatoire)

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

Recherche dans les tutoriels ET.

Paramètres

qTerme de recherche (obligatoire)

limitRésultats max (défaut: 10, max: 50) (optionnel)

Exemple de requête

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

⚠️ Limites et utilisation

L'API est limitée à 60 requêtes par minute. Merci de l'utiliser de manière responsable.

Besoin de limites plus élevées? Contactez-nous. Nous contacter

💻 Exemples de code

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.