Tarkov Market API
Prețurile pieței, prețurile negustorilor și datele obiectelor pentru Escape from Tarkov. URL de bază: https://api.tarkov-market.app/api/v1
Clienți oficiali, fără dependențe: Node.js, Python și Go — github.com/ggdiam/tarkov-market-api
Cheie API
Pentru a folosi API-ul ai nevoie de Statut Pro pe site. Exemplele de mai jos folosesc substituentul your_api_key.
Autentificare
Trimite cheia într-un antet:
x-api-key: your_api_key
Sau ca parametru de interogare, dacă antetele sunt incomode (browser, boți de streaming, foi de calcul):
?x-api-key=your_api_key
Cheie lipsă, necunoscută sau dezactivată → 401 { "error": "Access denied" }
Moduri de joc
Fiecare endpoint de obiecte există în trei moduri. Modul poate fi setat printr-un prefix de cale sau prin mode parametru — ambele dau același răspuns:
Mod
Prefix de cale
Parametru
Prețuri din
PVP
/api/v1/…
implicit
colecția de obiecte
PVE
/api/v1/pve/…
mode=pve
scanare PVE
Season
/api/v1/season/…
mode=season
scanare sezonieră
Personaje sezoniere
Economia sezonieră este scanată separat și este recentă: un obiect are preț doar după ce scanerul îl vede pe piața sezonieră, iar avg24hPrice / diff24h se completează pe măsură ce se acumulează istoric. Câmpurile independente de piață — basePrice și prețul negustorului — folosesc valorile PVP până când sezonul primește propriile date de joc.
Lipsa prețului sezonier arată astfel (același obiect și aceeași cerere, în mod sezonier):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // încă nu există preț sezonier pe piață
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // nevăzut încă pe piața sezonieră
"haveMarketData": false, // nu folosi prețul acestui obiect
"basePrice": 970000, // nu sunt date de piață — identic cu PVP
"traderName": "Therapist",
"traderPrice": 494700
}Endpointuri
GET/item?q=ledx
Găsește un obiect după nume, uid sau bsgId.
qNumele sau numele scurt al obiectului în orice limbă acceptată. Returnează până la 5 rezultate, potrivirea exactă prima
uidUID-ul obiectului Tarkov Market — returnează exact un obiect
bsgIdID-ul obiectului din fișierele jocului — returnează exact un obiect
langLimba numelor și a linkului site-ului. Una dintre: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Implicit 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"
Exemplu de răspuns
[
{
"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
Aceeași căutare cu corp JSON — folosește-o pentru interogări nelatine, fără codificare URL.
q / uid / bsgIdLa fel ca în GET, transmis în corpul JSON
langLa fel ca în 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"}'Exemplu de răspuns
[
{
"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 cereri/min
Toate obiectele într-un singur tablou. Datele sunt în cache 5 minute, deci interogarea mai frecventă nu aduce nimic.
tagsPăstrează doar obiectele cu aceste etichete, separate prin virgulă: tags=Ammo,Magazines
sortSortează după un câmp al răspunsului, de exemplu sort=price
sort_directionasc (implicit) sau desc
langLimba numelor și a linkurilor site-ului
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"
Exemplu de răspuns
[
{
"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 cereri/min
Aceeași listă completă ca fișier JSON descărcabil.
langLimba numelor și a linkurilor site-ului
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"
Câmpurile răspunsului
Câmp
Semnificație
uid
ID-ul obiectului Tarkov Market — stabil, folosește-l drept cheie în sistemul tău
bsgId
ID-ul obiectului din fișierele jocului
name / shortName
Numele obiectului în limba cerută
tags
Categoriile obiectului, aceleași folosite de filtrele site-ului
price
Ultimul preț cunoscut pe piață, ₽. 0 înseamnă că nu există preț pentru acest mod
avg24hPrice / avg7daysPrice
Prețul mediu pe piață în ultimele 24 de ore / 7 zile, ₽
diff24h / diff7days
Variația ultimului preț față de aceste medii, %
basePrice
Prețul de bază al obiectului (catalog), ₽ — baza calculului prețului de cumpărare al negustorului
traderName
Negustorul care plătește cel mai mult pentru obiect
traderPrice / traderPriceCur
Cât plătește acel negustor în valuta sa (₽, $ sau €)
traderPriceRub
Același preț al negustorului convertit în ₽ la cursul jocului
bannedOnFlea
Obiectul nu poate fi vândut pe piață
haveMarketData
Obiectul poate fi tranzacționat pe piață și prețul este recent — false înseamnă să nu te bazezi pe preț
isFunctional
false pentru obiecte eliminate din joc sau imposibil de obținut
updated
Când a văzut scanerul ultima dată prețul pieței. Gol înseamnă niciodată
slots
Dimensiunea obiectului în celulele inventarului
img / imgBig
Pictograma și imaginea mare a obiectului pe CDN-ul meu
icon
Alias vechi pentru img — același URL
link / wikiLink
Pagina obiectului pe tarkov-market.com și pe wiki
Limite și erori
Regulă
Detalii
300 cereri/min
Pe cheie, pentru toate endpointurile. Întreabă dacă proiectul tău are nevoie de mai mult.
5 cereri/min
Lista completă și descărcarea ei, în toate modurile. Prețurile sunt oricum în cache 5 minute.
401
Cheie lipsă, necunoscută sau dezactivată.
429
Limita de cereri atinsă — corpul răspunsului indică ce limită.
Condiții
API-ul este destinat utilizării personale.
Dacă îl folosești într-un proiect public, indică tarkov-market.com ca furnizor de date.
Dacă proiectul tău public copiază majoritatea funcțiilor tarkov-market, accesul poate fi întrerupt fără avertisment și despăgubire.
Dacă revinzi API-ul, accesul va fi întrerupt fără avertisment și despăgubire.