Tarkov Market API
Escape from Tarkov için bit pazarı fiyatları, tüccar fiyatları ve eşya verileri. Temel URL: https://api.tarkov-market.app/api/v1
Bağımlılıksız resmî istemciler: Node.js, Python ve Go — github.com/ggdiam/tarkov-market-api
API anahtarı
API'yi kullanmak için gereken: PRO durumu gereklidir. Aşağıdaki örneklerde kullanılan yer tutucu: your_api_key.
Kimlik doğrulama
Anahtarınızı bir başlıkta gönderin:
x-api-key: your_api_key
Başlıklar uygun değilse sorgu parametresi olarak gönderin (tarayıcı, yayın botları, e-tablolar):
?x-api-key=your_api_key
Eksik, bilinmeyen veya devre dışı anahtar → 401 { "error": "Access denied" }
Oyun modları
Her eşya uç noktası üç oyun modunda mevcuttur. Mod, yol önekiyle veya şu parametreyle belirlenir: mode — ikisi de aynı yanıtı verir:
Mod
Yol öneki
Parametre
Fiyat kaynağı
PVP
/api/v1/…
varsayılan
items koleksiyonu
PVE
/api/v1/pve/…
mode=pve
PVE taraması
Season
/api/v1/season/…
mode=season
sezon taraması
Sezonluk karakterler
Sezon ekonomisi ayrı taranır ve henüz yenidir: bir eşyanın bit pazarı fiyatı, tarayıcı onu sezon bit pazarında gördükten sonra oluşur. avg24hPrice / diff24h sezon fiyat geçmişi biriktikçe dolar. Bit pazarına bağlı olmayan basePrice ve tüccar fiyatı alanları, sezonun kendi oyun verisi dökümü gelene kadar PVP değerlerini kullanır.
Henüz sezon fiyatı yoksa şöyle görünür (aynı eşya, aynı istek, sezon modu):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // henüz sezon bit pazarı fiyatı yok
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // sezon bit pazarında hiç görülmedi
"haveMarketData": false, // bu eşyanın fiyatını kullanmayın
"basePrice": 970000, // bit pazarı verisi değil; PVP ile aynı
"traderName": "Therapist",
"traderPrice": 494700
}Uç noktalar
GET/item?q=ledx
Eşyayı ad, uid veya bsgId ile bulun.
qDesteklenen herhangi bir dilde eşya adı veya kısa adı. En fazla 5 sonuç döndürür; tam eşleşme önce gelir
uidTarkov Market eşya uid'si; tam olarak bir eşya döndürür
bsgIdOyun dosyalarındaki eşya kimliği; tam olarak bir eşya döndürür
langAdların ve site bağlantısının dili. Seçenekler: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Varsayılan 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"
Yanıt örneği
[
{
"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
Aynı arama, JSON gövdesiyle; Latin dışı sorgularda URL kodlamasına gerek kalmaması için kullanın.
q / uid / bsgIdGET ile aynı; JSON gövdesinde gönderilir
langGET ile aynı
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"}'Yanıt örneği
[
{
"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 istek/dk.
Tüm eşyalar tek dizide. Veriler 5 dakika önbelleğe alınır; daha sık sorgulamak yarar sağlamaz.
tagsYalnızca virgülle ayrılan bu etiketlere sahip eşyaları tut: tags=Ammo,Magazines
sortBir yanıt alanına göre sırala; ör. sort=price
sort_directionasc (varsayılan) veya desc
langAdların ve site bağlantılarının dili
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"
Yanıt örneği
[
{
"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 istek/dk.
Aynı tam liste, indirilebilir JSON dosyası olarak.
langAdların ve site bağlantılarının dili
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"
Yanıt alanları
Alan
Anlamı
uid
Tarkov Market eşya kimliği; sabittir, kendi tarafınızda anahtar olarak kullanın
bsgId
Oyun dosyalarındaki eşya kimliği
name / shortName
İstenen dilde eşya adı
tags
Site filtreleriyle aynı eşya kategorileri
price
Bilinen son bit pazarı fiyatı, ₽. 0, bu mod için fiyat olmadığı anlamına gelir
avg24hPrice / avg7daysPrice
Son 24 saatin / 7 günün ortalama bit pazarı fiyatı, ₽
diff24h / diff7days
Son fiyatın bu ortalamalara göre değişimi, %
basePrice
Eşyanın temel (el kitabı) fiyatı, ₽; tüccar geri alımının hesaplandığı değer
traderName
Eşyaya en çok ödeme yapan tüccar
traderPrice / traderPriceCur
Bu tüccarın kendi para biriminde ödediği tutar (₽, $ veya €)
traderPriceRub
Aynı tüccar fiyatının oyun içi kurla ₽ karşılığı
bannedOnFlea
Eşya bit pazarında satılamaz
haveMarketData
Eşya bit pazarında satılabilir ve fiyatı günceldir; false ise fiyata güvenmeyin
isFunctional
Oyundan kaldırılan veya elde edilemeyen eşyalarda false
updated
Tarayıcının bit pazarı fiyatını en son gördüğü zaman. Boşsa hiç görülmemiştir
slots
Eşyanın hücre cinsinden envanter boyutu
img / imgBig
CDN'imdeki eşya simgesi ve büyük görsel
icon
img alanının eski takma adı; aynı URL
link / wikiLink
tarkov-market.com ve wiki üzerindeki eşya sayfası
Sınırlar ve hatalar
Kural
Ayrıntılar
300 istek/dk.
Tüm uç noktalarda anahtar başına. Projenizin daha fazlasına ihtiyacı varsa sorun.
5 istek/dk.
Her modda tam eşya listesi ve indirmesi. Fiyatlar zaten 5 dakika önbellekte tutulur.
401
Anahtar eksik, bilinmiyor veya devre dışı.
429
İstek sınırına ulaşıldı; gövde hangi sınır olduğunu belirtir.
Koşullar
API, kişisel kullanım için tasarlanmıştır.
Herkese açık bir projede kullanıyorsanız lütfen veri sağlayıcısı olarak tarkov-market.com'a bağlantı verin.
Herkese açık projeniz Tarkov Market özelliklerinin çoğunu kopyalarsa erişiminiz uyarı ve tazminat olmadan sonlandırılabilir.
API'yi yeniden satarsanız erişiminiz uyarı ve tazminat olmadan sonlandırılır.