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.

Sledování cen, interaktivní mapy a nástroje pro postup

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í

Klíč API umožňuje aplikacím také číst a měnit postup vašich postav. Sdílejte ho jen s důvěryhodnými aplikacemi. Je nutné PRO; nový klíč API zneplatní starý. Postup přijímá x-api-key pouze v hlavičce.

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

Postup postavy

Základní URL API postupu: https://api.tarkov-market.app/api/v1

Získejte charUid z /characters. Postava určuje PVP, PVE nebo SEASON; volba nahoře platí pro ceny. itemId a questId jsou BSG ID včetně aliasů a odkazů cílů. upgradeKey označuje úroveň úkrytu, např. Workbench_2.

GET vrací revision a ETag. Nahraďte zástupné hodnoty postavou, BSG ID a revision; v každém PATCH pošlete If-Match: "{revision}". Zápis nastavuje absolutní hodnoty. Po 409 přečtěte aktuální postup a slaďte změnu. Opakování již nastavené hodnoty uspěje bez dalšího zápisu.

Postup: 300 požadavků/minutu na klíč a vlastníka; 60 pokusů PATCH/minutu na vlastníka. Limity oddělené od cen. 429 obsahuje Retry-After: 60. Soukromé stavy se necachují.

GET/characters

Seznam postav vlastníka klíče API.

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters"

Příklad odpovědi

{
    "characters": [
        {
            "charUid": "{charUid}",
            "name": "Main",
            "gameMode": "PVP"
        }
    ]
}

GET/characters/{charUid}/tracked-items

Názvy a ikony s requiredQuantity (zbývající povinné požadavky), spentQuantity (již započítané), availableQuantity (zásoba), remainingQuantity = max(0, requiredQuantity − availableQuantity) a sources. Počáteční předměty a odevzdané kroky snižují potřeby. Volitelné cíle jsou vynechány; firInventorySeparate:false značí, že není samostatná zásoba FiR. PATCH nastavuje availableQuantity; vlastní cíle nelze přidat ani smazat. Ceny: /api/v1/item?bsgId={itemId}&mode={mode}, /api/v1/items/all?mode={mode}. Použijte režim postavy (pvp/pve/season); cenu za slot vypočítejte jako price / slots.

langJazyk názvů a odkazu na web. Jedna z hodnot: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Výchozí en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items"

Příklad odpovědi

{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "firInventorySeparate": false,
    "items": [
        {
            "itemId": "5c0530ee86f774697952d952",
            "name": "LEDX Skin Transilluminator",
            "shortName": "LEDX",
            "slots": 1,
            "icon": "https://cdn.tarkov-market.app/images/items/a7f7568c-61fb-437e-9f71-06e58aae26ba_sm.png",
            "requiredQuantity": 10,
            "spentQuantity": 0,
            "availableQuantity": 5,
            "remainingQuantity": 5,
            "sources": [
                {
                    "type": "quest",
                    "questId": "{BSG quest ID}",
                    "amount": 10,
                    "remainingRequiredQuantity": 10,
                    "fir": true,
                    "completed": false,
                    "canceled": false
                }
            ]
        }
    ]
}

PATCH/characters/{charUid}/tracked-items/{itemId}

Nastavte absolutní hodnotu JSON a pošlete revision z GET v If-Match.

availableQuantityJediné povolené pole JSON, povinné: celé číslo od 0 do 1 000 000 000. Nastaví absolutní dostupnou zásobu, místo změny o tuto hodnotu; 0 zásobu vynuluje. Ostatní pole jsou jen pro čtení. Chybějící, neplatná nebo další pole: 400 invalid_quantity.

curl

curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/tracked-items/{itemId}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"availableQuantity":4}'

Příklad odpovědi

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

GET/characters/{charUid}/quests

Úkoly vhodné pro postavu. status se počítá: completed, failed, unreachable, available nebo locked; neznamená přijetí ve hře. PATCH completed:true nebo false. Reset zachová zaškrtnuté kroky a dokončení spojených úkolů.

langJazyk názvů a odkazu na web. Jedna z hodnot: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Výchozí en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests"

Příklad odpovědi

{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "quests": [
        {
            "questId": "{BSG quest ID}",
            "questIdAliases": [],
            "name": "Quest name",
            "trader": "Therapist",
            "completed": false,
            "status": "available"
        }
    ]
}

PATCH/characters/{charUid}/quests/{questId}

Nastavte absolutní hodnotu JSON a pošlete revision z GET v If-Match.

completedJediné povolené pole JSON, povinné: logická hodnota. true dokončí úkol; false resetuje dokončení se zachováním označených kroků a dokončených propojených úkolů. status, kroky ani jiná pole zde nelze měnit. Chybějící, neplatná nebo další pole: 400 invalid_completed.

curl

curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/quests/{questId}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"completed":true}'

Příklad odpovědi

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

GET/characters/{charUid}/hideout

Každá úroveň úkrytu: upgradeKey, moduleId (BSG ID nebo null), completed, prebuilt a canComplete. PATCH completed:true nebo false. Nejprve dokončete předpoklady; nejprve resetujte závislé stavby. Počáteční stavby edice resetovat nelze. canComplete kontroluje závislosti modulů, ne peníze ani dovednosti ve hře.

langJazyk názvů a odkazu na web. Jedna z hodnot: en, ru, kr, it, es, de, jp, ch, tr, fr, pl, po, cz, sk, hu, ro, mx. Výchozí en

curl

curl -H "x-api-key: your_api_key" "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout"

Příklad odpovědi

{
    "charUid": "{charUid}",
    "gameMode": "PVP",
    "revision": "{revision}",
    "modules": [
        {
            "upgradeKey": "Workbench_2",
            "moduleId": "{BSG module ID}",
            "name": "Workbench",
            "level": 2,
            "completed": false,
            "prebuilt": false,
            "canComplete": true
        }
    ]
}

PATCH/characters/{charUid}/hideout/{upgradeKey}

Nastavte absolutní hodnotu JSON a pošlete revision z GET v If-Match.

completedJediné povolené pole JSON, povinné: logická hodnota. true označí toto vylepšení jako postavené; false stavbu resetuje. Ostatní pole jsou jen pro čtení. Chybějící, neplatná nebo další pole: 400 invalid_completed; omezení závislostí nebo počátečních staveb: 409.

curl

curl "https://api.tarkov-market.app/api/v1/characters/{charUid}/hideout/{upgradeKey}" \
  -H "x-api-key: your_api_key" \
  -H 'If-Match: "{revision}"' \
  -H "Content-Type: application/json" \
  -X PATCH --data '{"completed":true}'

Příklad odpovědi

{
    "ok": true,
    "changed": true,
    "revision": "{newRevision}",
    "notificationDelivered": true
}

Chyby: 400 neplatná data; 401 chybějící, vypnutý, odvolaný klíč, klíč bez vlastníka nebo zablokovaný vlastník; 403 nutné PRO/sezóna vypnuta; 404 nedostupná postava/neznámý objekt; 409 konflikt, nejednoznačné BSG ID nebo omezení stavby; 413 velké tělo; 428 chybí If-Match; 429 limit; 503 služba nedostupná. Tělo: {"error":"code"}.

notificationDelivered:false znamená uložený zápis bez potvrzení oznámení webu. Obnovte postup; zápis neselhal.

Limity a chyby

Pravidlo

Podrobnosti

300 pož./min

Na klíč, pro všechny cenové endpointy. Postup má oddělené limity požadavků a zápisů.

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.