Documentation API
Catégories :
Twitch
Récupère les informations d'une channel Twitch
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/twitch/channel?username=mon_streamer
Réponse :
{
"user": {
"id": "48542412",
"login": "dear_voodoo",
"display_name": "Dear_VooDoo",
"profile_image_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/87d3bdf9-680f-48b3-b06b-37ddf92f01c2-profile_image-300x300.png",
"banner_image_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/3a260b61-1134-4cc6-8931-3a00c3474487-channel_offline_image.png",
"created_at": "2013-09-04T13:24:05Z"
},
"stream": {
"title": "Destiny 2 : Les Confins du Destin EST LAAAAAAA - !info !team",
"game_name": Destiny 2",
"viewer_count": 104,
"started_at": "2025-07-12T10:59:45Z",
"game_id": "497057",
"game_cover": "https://static-cdn.jtvnw.net/ttv-boxart/497057.jpg",
"stream_preview_image": "https://static-cdn.jtvnw.net/previews-ttv/live_user_dear_voodoo.jpg"
},
"access_level": "basic"
}
Récupère les informations d'un clip Twitch.
Exemple:
Sur ce lien de clip https://clips.twitch.tv/FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI
FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI est l'ID du clip
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/twitch/clip?id=FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI
Réponse :
{
"clip": {
"id": "FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI",
"url": "https://www.twitch.tv/hasanabi/clip/FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI",
"embed_url": "https://clips.twitch.tv/embed?clip=FlaccidZanyChickpeaAMPEnergyCherry-HgeJe06X5Z2KfhEI",
"broadcaster_id": "207813352",
"broadcaster_name": "HasanAbi",
"creator_id": "501574056",
"creator_name": "keeesh",
"video_id": "",
"game_id": "509658",
"language": "en",
"title": "SLAAYYYYY MIZ",
"view_count": 311381,
"created_at": "2025-02-04T04:20:57Z",
"thumbnail_url": "https://static-cdn.jtvnw.net/twitch-clips/jyaAux4HiXtOl-Wdin4RCA/AT-cm%7CjyaAux4HiXtOl-Wdin4RCA-preview-480x272.jpg",
"duration": 17.6,
"vod_offset": null,
"is_featured": false
},
"access_level": "basic"
}
Youtube
Récupère les informations d'une channel Youtube
ID = UCC3qjEASWsSJPX0ww_h4gXg
Handle =
@dearvoodooyt
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/youtube/channel?channel=@dearvoodooyt
Réponse :
{
"id": "UCC3qjEASWsSJPX0ww_h4gXg",
"handle": "@dearvoodooyt",
"title": "VooDoo",
"description": "Ici, tu trouveras des découvertes de jeux vidéo, des sessions photo en jeu, et des streams pleins d’aventures et d’histoires captivantes.\n\n🎮 Rejoins la communauté pour ne rien manquer !\n\n🔗 Mes liens utiles :\n👉 Découvre tout mon univers et mes réseaux sur mon Linktree : https://linktr.ee/dearvoodoo\n🌐 Visite mon site officiel pour plus de photos et contenus exclusifs : https://the-coven.fr/\n\nN’oublie pas de t’abonner et d’activer la cloche pour suivre mes prochaines vidéos !\n",
"published_at": "2014-02-04T04:12:56Z",
"thumbnail": "https://yt3.ggpht.com/wGvNjD6M37IaC3u7mpbxOROHycOCvqiBU8Q74uSS3C0yAjBwcTaXKe4YkXuFT2RsHIoYwS6tvA=s800-c-k-c0x00ffffff-no-rj",
"country": "FR",
"statistics": {
"view_count": "50842",
"subscriber_count": "6960",
"video_count": "155"
},
"keywords": null,
"access_level": "premium"
}
Récupère les informations d'une playlist Youtube
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/youtube/playlist?id=PLkkeULkGbNYRoR1cPNH1mCfcWtV-2yazT
Réponse :
{
"id": "PLkkeULkGbNYRoR1cPNH1mCfcWtV-2yazT",
"title": "Destiny 2",
"description": "",
"published_at": "2020-10-23T10:54:16.443222Z",
"channel_id": "UCC3qjEASWsSJPX0ww_h4gXg",
"channel_title": "VooDoo",
"thumbnail": {
"default": "https://i.ytimg.com/vi/cyD501spWVA/default.jpg",
"medium": "https://i.ytimg.com/vi/cyD501spWVA/mqdefault.jpg",
"high": "https://i.ytimg.com/vi/cyD501spWVA/hqdefault.jpg",
"standard": "https://i.ytimg.com/vi/cyD501spWVA/sddefault.jpg",
"maxres": "https://i.ytimg.com/vi/cyD501spWVA/maxresdefault.jpg"
},
"itemCount": 18,
"privacyStatus": "public",
"videos": [
{
"videoId": "cyD501spWVA",
"title": "Le sort de Cayde - Destiny 2",
"description": "J'ai aussi un planning dispo ici https://dearvoodoo.fr/?planning=show\n(Il change toutes les semaines)\n\nPC setup:\nMSI PRO Z690-A Wifi, i9-12900KF CPU, RTX 3080, 32GB DDR4 3200 C16 Ram, 1TB NVMe M.2 SSD, 3TB HDD\n\n==================================================\n\nSUBSCRIBE HERE: https://subs.twitch.tv/dear_voodoo\nSUPPORT ME ON KOFI: https://ko-fi.com/voodoo_\nThank you so much for your support!\n\n==================================================\n\n#france #letsplay #twitch #destiny2 #destiny2seasonofthewitch #destiny2season22 #destiny2lightfall",
"position": 0,
"publishedAt": "2023-08-23T14:44:58Z",
"thumbnail": "https://i.ytimg.com/vi/cyD501spWVA/hqdefault.jpg"
},
{... les 17 autres vidéos ...}
],
"access_level": "premium"
}
Récupère les informations d'une video Youtube
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/youtube/video?id=cyD501spWVA
Réponse :
"id": "cyD501spWVA",
"title": "Le sort de Cayde - Destiny 2",
"description": "J'ai aussi un planning dispo ici https://dearvoodoo.fr/?planning=show\n(Il change toutes les semaines)\n\nPC setup:\nMSI PRO Z690-A Wifi, i9-12900KF CPU, RTX 3080, 32GB DDR4 3200 C16 Ram, 1TB NVMe M.2 SSD, 3TB HDD\n\n==================================================\n\nSUBSCRIBE HERE: https://subs.twitch.tv/dear_voodoo\nSUPPORT ME ON KOFI: https://ko-fi.com/voodoo_\nThank you so much for your support!\n\n==================================================\n\n#france #letsplay #twitch #destiny2 #destiny2seasonofthewitch #destiny2season22 #destiny2lightfall",
"published_at": "2023-08-23T15:30:45Z",
"channel_id": "UCC3qjEASWsSJPX0ww_h4gXg",
"channel_title": "VooDoo",
"tags": [
"VooDoo",
"Dear_VooDoo",
"DearVooDoo",
"faceless",
"vtuber",
"français",
"french",
"english",
"fr/en",
"destiny 2",
"destiny",
"season of the witch",
"season 22",
"saison 22",
"saison de la sorcière"
],
"thumbnail": {
"default": "https://i.ytimg.com/vi/cyD501spWVA/default.jpg",
"medium": "https://i.ytimg.com/vi/cyD501spWVA/mqdefault.jpg",
"high": "https://i.ytimg.com/vi/cyD501spWVA/hqdefault.jpg",
"standard": "https://i.ytimg.com/vi/cyD501spWVA/sddefault.jpg",
"maxres": "https://i.ytimg.com/vi/cyD501spWVA/maxresdefault.jpg"
},
"duration": {
"formated": "18 min 24 sec",
"raw": "PT18M24S"
},
"view": "305",
"like": 0,
"comment": "4",
"definition": "hd",
"caption": "false"
}
Steam
Récupère les informations d'un jeu sur Steam
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/steam/game?appid=1085660
Réponse :
{
"game": {
"id": "1085660",
"name": "Destiny 2",
"short_description": "Destiny 2 is an action MMO with a single evolving world that you and your friends can join anytime, anywhere, absolutely free.",
"header_image": "https://shared.akamai.steamstatic.com/store_item_assets/steam/apps/1085660/header.jpg?t=1753830262",
"developers": [
"Bungie"
],
"publishers": [
"Bungie"
],
"price": null,
"metacritic": {
"score": 83,
"url": "https://www.metacritic.com/game/pc/destiny-2?ftag=MCD-06-10aaa1f"
},
"categories": [
{
"id": 2,
"description": "Single-player"
},
{
"id": 1,
"description": "Multi-player"
},
{...}
],
"genres": [
{
"id": "1",
"description": "Action"
},
{
"id": "25",
"description": "Adventure"
},
{...}
],
"release_date": {
"coming_soon": false,
"date": "1 Oct, 2019"
},
"platforms": {
"windows": true,
"mac": false,
"linux": false
}
},
"players": {
"current": 21557,
"result": "success"
},
"access_level": "basic"
}
Destiny 2
Recherche des gardiens via leur tag Bungie au format Guardian#0001.
Vous pouvez ajouter la query emblem=true pour inclure l’URL de l’emblème du premier personnage du gardien.
Note : L’utilisation de ce paramètre peut ralentir la réponse de l’endpoint. Ne l’ajoutez que si nécessaire.
Note : le caractère # est encodé en %23 dans l’URL.
Par exemple, VooDoo#0806 devient VooDoo%230806.
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/destiny/search?prefix=voodoo%2308
Réponse :
{
"success": true,
"query": "voodoo#08",
"results": [
{
"name": "VooDoo#0806",
"bungieNetMembershipId": "14927183",
"membershipId": "4611686018467190713",
"membershipType": 3,
"icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
"emblemPath": "https://bungie.net/common/destiny2_content/icons/9450a105c8cc16aa559febc7312b522a.jpg"
},
{
"name": "Voodoo#0839",
"bungieNetMembershipId": "18781523",
"membershipId": "4611686018482020821",
"membershipType": 3,
"icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
"emblemPath": "https://bungie.net/common/destiny2_content/icons/fb7cf21487dffd363ec02127c4993346.jpg"
},
{
"name": "VooDoo#0868",
"bungieNetMembershipId": "26306782",
"membershipId": "4611686018491404073",
"membershipType": 3,
"icon": "https://bungie.net/img/theme/bungienet/icons/steamLogo.png",
"emblemPath": "https://bungie.net/common/destiny2_content/icons/24e9133c9cc157853762de5a2c3853aa.jpg"
}
],
"AccessLevel": "premium"
}
Permet de récupérer les informations détaillées d’un gardien Destiny 2 à partir de son tag
Bungie complet (format : Nom#0000).
- Le paramètre name est obligatoire et doit respecter le format exact,
incluant le
#suivi du code à 4 chiffres (exemple :VooDoo#0806). - L’endpoint recherche d’abord le gardien via l’API Bungie avec ce tag, puis récupère son
profil complet, incluant :
- Les informations de base du profil (nom, ID, type d’abonnement)
- La liste des personnages avec leurs données détaillées (dont les chemins vers leurs emblems)
- En cas d’erreur, un message clair est renvoyé pour faciliter le debug (format invalide, gardien non trouvé, problème API, etc.).
Note :
Dans l’URL, le caractère # doit être encodé en %23.
Par exemple, VooDoo#0806 devient VooDoo%230806.
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/destiny/guardian?name=voodoo%230806
Réponse :
{
"membershipId": "4611686018467190713",
"membershipType": 3,
"displayName": "VooDoo",
"bungieDisplayName": "VooDoo#0806",
"dateLastPlayed": "2025-07-25T09:50:58Z",
"characterIds": [
"2305843009299525930",
"2305843009302904780",
"2305843009313535740"
],
"characters": {
"2305843009299525930": {
"membershipId": "4611686018467190713",
"membershipType": 3,
"characterId": "2305843009299525930",
"dateLastPlayed": "2025-07-24T13:02:57Z",
"minutesPlayedThisSession": "15",
"minutesPlayedTotal": "72433",
"light": 213,
"stats": {
"144602215": 41,
"392767087": 77,
"1735777505": 59,
"1935470627": 213,
"1943323491": 63,
"2996146975": 61,
"4244567218": 126
},
"raceHash": 2803282938,
"genderHash": 2204441813,
"classHash": 671679327,
"raceType": 1,
"classType": 1,
"genderType": 1,
"emblemPath": "https://bungie.net/common/destiny2_content/icons/9450a105c8cc16aa559febc7312b522a.jpg",
"emblemBackgroundPath": "https://bungie.net/common/destiny2_content/icons/f4db2825bf1c3d2afd3fe3436533e377.jpg",
"emblemHash": 131450130,
"emblemColor": {
"red": 0,
"green": 0,
"blue": 0,
"alpha": 255
},
"levelProgression": {
"progressionHash": 1716568313,
"dailyProgress": 0,
"dailyLimit": 0,
"weeklyProgress": 0,
"weeklyLimit": 0,
"currentProgress": 0,
"level": 50,
"levelCap": 50,
"stepIndex": 50,
"progressToNextLevel": 0,
"nextLevelAt": 0
},
"baseCharacterLevel": 50,
"percentToNextLevel": 0,
"titleRecordHash": 3137935313
},
"2305843009302904780": {...},
"2305843009313535740": {...}
},
"AccessLevel": "premium"
}
Permet de récupérer la liste complète des récompenses spéciales (emblèmes, emotes, transmat, shaders) distribuées par Bungie via des codes promotionnels, avec leurs détails et leur statut de possession.
- Le paramètre guardian est optionnel. Il doit contenir l’ID d’un gardien Destiny 2.
- Le paramètre type est également optionnel et correspond au type de compte Bungie :
1: Xbox2: PlayStation3: Steam (par défaut si non précisé)4: Battle.net5: Stadia6: Epic Games
- L’endpoint retourne, pour chaque catégorie de récompense :
- Le
coded’activation - La
descriptionet lacollectibleHash - Les données issues du manifest Bungie : nom, icône principale, icône secondaire
- Et si un identifiant de gardien est fourni : le statut
owned(booléen) et lestatecomplet
- Le
- Si aucun gardien n’est précisé, les champs
ownedetstatesont renvoyés ànull. - Le contenu est toujours enrichi depuis le manifest Destiny 2 afin d’inclure les visuels et les noms, même sans identifiant de gardien.
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/destiny/ue?guardian=4611686018467190713&type=3
Réponse :
{
"success": true,
"guardian": "4611686018467190713",
"membershipType": 3,
"emblems": [
{
"id": "1968995954",
"code": "JXJ-HVA-RCX",
"info": "Distributed by Bungie via social media channels on 2025-05-01 in the lead up to the Edge of fate reveal stream.",
"collectibleHash": 2006613212,
"name": "Ever Forward",
"icon": "https://bungie.net/common/destiny2_content/icons/16f8a7bf9b5d5fe45a564803ec1dbaf7.jpg",
"secondaryIcon": "https://bungie.net/common/destiny2_content/icons/db147af2f8220f792c1cfb249115b7c5.jpg",
"owned": true,
"state": 0
},
{
"id": "1935440659",
"code": "JGN-PX4-DFN",
"info": "Discovered as part of the Aion Archives ARG in late April 2025.",
"collectibleHash": 2040168509,
"name": "Secret Signal",
"icon": "https://bungie.net/common/destiny2_content/icons/01717fdf550c6dc498bf41ede84c190d.jpg",
"secondaryIcon": "https://bungie.net/common/destiny2_content/icons/e2b43875a5f769e79a59fb0aa111cda8.jpg",
"owned": true,
"state": 0
},
{...}
],
"emote": [
{
"id": "1063785104",
"code": "TK7-D3P-FDF",
"info": "Released during Pride Month",
"collectibleHash": null,
"name": "Rainbow Connection",
"icon": "https://bungie.net/common/destiny2_content/icons/6b11266fcdb8e1e8bb8965724e1bfe20.jpg",
"secondaryIcon": null,
"owned": null,
"state": null
}
],
"transmat": [
{
"id": "3549689934",
"code": "R9J-79M-J6C",
"info": "Released during Pride Month",
"collectibleHash": 1009936720,
"name": "End of the Rainbow",
"icon": "https://bungie.net/common/destiny2_content/icons/ac741348c625bc6a6efe1bcebda3c48d.jpg",
"secondaryIcon": null,
"owned": true,
"state": 64
}
],
"shader": [
{
"id": "4182403848",
"code": "D6T-3JR-CKX",
"info": "Released during Pride Month",
"collectibleHash": 1656083080,
"name": "Prismatic Expanse",
"icon": "https://bungie.net/common/destiny2_content/icons/ef40ec9f65218df89d1de81112a80820.jpg",
"secondaryIcon": null,
"owned": true,
"state": 64
}
],
"AccessLevel": "premium"
}
Hunt: Showdown
Endpoint query fluide - Permet de rechercher des armes avec différents filtres combinables :
- name: Recherche par nom (ex: "Nagant M1895")
- category: Catégorie d'arme (ex: "Small", "Large")
- id: Recherche par id (ex: "nagant_m1895")
- cost: Prix (ex: "24", "142")
- can_be_dual: Peut etre en 'Akimbo' (ex: "true" ou "false")
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/hunt/weapons?id=nagant_m1895&cost=24
Réponse :
{
"ErrorStatus": "Success",
"Message": "Ok + Parsing with query",
"ErrorCode": 1,
"Response": [
{
"id": "nagant_m1895",
"name": "Nagant M1895",
"description": "Modern, Imperial Russian, single-action revolver. Slow to reload. Sacrifices stopping power for an extra bullet in the drum and a higher rate of fire. Can be used for dual wielding.",
"category": "Small",
"cost": 24,
"can_be_dual": true,
"unlock": {
"rank": null,
"condition": null
},
"ammo": [
3
],
"special_ammo": [
5,
6
],
"melee_damage_type": {
"melee": {
"info": "Melee, Basic Melee Attack, Low Damage, Low Stamina Consumption, Fast Strike Frequency",
"damage_type": 0,
"icon": "stats/melee.png"
},
"heavy_melee": {
"info": "Heavy Melee, Strong Melee Attack, Low Damage, High Stamina Consumption, Slow Strike Frequency",
"damage_type": 0,
"icon": "stats/heavy_melee.png"
}
},
"stats": [
{
"name": "Capacity",
"value": "7/21",
"info": "Bullets capacity in the gun.",
"icon": "stats/capacity.png"
},
{
"name": "Damage",
"value": 91,
"info": "Damage value of a shot that hits a Hunter in the upper-torso at 10 meters. For Shotguns: Average damage at 10 meters at center mass.",
"icon": "stats/damage.png"
},
{
"name": "Effective Range",
"value": 74,
"info": "The range (meters) that will kill a Hunter in one hit - usually a heashot.",
"icon": "stats/effective_range.png"
},
{
"name": "Rate of Fire",
"value": 21,
"info": "Shots fired per minute, including time to reload.",
"icon": "stats/rate_of_fire.png"
},
{
"name": "Cycle Time",
"value": 1.5,
"info": "The time (seconds) this needs to ready for the next shot, including time to reload if necessary. For Dual Wield: The time it takes for the weapon that shot first to ready again.",
"icon": "stats/cycle_time.png"
},
{
"name": "Spread",
"value": 40,
"info": "The relative crosshair spread of this while aiming form the hip. Shotguns have a comparatively wider spread.",
"icon": "stats/spread.png"
},
{
"name": "Sway",
"value": 128,
"info": "The relative amount of weapon sway while ADS.",
"icon": "stats/sway.png"
},
{
"name": "Vertical Recoil",
"value": 4,
"info": "The strength of the vertical recoil (degrees) after a shot.",
"icon": "stats/vertical_recoil.png"
},
{
"name": "Reload Speed",
"value": 12.5,
"info": "The time (in seconds) it takes to fully reload the weapon when empty, including any special behavior such as clip reloading.",
"icon": "stats/reload_speed.png"
},
{
"name": "Muzzle Velocity",
"value": 330,
"info": "The velocity (meters per second) at which the projectile will travel. Heavier projectiles (such as crossbow bolts) travel in a ballistic arc.",
"icon": "stats/muzzle_velocity.png"
},
{
"name": "Melee Damage",
"value": 13,
"info": "True damage value of a regular melee attack tha hits a Hunter in the Upper-Torso.",
"icon": "stats/melee_damage.png"
},
{
"name": "Heavy Melee Damage",
"value": 31,
"info": "True damage value of a charged heavy melee attack tha hits a Hunter in the Upper-Torso.",
"icon": "stats/heavy_melee_damage.png"
},
{
"name": "Stamina Consumption",
"value": 20,
"info": "The stamina consumed with a heavy melee attack.",
"icon": "stats/stamina_consumption.png"
}
],
"image": "weapons/large/nagant_m1895.png",
"legendary_skin": [
60
]
},
{... other weapons ...}
],
"AccessLevel": "basic"
}
Dead by Daylight
Endpoint query fluide - Permet de rechercher des armes avec différents filtres combinables :
- name: Recherche par nom (ex: "Nagant M1895")
- category: Catégorie d'arme (ex: "Small", "Large")
- id: Recherche par id (ex: "nagant_m1895")
- cost: Prix (ex: "24", "142")
- can_be_dual: Peut etre en 'Akimbo' (ex: "true" ou "false")
curl -H "X-API-Key: VOTRE_CLE" https://api.the-coven.fr/hunt/weapons?id=nagant_m1895&cost=24
Réponse :
{
}