Tarkov Market API
Ceny na blšom trhu, ceny obchodníkov a údaje predmetov pre Escape from Tarkov. Základná URL: https://api.tarkov-market.app/api/v1
Oficiálni klienti bez závislostí: Node.js, Python a Go – github.com/ggdiam/tarkov-market-api
Kľúč API
Na používanie API potrebuješ status Pro na webe. Príklady nižšie používajú zástupnú hodnotu your_api_key.
Autentifikácia
Kľúč odovzdaj v hlavičke:
x-api-key: your_api_key
Alebo ako parameter požiadavky, ak sú hlavičky nepraktické (prehliadač, streamovacie boty, tabuľky):
?x-api-key=your_api_key
Chýbajúci, neznámy alebo vypnutý kľúč → 401 { "error": "Access denied" }
Herné režimy
Každý koncový bod predmetov existuje v troch herných režimoch. Režim možno nastaviť prefixom cesty alebo parametrom mode – obe možnosti vrátia rovnakú odpoveď:
Režim
Prefix cesty
Parameter
Zdroj cien
PVP
/api/v1/…
predvolený
kolekcia predmetov
PVE
/api/v1/pve/…
mode=pve
sken PVE
Season
/api/v1/season/…
mode=season
sezónny sken
Sezónne postavy
Sezónna ekonomika sa skenuje samostatne a je mladá: predmet má cenu na trhu až po tom, čo ho skener uvidí na sezónnom trhu, a avg24hPrice / diff24h sa dopĺňajú s históriou sezónnych cien. Polia nezávislé od trhu – basePrice a cena obchodníka – používajú hodnoty PVP, kým sezóna nedostane vlastný výpis herných dát.
Chýbajúca sezónna cena vyzerá takto (rovnaký predmet, rovnaká požiadavka, sezónny režim):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // zatiaľ bez sezónnej ceny na trhu
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // na sezónnom trhu ešte nezaznamenané
"haveMarketData": false, // pri tomto predmete nepoužívaj cenu
"basePrice": 970000, // nejde o údaje trhu – rovnaké ako PVP
"traderName": "Therapist",
"traderPrice": 494700
}Koncové body
GET/item?q=ledx
Nájdi predmet podľa názvu, uid alebo bsgId.
qNázov alebo skrátený názov predmetu v ľubovoľnej podporovanej lokalizácii. Vráti najviac 5 zhôd, presnú zhodu ako prvú
uiduid predmetu Tarkov Market – vráti presne jeden predmet
bsgIdID predmetu z herných súborov – vráti presne jeden predmet
langJazyk názvov a odkazu na web. Jeden z: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Predvolene 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"
Príklad odpovede
[
{
"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
Rovnaké vyhľadávanie, ale s telom JSON – vhodné pre požiadavky mimo latinky, aby nebolo nutné kódovanie URL.
q / uid / bsgIdRovnaké ako v GET, odovzdané v tele JSON
langRovnaké ako v 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"}'Príklad odpovede
[
{
"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 pož./min
Všetky predmety v jednom poli. Údaje sa ukladajú do vyrovnávacej pamäte na 5 minút, častejšie požiadavky preto nič neprinesú.
tagsPonechať iba predmety s týmito štítkami oddelenými čiarkou: tags=Ammo,Magazines
sortZoradiť podľa poľa odpovede, napríklad sort=price
sort_directionasc (predvolené) alebo desc
langJazyk názvov a odkazov na web
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"
Príklad odpovede
[
{
"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 pož./min
Rovnaký úplný zoznam ako súbor JSON na stiahnutie.
langJazyk názvov a odkazov na web
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"
Polia odpovede
Pole
Význam
uid
ID predmetu Tarkov Market – stabilné, na svojej strane ho používaj ako kľúč
bsgId
ID predmetu z herných súborov
name / shortName
Názov predmetu v požadovanom jazyku
tags
Kategórie predmetu, rovnaké ako filtre webu
price
Posledná známa cena na trhu, ₽. 0 znamená, že pre tento režim cena chýba
avg24hPrice / avg7daysPrice
Priemerná cena na trhu za posledných 24 hodín / 7 dní, ₽
diff24h / diff7days
Zmena poslednej ceny oproti týmto priemerom, %
basePrice
Základná cena predmetu z príručky, ₽ – z nej sa počíta výkup u obchodníka
traderName
Obchodník, ktorý za predmet platí najviac
traderPrice / traderPriceCur
Koľko tento obchodník platí vo svojej mene (₽, $ alebo €)
traderPriceRub
Rovnaká cena obchodníka prepočítaná na ₽ herným kurzom
bannedOnFlea
Predmet nemožno predať na blšom trhu
haveMarketData
Predmet je obchodovateľný na trhu a cena je čerstvá – false znamená, že cene nemožno dôverovať
isFunctional
false pri predmetoch odstránených z hry alebo nedostupných
updated
Kedy skener naposledy zaznamenal cenu na trhu. Prázdne znamená nikdy
slots
Veľkosť predmetu v inventári v políčkach
img / imgBig
Ikona a veľký obrázok predmetu na mojom CDN
icon
Starší alias poľa img – rovnaká URL
link / wikiLink
Stránka predmetu na tarkov-market.com a wiki
Limity a chyby
Pravidlo
Podrobnosti
300 pož./min
Na jeden kľúč naprieč všetkými koncovými bodmi. Ak projekt potrebuje viac, ozvi sa.
5 pož./min
Úplný zoznam predmetov a jeho stiahnutie vo všetkých režimoch. Ceny sú aj tak uložené vo vyrovnávacej pamäti na 5 minút.
401
Kľúč chýba, je neznámy alebo vypnutý.
429
Dosiahnutý limit požiadaviek – telo odpovede uvádza, ktorý limit.
Podmienky
API je určené na osobné použitie.
Pri použití vo verejnom projekte uveď odkaz na tarkov-market.com ako poskytovateľa údajov.
Ak verejný projekt kopíruje väčšinu funkcií tarkov-market, prístup môže byť ukončený bez upozornenia a náhrady.
Pri ďalšom predaji API bude prístup ukončený bez upozornenia a náhrady.