Tarkov Pilot
⬤
Tarkov Pilot v2 released — old versions don't work anymore, please download the new one. Easier setup, auto-update, all settings in the app window.
Tarkov Market18+
Sledování cen, interaktivní mapy a nástroje pro postup
Sezóny
Jaeger20:39
Mapy
Postup
Kalkulačky
Zbraně/munice
Více
Cz
Režim
PVP
Přihlásit
Cz
Režim
PVP
 

Tarkov Market API

Ceny blešího trhu, ceny obchodníků a data předmětů pro Escape from Tarkov. Základní URL: https://api.tarkov-market.app/api/v1

Oficiální klienti bez závislostí: Node.js, Python a Go – github.com/ggdiam/tarkov-market-api

Příklady pro

Klíč API

Pro použití API potřebuješ status Pro na webu. Příklady níže používají zástupnou hodnotu your_api_key.

Ověření

Předej klíč v hlavičce:

x-api-key: your_api_key

Nebo jako parametr dotazu, pokud hlavičky nejsou vhodné (prohlížeč, streamovací boti, tabulky):

?x-api-key=your_api_key

Chybějící, neznámý nebo vypnutý klíč → 401 { "error": "Access denied" }

Herní režimy

Každý endpoint předmětů existuje ve třech herních režimech. Režim lze nastavit předponou cesty nebo parametrem mode – obě možnosti dávají stejnou odpověď:

Režim
Předpona cesty
Parametr
Zdroj cen
PVP
/api/v1/…
výchozí
kolekce předmětů
PVE
/api/v1/pve/…
mode=pve
skenování PVE
Season
/api/v1/season/…
mode=season
sezónní skenování

Sezónní postavy

Sezónní ekonomika se skenuje samostatně a je nová: předmět získá tržní cenu až po zachycení skenerem na sezónním trhu a avg24hPrice / diff24h se plní s přibývající historií cen. Pole nezávislá na trhu – basePrice a cena obchodníka – používají hodnoty PVP, dokud sezóna nezíská vlastní výpis herních dat.

Chybějící sezónní cena vypadá takto (stejný předmět, stejný požadavek, sezónní režim):

{
    "uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
    "name": "LEDX Skin Transilluminator",
    "price": 0,               // zatím bez sezónní tržní ceny
    "avg24hPrice": 0,
    "diff24h": 0,
    "updated": "",            // nikdy nezachyceno na sezónním trhu
    "haveMarketData": false,  // nepoužívej cenu tohoto předmětu
    "basePrice": 970000,      // nejde o data trhu – stejné jako PVP
    "traderName": "Therapist",
    "traderPrice": 494700
}

Endpointy

GET/item?q=ledx
Najdi předmět podle názvu, uid nebo bsgId.
qNázev nebo krátký název předmětu v libovolném podporovaném jazyce. Vrátí až 5 shod, přesnou jako první
uiduid předmětu Tarkov Market – vrátí právě jeden předmět
bsgIdID předmětu z herních souborů – vrátí právě jeden předmět
langJazyk názvů a odkazu na web. Jedna z hodnot: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Výchozí 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"
Příklad odpovědi
[
    {
        "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
Stejné hledání, ale s tělem JSON – použij pro dotazy mimo latinku, abys nemusel kódovat URL.
q / uid / bsgIdStejné jako v GET, předáno v těle JSON
langStejné jako 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"}'
Příklad odpovědi
[
    {
        "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šechny předměty v jednom poli. Data jsou v mezipaměti 5 minut, častější dotazy nic nepřinesou.
tagsPonechat jen předměty s těmito štítky oddělenými čárkou: tags=Ammo,Magazines
sortŘadit podle pole odpovědi, například sort=price
sort_directionasc (výchozí) nebo desc
langJazyk názvů a odkazů 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"
Příklad odpovědi
[
    {
        "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
Stejný úplný seznam jako soubor JSON ke stažení.
langJazyk názvů a odkazů 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"

Pole odpovědi

Pole
Význam
uid
ID předmětu Tarkov Market – stabilní, použij ho jako klíč na své straně
bsgId
ID předmětu z herních souborů
name / shortName
Název předmětu v požadovaném jazyce
tags
Kategorie předmětu, stejné jako ve filtrech webu
price
Poslední známá cena trhu, ₽. 0 znamená, že v tomto režimu není cena
avg24hPrice / avg7daysPrice
Průměrná cena trhu za posledních 24 hodin / 7 dní, ₽
diff24h / diff7days
Změna poslední ceny oproti těmto průměrům, %
basePrice
Základní cena předmětu (příručka), ₽ – základ výpočtu výkupní ceny obchodníka
traderName
Obchodník, který za předmět platí nejvíce
traderPrice / traderPriceCur
Kolik tento obchodník platí ve své měně (₽, $ nebo €)
traderPriceRub
Stejná cena obchodníka přepočtená na ₽ herním kurzem
bannedOnFlea
Předmět nelze prodat na bleším trhu
haveMarketData
Předmět je obchodovatelný na trhu a cena je čerstvá – false znamená ceně nevěřit
isFunctional
false u předmětů odstraněných ze hry nebo nedostupných
updated
Kdy skener naposledy viděl tržní cenu. Prázdná hodnota znamená nikdy
slots
Velikost předmětu v inventáři v políčkách
img / imgBig
Ikona a velký obrázek předmětu na mém CDN
icon
Starší alias img – stejné URL
link / wikiLink
Stránka předmětu na tarkov-market.com a na wiki

Limity a chyby

Pravidlo
Podrobnosti
300 pož./min
Na klíč, souhrnně pro všechny endpointy. Pokud tvůj projekt potřebuje víc, napiš mi.
5 pož./min
Úplný seznam předmětů a jeho stažení v každém režimu. Ceny jsou stejně v mezipaměti 5 minut.
401
Klíč chybí, je neznámý nebo vypnutý.
429
Dosažen limit požadavků – tělo uvádí, který limit.

Podmínky

API je určeno pro osobní použití.

Pokud ho používáš ve veřejném projektu, uveď prosím odkaz na tarkov-market.com jako zdroj dat.

Pokud tvůj veřejný projekt kopíruje většinu funkcí tarkov-market, přístup může být ukončen bez upozornění a náhrady.

Pokud API přeprodáváš, přístup bude ukončen bez upozornění a náhrady.