tarkov APItarkov.dev ↗
Access Escape from Tarkov ammunition stats (damage, penetration, armor damage) and full wipe duration history via the tarkov.dev API.
What is the tarkov API?
This API exposes 2 endpoints covering Escape from Tarkov game data sourced from tarkov.dev. The get_ammo endpoint returns a full list of ammunition types with per-round stats including damage, penetration power, armor damage, caliber, speed, and fragmentation modifiers. The get_wipe_info endpoint returns historical wipe records with start and end dates, individual wipe lengths, and a computed average across the last 6 completed wipes.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8ce03f91-33d8-4656-9735-4b3e9452ae06/get_ammo' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tarkov-dev-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.tarkov_dev_api import Tarkov, Ammo, Wipe, WipeHistory
client = Tarkov()
# List all ammunition and inspect stats
for ammo in client.ammos.list():
print(ammo.name, ammo.caliber, ammo.damage, ammo.penetration_power, ammo.initial_speed)
# Get wipe history overview
history = client.wipehistories.get()
print(history.average_wipe_length)
for wipe in history.historical_wipes:
print(wipe.patch, wipe.wipe_start, wipe.wipe_end, wipe.duration_days)
Retrieve all ammunition types and their ballistic statistics from the Tarkov.dev GraphQL API. Returns every round in the game with damage, penetration power, armor damage percentage, caliber, muzzle velocity, fragmentation chance, bleed modifiers, and recoil/accuracy modifiers. No parameters — the full ammo table is returned in one call.
No input parameters required.
{
"type": "object",
"fields": {
"ammo": "array of ammunition stat objects, each containing item.name, item.shortName, caliber, damage, penetrationPower, armorDamage, fragmentationChance, accuracyModifier, recoilModifier, initialSpeed, ammoType, projectileCount, lightBleedModifier, heavyBleedModifier, staminaBurnPerDamage"
},
"sample": {
"data": {
"ammo": [
{
"item": {
"name": "5.56x45mm M855",
"shortName": "M855"
},
"damage": 54,
"caliber": "Caliber556x45NATO",
"ammoType": "bullet",
"armorDamage": 37,
"initialSpeed": 922,
"recoilModifier": 0,
"projectileCount": 1,
"accuracyModifier": 0,
"penetrationPower": 31,
"heavyBleedModifier": 0,
"lightBleedModifier": 0,
"fragmentationChance": 0.5,
"staminaBurnPerDamage": 0.144
}
]
},
"status": "success"
}
}About the tarkov API
Ammunition Data
The get_ammo endpoint takes no input parameters and returns an ammo array. Each object in the array includes the item's full name and short name, caliber classification, damage, penetrationPower, armorDamage, projectile speed, and several modifiers such as fragmentation chance. This covers all ammunition types tracked by tarkov.dev, making it suitable for comparisons across calibers or building ammo-selection tooling.
Wipe History and Duration Statistics
The get_wipe_info endpoint returns two top-level fields. historical_wipes is an array of objects, each containing the patch version, wipe_start date (YYYY-MM-DD), wipe_end date (YYYY-MM-DD, or the string 'Ongoing wipe' for the current cycle), and wipe_length as a human-readable string. The second field, average_wipe_length, is a precomputed string (e.g., '175 days') derived from the last 6 completed wipes, so you don't need to compute the rolling average yourself.
Coverage Notes
Neither endpoint requires authentication or query parameters — both return the full dataset on every call. The wipe data includes an active wipe record with 'Ongoing wipe' as the end date, which your client code should handle explicitly if computing durations. Ammo stats reflect the tarkov.dev dataset at the time of the request; values change when Battlestate Games patches the game and tarkov.dev updates accordingly.
The tarkov API is a managed, monitored endpoint for tarkov.dev — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tarkov.dev changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tarkov.dev API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an ammo comparison tool that ranks rounds by penetration power versus armor damage across all calibers.
- Generate a tier list of ammunition for a given caliber using the damage and fragmentation modifier fields.
- Display current wipe status and estimated remaining wipe length based on historical average wipe duration.
- Track wipe cycle patterns over time using historical start and end dates from get_wipe_info.
- Integrate ammo stats into a loadout builder that surfaces penetration and speed data per cartridge.
- Trigger alerts or notifications when a new wipe starts by detecting a changed wipe_start date.
- Compute wipe length variance across patches using the individual wipe_length values in historical_wipes.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.