Tarkov Market API
Escape from Tarkov의 플리마켓 시세, 상인 가격, 아이템 데이터를 제공합니다. 기본 url: https://api.tarkov-market.app/api/v1
의존성 없는 공식 클라이언트: Node.js, Python, Go — github.com/ggdiam/tarkov-market-api
API 키
API를 사용하려면 사이트의 Pro 상태 가 필요합니다. 아래 예시에는 다음 자리표시자가 들어 있습니다: your_api_key.
인증
키는 헤더로 전달합니다:
x-api-key: your_api_key
헤더를 쓰기 어려운 환경(브라우저, 스트리밍 봇, 스프레드시트)에서는 쿼리 파라미터로도 전달할 수 있습니다:
?x-api-key=your_api_key
키가 없거나, 알 수 없거나, 비활성인 경우 → 401 { "error": "Access denied" }
게임 모드
모든 아이템 엔드포인트는 세 가지 게임 모드로 제공됩니다. 모드는 경로 접두사로 지정하거나 다음 파라미터로 지정할 수 있으며, mode 어느 쪽이든 응답은 동일합니다:
모드
경로 접두사
파라미터
시세 출처
PVP
/api/v1/…
기본값
items 컬렉션
PVE
/api/v1/pve/…
mode=pve
PVE 스캔
Season
/api/v1/season/…
mode=season
시즌 스캔
시즌 캐릭터
시즌 경제는 따로 스캔되며 아직 데이터가 얼마 쌓이지 않았습니다. 스캐너가 시즌 플리마켓에서 해당 아이템을 본 뒤에야 플리마켓 가격이 생기고, avg24hPrice / diff24h는 시즌 시세 기록이 쌓이면서 채워집니다. 플리마켓과 무관한 필드인 basePrice와 상인 가격은, 시즌 전용 게임 데이터 덤프가 생기기 전까지 PVP 값을 그대로 씁니다.
시즌 가격이 아직 없는 경우는 이렇게 보입니다 (같은 아이템, 같은 요청, 시즌 모드):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // 아직 시즌 플리마켓 가격이 없습니다
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // 시즌 플리마켓에서 한 번도 관측되지 않았습니다
"haveMarketData": false, // 이 아이템의 price는 신뢰하지 마십시오
"basePrice": 970000, // 플리마켓 데이터가 아니라 PVP와 동일합니다
"traderName": "Therapist",
"traderPrice": 494700
}엔드포인트
GET/item?q=ledx
이름, uid 또는 bsgId로 아이템을 찾습니다.
q아이템 이름 또는 짧은 이름이며, 지원하는 아무 로케일이나 됩니다. 최대 5개가 반환되고 정확히 일치하는 항목이 먼저 옵니다
uidTarkov Market 아이템 uid — 정확히 하나의 아이템을 반환합니다
bsgId게임 파일의 아이템 id — 정확히 하나의 아이템을 반환합니다
lang이름과 사이트 링크의 로케일입니다. 다음 중 하나: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. 기본값 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"
응답 예시
[
{
"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
같은 검색이지만 json 본문을 사용합니다. 라틴 문자가 아닌 검색어를 url 인코딩 없이 보낼 때 편리합니다.
q / uid / bsgIdGET과 동일하며 json 본문으로 전달합니다
langGET과 동일
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"}'응답 예시
[
{
"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/all분당 5회
모든 아이템을 배열 하나로 반환합니다. 데이터는 5분간 캐시되므로 그보다 자주 호출해도 얻는 것이 없습니다.
tags이 태그를 가진 아이템만 남깁니다. 쉼표로 구분: tags=Ammo,Magazines
sort응답 필드로 정렬합니다. 예: sort=price
sort_directionasc (기본값) 또는 desc
lang이름과 사이트 링크의 로케일
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"
응답 예시
[
{
"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/download분당 5회
같은 전체 목록을 json 파일로 내려받습니다.
lang이름과 사이트 링크의 로케일
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"
응답 필드
필드
의미
uid
Tarkov Market 아이템 id — 값이 바뀌지 않으므로 이쪽 키로 사용하십시오
bsgId
게임 파일의 아이템 id
name / shortName
요청한 로케일의 아이템 이름
tags
아이템 카테고리이며, 사이트에서 필터에 쓰는 것과 같습니다
price
마지막으로 알려진 플리마켓 가격, ₽. 0은 이 모드에 가격이 없다는 뜻입니다
avg24hPrice / avg7daysPrice
최근 24시간 / 7일 플리마켓 평균 가격, ₽
diff24h / diff7days
그 평균 대비 최근 가격의 변동률, %
basePrice
아이템 기본 가격(도감 기준), ₽ — 상인 매입가는 이 값에서 계산됩니다
traderName
이 아이템을 가장 비싸게 사들이는 상인
traderPrice / traderPriceCur
그 상인이 지불하는 금액이며 해당 상인의 화폐 기준입니다 (₽, $ 또는 €)
traderPriceRub
같은 상인 가격을 게임 내 환율로 ₽로 환산한 값
bannedOnFlea
플리마켓에서 판매할 수 없는 아이템
haveMarketData
플리마켓에서 거래되며 가격이 최신이라는 뜻입니다 — false면 price를 신뢰하지 마십시오
isFunctional
게임에서 제거되었거나 획득할 수 없는 아이템은 false입니다
updated
스캐너가 플리마켓 가격을 마지막으로 본 시각입니다. 비어 있으면 한 번도 본 적이 없다는 뜻입니다
slots
인벤토리에서 아이템이 차지하는 칸 수
img / imgBig
우리 cdn에 있는 아이템 아이콘과 큰 이미지
icon
img의 레거시 별칭 — 같은 url입니다
link / wikiLink
tarkov-market.com과 위키의 아이템 페이지
한도와 오류
규칙
상세
분당 300회
키 하나 기준이며 모든 엔드포인트를 합산합니다. 더 필요하면 문의해 주십시오.
분당 5회
전체 아이템 목록과 그 다운로드이며 모든 모드에 적용됩니다. 어차피 시세는 5분간 캐시됩니다.
401
키가 없거나, 알 수 없거나, 비활성입니다.
429
요청 한도에 도달했습니다 — 어떤 한도인지는 응답 본문에 있습니다.
이용 조건
이 API는 개인 용도로 제공됩니다.
공개 프로젝트에 사용하는 경우 데이터 출처로 tarkov-market.com 링크를 표시해 주십시오.
공개 프로젝트가 tarkov-market의 기능 대부분을 그대로 베끼는 경우, 사전 통보나 보상 없이 접근이 차단될 수 있습니다.
API 접근 권한을 재판매하는 경우, 사전 통보나 보상 없이 접근이 차단됩니다.