Tarkov Market API
Precios del mercado de pulgas, precios de vendedores y datos de objetos de Escape from Tarkov. URL base: https://api.tarkov-market.app/api/v1
Clientes oficiales sin dependencias: Node.js, Python y Go — github.com/ggdiam/tarkov-market-api
Clave API
Para usar la API necesitas estado Pro en la web. Los ejemplos siguientes usan el marcador your_api_key.
Autenticación
Envía tu clave en una cabecera:
x-api-key: your_api_key
O como parámetro de consulta si las cabeceras resultan incómodas (navegador, bots de streaming, hojas de cálculo):
?x-api-key=your_api_key
Clave ausente, desconocida o desactivada → 401 { "error": "Access denied" }
Modos de juego
Cada endpoint de objetos existe en tres modos. El modo se establece con un prefijo de ruta o con mode como parámetro: ambos devuelven la misma respuesta:
Modo
Prefijo de ruta
Parámetro
Origen de precios
PVP
/api/v1/…
predeterminado
colección items
PVE
/api/v1/pve/…
mode=pve
escaneo PVE
Season
/api/v1/season/…
mode=season
escaneo de temporada
Personajes de temporada
La economía de temporada se escanea por separado y es reciente: un objeto tiene precio cuando el escáner lo ha visto en el mercado de pulgas de temporada; avg24hPrice / diff24h se completan al acumular historial. Los campos independientes del mercado de pulgas, basePrice y precio del vendedor, usan valores PVP hasta que la temporada tenga su propia exportación de datos del juego.
Así se ve un precio de temporada aún ausente (mismo objeto y solicitud, modo de temporada):
{
"uid": "a7f7568c-61fb-437e-9f71-06e58aae26ba",
"name": "LEDX Skin Transilluminator",
"price": 0, // aún sin precio en el mercado de pulgas de temporada
"avg24hPrice": 0,
"diff24h": 0,
"updated": "", // nunca visto en el mercado de pulgas de temporada
"haveMarketData": false, // no usar el precio de este objeto
"basePrice": 970000, // datos ajenos al mercado de pulgas: iguales a PVP
"traderName": "Therapist",
"traderPrice": 494700
}Endpoints
GET/item?q=ledx
Busca un objeto por nombre, uid o bsgId.
qNombre o nombre corto del objeto en cualquier idioma admitido. Devuelve hasta 5 coincidencias, primero la exacta
uidUID de Tarkov Market del objeto: devuelve exactamente un objeto
bsgIdID del objeto en los archivos del juego: devuelve exactamente un objeto
langIdioma de los nombres y del enlace web. Uno de: en, ru, ch, cz, de, es, fr, hu, it, jp, kr, mx, pl, po, ro, sk, tr. Predeterminado: 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"
Ejemplo de respuesta
[
{
"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
La misma búsqueda con cuerpo JSON: úsala para consultas no latinas sin tener que codificarlas en la URL.
q / uid / bsgIdIgual que en GET, enviados en el cuerpo JSON
langIgual que en 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"}'Ejemplo de respuesta
[
{
"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 solicitudes/min
Todos los objetos en un array. Los datos se guardan en caché 5 minutos: consultar más a menudo no aporta datos nuevos.
tagsConservar solo objetos con estas etiquetas, separadas por comas: tags=Ammo,Magazines
sortOrdenar por un campo de respuesta, por ejemplo sort=price
sort_directionasc (predeterminado) o desc
langIdioma de los nombres y enlaces 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"
Ejemplo de respuesta
[
{
"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 solicitudes/min
La misma lista completa como archivo JSON descargable.
langIdioma de los nombres y enlaces 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"
Campos de respuesta
Campo
Significado
uid
ID de Tarkov Market del objeto: estable, úsalo como clave en tu proyecto
bsgId
ID del objeto en los archivos del juego
name / shortName
Nombre del objeto en el idioma solicitado
tags
Categorías del objeto, las mismas que usan los filtros de la web
price
Último precio conocido del mercado de pulgas, ₽. 0 significa sin precio para este modo
avg24hPrice / avg7daysPrice
Precio medio del mercado de pulgas en las últimas 24 horas / 7 días, ₽
diff24h / diff7days
Variación del último precio respecto a esas medias, %
basePrice
Precio base del objeto (manual), ₽, del que se calcula la compra por vendedores
traderName
Vendedor que más paga por el objeto
traderPrice / traderPriceCur
Lo que paga ese vendedor en su divisa (₽, $ o €)
traderPriceRub
El mismo precio del vendedor convertido a ₽ al cambio del juego
bannedOnFlea
El objeto no se puede vender en el mercado de pulgas
haveMarketData
El objeto se puede negociar en el mercado de pulgas y el precio es reciente; false indica que no te fíes del precio
isFunctional
false para objetos retirados del juego o imposibles de obtener
updated
Cuándo vio el escáner el precio por última vez. Vacío significa nunca
slots
Tamaño del objeto en casillas del inventario
img / imgBig
Icono e imagen grande del objeto en mi CDN
icon
Alias antiguo de img: misma URL
link / wikiLink
Página del objeto en tarkov-market.com y en la wiki
Límites y errores
Regla
Detalles
300 solicitudes/min
Por clave, entre todos los endpoints. Escríbeme si tu proyecto necesita más.
5 solicitudes/min
Lista completa y descarga, en todos los modos. Los precios se guardan en caché 5 minutos de todos modos.
401
Clave ausente, desconocida o desactivada.
429
Límite de solicitudes alcanzado: el cuerpo indica cuál.
Condiciones
La API está destinada al uso personal.
Si la usas para un proyecto público, enlaza tarkov-market.com como proveedor de datos.
Si tu proyecto público copia la mayoría de funciones de tarkov-market, tu acceso puede cancelarse sin aviso ni compensación.
Si revendes la API, tu acceso se cancelará sin aviso ni compensación.