Api keys management

Terms and Conditions

Api is intended for personal use.

If you use it for public project please place a link to tarkov-market.com website as data provider.

If you use it for public project, and your project copy most tarkov-market features, your access can be terminated without any warnings and compensations.

If you are reselling the Api - your access will be terminated without any warnings and compensations.

Api endpoints

Auth: you should pass header

x-api-key: your_api_key

Auth: or search query param x-api-key

?x-api-key=your_api_key

Find item by name

/api/v1/item?q=[item name]

Example

curl -H x-api-key:your_api_key https://api.tarkov-market.app/api/v1/item?q=btc

https://api.tarkov-market.app/api/v1/item?q=btc&x-api-key=your_api_key

[
    {
        "uid": "5ac84494-465a-424a-b36e-fe22869ba5ec",
        "name": "Physical bitcoin",
        "tags": [
        "Barter"
        ],
        "shortName": "0.2BTC",
        "price": 374097,
        "basePrice": 123577,
        "avg24hPrice": 379526,
        "avg7daysPrice": 357188,
        "traderName": "Therapist",
        "traderPrice": 374097,
        "traderPriceCur": "₽",
        "updated": "2021-10-16T17:00:03.876Z",
        "slots": 1,
        "diff24h": -1.43,
        "diff7days": 4.73,
        "icon": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_sm.png",
        "link": "https://tarkov-market.com/item/physical_bitcoin_(btc)",
        "wikiLink": "https://escapefromtarkov.gamepedia.com/Physical_bitcoin",
        "img": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_sm.png",
        "imgBig": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_lg.png",
        "bsgId": "59faff1d86f7746c51718c9c",
        "isFunctional": true,
        "reference": "https://www.patreon.com/tarkov_market"
    }
]

Find item by uid

/api/v1/item?uid=[item uid]

Example

curl -H x-api-key:your_api_key https://api.tarkov-market.app/api/v1/item?uid=5ac84494-465a-424a-b36e-fe22869ba5ec

[
    {
        "uid": "5ac84494-465a-424a-b36e-fe22869ba5ec",
        "name": "Physical bitcoin",
        "tags": [
        "Barter"
        ],
        "shortName": "0.2BTC",
        "price": 374097,
        "basePrice": 123577,
        "avg24hPrice": 379526,
        "avg7daysPrice": 357188,
        "traderName": "Therapist",
        "traderPrice": 374097,
        "traderPriceCur": "₽",
        "updated": "2021-10-16T17:00:03.876Z",
        "slots": 1,
        "diff24h": -1.43,
        "diff7days": 4.73,
        "icon": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_sm.png",
        "link": "https://tarkov-market.com/item/physical_bitcoin_(btc)",
        "wikiLink": "https://escapefromtarkov.gamepedia.com/Physical_bitcoin",
        "img": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_sm.png",
        "imgBig": "https://cdn.tarkov-market.app/images/items/physical_bitcoin_(btc)_lg.png",
        "bsgId": "59faff1d86f7746c51718c9c",
        "isFunctional": true,
        "reference": "https://www.patreon.com/tarkov_market"
    }
]

Get all items (Limits: 5 reqs / min)

/api/v1/items/all

Example

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",
        ...
    },
    {
        "uid": "33c15349-44e6-4553-9705-1b6417a1ad6a",
        "name": "SSD drive",
        ...
    },
    ...
]

Get all items by tag

/api/v1/items/all?tags=[tag uid]

Or you can specify multiple tags, for example

/api/v1/items/all?tags=Ammo,Magazines

Example

curl -H x-api-key:your_api_key https://api.tarkov-market.app/api/v1/items/all?tags=Ammo

[
    {
        "uid": "79da7191-3bd2-4b6d-a02c-607ed02c2aff",
        "name": "5.56x45mm M995",
        "tags": [
        "Ammo",
        "5.56x45mm_NATO"
        ],
        ...
    },
    {
        "uid": "9609f8dd-3869-4d92-a62d-2cbf3a5e33fc",
        "name": "9x39mm BP gs",
        "tags": [
        "Ammo",
        "9x39mm"
        ],
        ...
    },
    ...
]

Get all items sort by field (price for example)

/api/v1/items/all?sort=price&sort_direction=desc

Use unicode chars without encoding (useful when you search with localization)

POST /api/v1/item
{
    "q":"item name",
    "lang":"cn"
}

lang can be:

en, ru, de, fr, es, cn, cz, hu, tr, jp, kr

Example

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":"cn"}'

[
    {
        "uid": "2335b619-c562-41da-962f-e7b5aba5d45c",
        "name": "AI-2急救组合",
        "tags": [
        "Meds"
        ],
        "shortName": "AI-2",
        "price": 3995,
        "basePrice": 3250,
        "avg24hPrice": 3965,
        "avg7daysPrice": 3995,
        "traderName": "Therapist",
        "traderPrice": 2048,
        "traderPriceCur": "₽",
        "updated": "2021-10-16T16:28:02.126Z",
        "slots": 1,
        "diff24h": 0.76,
        "diff7days": 0,
        "icon": "https://cdn.tarkov-market.app/images/items/ai-2_medikit_sm.png",
        "link": "https://tarkov-market.com/cn/item/ai-2_medikit",
        "wikiLink": "https://escapefromtarkov.gamepedia.com/AI-2_medikit",
        "img": "https://cdn.tarkov-market.app/images/items/ai-2_medikit_sm.png",
        "imgBig": "https://cdn.tarkov-market.app/images/items/ai-2_medikit_lg.png",
        "bsgId": "5755356824597772cb798962",
        "isFunctional": true,
        "reference": "https://www.patreon.com/tarkov_market"
    }
]