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 / bsgId与GET相同，通过JSON请求体传递
lang与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"}'响应示例
[
{
"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次请求/分钟
以一个数组返回全部物品。数据缓存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/download5次请求/分钟
以可下载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及Wiki上的物品页面
限制与错误
规则
详情
300次请求/分钟
按密钥统计，所有接口共用。项目需要更高额度时请联系我。
5次请求/分钟
适用于各模式完整物品列表及其下载，价格均缓存5分钟。
401
密钥缺失、未知或已禁用。
429
已达到频率限制，响应体会说明触发了哪项限制。
使用条款
API旨在供个人使用。
若用于公开项目，请链接tarkov-market.com并注明其为数据提供方。
若你的公开项目复制了Tarkov Market的大部分功能，访问权限可能在无预警、无补偿的情况下终止。
若转售API，访问权限将被终止，且不作预警或补偿。