Tarkov Market API
Prix du marché, prix marchands et données des objets d'Escape from Tarkov. URL de base : https://api.tarkov-market.app/api/v1
Clients officiels sans dépendances : Node.js, Python et Go — github.com/ggdiam/tarkov-market-api
Clé API
Pour utiliser l'API, il vous faut le statut Pro sur le site. Les exemples ci-dessous utilisent la valeur fictive your_api_key.
Authentification
Transmettez votre clé dans un en-tête :
x-api-key: your_api_key
Ou comme paramètre de requête si les en-têtes ne conviennent pas (navigateur, bots de streaming, tableurs) :
?x-api-key=your_api_key
Clé absente, inconnue ou désactivée → 401 { "error": "Access denied" }
Modes de jeu
Chaque point d'accès aux objets existe pour trois modes de jeu. Choisissez le mode avec un préfixe de chemin ou le paramètre mode : les deux donnent la même réponse.
Mode
Préfixe de chemin
Paramètre
Source des prix
PVP
/api/v1/…
par défaut
collection items
PVE
/api/v1/pve/…
mode=pve
scan PVE
Season
/api/v1/season/…
mode=season
scan saisonnier
Personnages saisonniers
L'économie saisonnière est scannée séparément et son historique est récent. Un objet n'a un prix que lorsque le scanner l'a vu sur le marché saisonnier ; avg24hPrice / diff24h se remplissent à mesure que l'historique s'accumule. Les champs indépendants du marché, basePrice et le prix marchand, reprennent les valeurs PVP en attendant un export propre à la saison.
Exemple sans prix saisonnier (même objet, même requête, mode saisonnier) :
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // Aucun prix saisonnier pour le moment
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // Jamais observé sur le marché saisonnier
"haveMarketData": false, // Ne pas utiliser le prix de cet objet
"basePrice": 970000, // Hors données du marché : identique au PVP
"traderName": "Therapist",
"traderPrice": 494700
}Points d'accès
GET/item?q=ledx
Chercher un objet par nom, uid ou bsgId.
qNom complet ou court dans une langue prise en charge. Jusqu'à 5 résultats, correspondance exacte en premier
uiduid Tarkov Market : renvoie exactement un objet
bsgIdIdentifiant des fichiers du jeu : renvoie exactement un objet
langLangue des noms et du lien vers le site. Valeurs : en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Par défaut : en
URL
https://api.tarkov-market.app/api/v1/item?q=ledx&x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/item?q=ledx"
Exemple de réponse
[
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"bannedOnFlea": false,
"haveMarketData": true,
"tags": ["Barter"],
"shortName": "LEDX",
"price": 550000,
"basePrice": 970000,
"avg24hPrice": 598993,
"avg7daysPrice": 671670,
"traderName": "Therapist",
"traderPrice": 494700,
"traderPriceCur": "₽",
"traderPriceRub": 494700,
"updated": "2026-08-05T17:34:28.319Z",
"slots": 1,
"diff24h": -8.18,
"diff7days": -18.11,
"icon": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
"link": "https://tarkov-market.com/item/ledx_skin_transilluminator",
"wikiLink": "https://escapefromtarkov.fandom.com/wiki/LEDX_Skin_Transilluminator",
"img": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
"imgBig": "https://cdn.tarkov-market.app/images/items/ledx_skin_transilluminator_lg.png",
"bsgId": "5c0530ee86f774697952d952",
"isFunctional": true,
"reference": "https://www.patreon.com/tarkov_market"
}
]POST/item
Même recherche avec un corps JSON : utile pour les textes non latins afin d'éviter l'encodage d'URL.
q / uid / bsgIdIdentiques à GET, transmis dans le corps JSON
langIdentique à GET
curl
curl https://api.tarkov-market.app/api/v1/item \
-H "x-api-key: your_api_key" \
-H "Content-Type: application/json" \
-X POST --data '{"q":"AI-2急救组合","lang":"ch"}'Exemple de réponse
[
{
"uid": "2335b619-c562-41da-962f-e7b5aba5d45c",
"name": "AI-2急救组合",
"shortName": "AI-2",
"tags": ["Meds"],
"price": 6900,
"basePrice": 4160,
"avg24hPrice": 6695,
"avg7daysPrice": 5912,
"traderName": "Therapist",
"traderPrice": 2121,
"traderPriceCur": "₽",
"traderPriceRub": 2121,
"diff24h": 3.06,
"diff7days": 16.71,
"updated": "2026-08-05T17:07:42.165Z",
"link": "https://tarkov-market.com/ch/item/ai-2_medikit",
"bsgId": "5755356824597772cb798962",
"isFunctional": true
}
]GET/items/all5 req/min
Tous les objets dans un tableau. Données mises en cache pendant 5 minutes ; interroger plus souvent n'apporte rien.
tagsConserver uniquement ces catégories, séparées par des virgules : tags=Ammo,Magazines
sortTrier par un champ de réponse, par exemple sort=price
sort_directionasc (par défaut) ou desc
langLangue des noms et des liens vers le site
URL
https://api.tarkov-market.app/api/v1/items/all?x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/items/all"
Exemple de réponse
[
{
"uid": "f0fa8457-6638-4ad2-b7e8-4708033d8f39",
"name": "Secure Flash drive",
"shortName": "Flash drive",
"price": 37400,
...
},
{
"uid": "33c15349-44e6-4553-9705-1b6417a1ad6a",
"name": "SSD drive",
...
},
...
]GET/items/all/download5 req/min
La même liste complète dans un fichier JSON téléchargeable.
langLangue des noms et des liens vers le site
URL
https://api.tarkov-market.app/api/v1/items/all/download?x-api-key=your_api_key
curl
curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/items/all/download"
Champs de réponse
Champ
Signification
uid
Identifiant stable Tarkov Market ; utilisez-le comme clé de votre côté
bsgId
Identifiant des fichiers du jeu
name / shortName
Nom dans la langue demandée
tags
Catégories de l'objet, identiques aux filtres du site
price
Dernier prix connu au marché, en ₽. 0 signifie aucun prix pour ce mode
avg24hPrice / avg7daysPrice
Prix moyen au marché sur 24 heures / 7 jours, en ₽
diff24h / diff7days
Écart du dernier prix par rapport à ces moyennes, en %
basePrice
Prix de base du catalogue, en ₽, utilisé pour calculer le rachat marchand
traderName
Marchand offrant le meilleur prix de rachat
traderPrice / traderPriceCur
Prix payé par ce marchand, dans sa devise (₽, $ ou €)
traderPriceRub
Même prix marchand converti en ₽ au taux du jeu
bannedOnFlea
L'objet ne peut pas être vendu au marché
haveMarketData
Objet échangeable au marché avec un prix récent ; false signifie que le prix n'est pas fiable
isFunctional
false pour les objets retirés du jeu ou impossibles à obtenir
updated
Dernière observation du prix par le scanner. Vide signifie jamais observé
slots
Taille de l'objet en cases d'inventaire
img / imgBig
Icône et grande image sur mon CDN
icon
Ancien alias de img : même URL
link / wikiLink
Fiche de l'objet sur tarkov-market.com et sur le wiki
Limites et erreurs
Règle
Détails
300 req/min
Par clé, tous points d'accès confondus. Contactez-moi si votre projet a besoin de plus.
5 req/min
Liste complète et téléchargement, pour tous les modes. Les prix sont de toute façon mis en cache pendant 5 minutes.
401
Clé absente, inconnue ou désactivée.
429
Limite de requêtes atteinte ; le corps indique laquelle.
Conditions
L'API est destinée à un usage personnel.
Pour un projet public, veuillez citer tarkov-market.com avec un lien comme fournisseur des données.
Si votre projet public reproduit la majorité des fonctions de Tarkov Market, votre accès peut être interrompu sans préavis ni compensation.
Si vous revendez l'API, votre accès sera interrompu sans préavis ni compensation.