Tarkov Market API
Ceny pchlego targu, ceny handlarzy i dane przedmiotów Escape from Tarkov. Bazowy URL: https://api.tarkov-market.app/api/v1
Oficjalne klienty bez zależności: Node.js, Python i Go — github.com/ggdiam/tarkov-market-api
Klucz API
Aby korzystać z API, potrzebujesz statusu PRO na stronie. Poniższe przykłady używają wartości zastępczej your_api_key.
Uwierzytelnianie
Przekaż klucz w nagłówku:
x-api-key: your_api_key
Lub jako parametr zapytania, jeśli nagłówki są niewygodne (przeglądarka, boty streamerskie, arkusze):
?x-api-key=your_api_key
Brakujący, nieznany lub wyłączony klucz → 401 { "error": "Access denied" }
Tryby gry
Każdy endpoint przedmiotów istnieje w trzech trybach gry. Tryb można ustawić prefiksem ścieżki lub parametrem mode — oba sposoby dają tę samą odpowiedź:
Tryb
Prefiks ścieżki
Parametr
Źródło cen
PVP
/api/v1/…
domyślny
kolekcja items
PVE
/api/v1/pve/…
mode=pve
skan PVE
Season
/api/v1/season/…
mode=season
skan sezonowy
Postacie sezonowe
Gospodarka sezonowa jest skanowana osobno i dopiero się rozwija: przedmiot ma cenę targową dopiero po zauważeniu go przez skaner na targu sezonowym, a avg24hPrice / diff24h wypełniają się wraz ze zbieraniem historii cen. Pola niezależne od targu — basePrice i cena handlarza — używają wartości PVP, dopóki sezon nie otrzyma własnego zrzutu danych gry.
Tak wygląda brak ceny sezonowej (ten sam przedmiot, to samo żądanie, tryb sezonowy):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // brak ceny targowej sezonu
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // nigdy nie widziano na targu sezonowym
"haveMarketData": false, // nie używaj ceny tego przedmiotu
"basePrice": 970000, // dane spoza targu — takie same jak PVP
"traderName": "Therapist",
"traderPrice": 494700
}Endpointy
GET/item?q=ledx
Znajdź przedmiot po nazwie, uid lub bsgId.
qNazwa lub skrócona nazwa przedmiotu w dowolnym obsługiwanym języku. Zwraca do 5 dopasowań, dokładne jako pierwsze
uiduid przedmiotu Tarkov Market — zwraca dokładnie jeden przedmiot
bsgIdIdentyfikator przedmiotu z plików gry — zwraca dokładnie jeden przedmiot
langJęzyk nazw i linku do strony. Jeden z: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Domyślnie 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"
Przykład odpowiedzi
[
{
"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
To samo wyszukiwanie, ale z treścią JSON. Użyj go do zapytań spoza alfabetu łacińskiego, aby uniknąć kodowania URL.
q / uid / bsgIdTakie same jak w GET, przekazane w treści JSON
langTak samo jak w 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"}'Przykład odpowiedzi
[
{
"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 żądań/min
Wszystkie przedmioty w jednej tablicy. Dane są buforowane przez 5 minut, więc częstsze odpytywanie nic nie daje.
tagsZachowaj tylko przedmioty z tymi tagami, rozdzielonymi przecinkami: tags=Ammo,Magazines
sortSortuj według pola odpowiedzi, np. sort=price
sort_directionasc (domyślnie) lub desc
langJęzyk nazw i linków do strony
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"
Przykład odpowiedzi
[
{
"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 żądań/min
Ta sama pełna lista jako plik JSON do pobrania.
langJęzyk nazw i linków do strony
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"
Pola odpowiedzi
Pole
Znaczenie
uid
Identyfikator przedmiotu Tarkov Market — stały, używaj go jako klucza u siebie
bsgId
Identyfikator przedmiotu z plików gry
name / shortName
Nazwa przedmiotu w żądanym języku
tags
Kategorie przedmiotu, takie same jak filtry na stronie
price
Ostatnia znana cena targowa, ₽. 0 oznacza brak ceny dla tego trybu
avg24hPrice / avg7daysPrice
Średnia cena targowa z ostatnich 24 godzin / 7 dni, ₽
diff24h / diff7days
Zmiana ostatniej ceny względem tych średnich, %
basePrice
Cena bazowa przedmiotu z katalogu, ₽ — podstawa obliczania ceny skupu handlarza
traderName
Handlarz płacący najwięcej za przedmiot
traderPrice / traderPriceCur
Kwota płacona przez tego handlarza w jego walucie (₽, $ lub €)
traderPriceRub
Ta sama cena handlarza przeliczona na ₽ po kursie w grze
bannedOnFlea
Przedmiotu nie można sprzedać na pchlim targu
haveMarketData
Przedmiotem można handlować na targu, a cena jest aktualna. false oznacza, że nie należy ufać cenie
isFunctional
false dla przedmiotów usuniętych z gry lub niemożliwych do zdobycia
updated
Kiedy skaner ostatnio widział cenę targową. Pusta wartość oznacza, że nigdy
slots
Rozmiar przedmiotu w polach ekwipunku
img / imgBig
Ikona i duży obraz przedmiotu na moim CDN
icon
Starszy alias img — ten sam URL
link / wikiLink
Strona przedmiotu na tarkov-market.com i wiki
Limity i błędy
Zasada
Szczegóły
300 żądań/min
Na klucz, łącznie dla wszystkich endpointów. Napisz, jeśli twój projekt potrzebuje więcej.
5 żądań/min
Pełna lista przedmiotów i jej pobieranie we wszystkich trybach. Ceny i tak są buforowane przez 5 minut.
401
Brakujący, nieznany lub wyłączony klucz.
429
Osiągnięto limit żądań. Treść odpowiedzi wskazuje, który limit.
Warunki
API jest przeznaczone do użytku osobistego.
Jeśli używasz go w publicznym projekcie, podaj link do tarkov-market.com jako dostawcy danych.
Jeśli twój publiczny projekt kopiuje większość funkcji tarkov-market, dostęp może zostać odebrany bez ostrzeżenia i rekompensaty.
Jeśli odsprzedajesz API, dostęp zostanie odebrany bez ostrzeżenia i rekompensaty.