War Thunder APIwiki.warthunder.com ↗
Access the full War Thunder naval vehicle database. List all ships and boats, retrieve battle ratings, armaments, specs, and economy data for any vessel.
What is the War Thunder API?
The War Thunder Wiki Ships API provides structured access to the complete naval vehicle database across 2 endpoints, covering both Bluewater and Coastal Fleet vessels. The list_ships endpoint returns every ship identifier, display name, wiki URL, and fleet classification in a single call. The get_ship_details endpoint then delivers battle ratings per game mode, rank, card info, armament breakdowns, technical specifications, and economy data for any individual vessel.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ac97457d-cdca-4c02-b074-1a44e39571e0/list_ships' \ -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 wiki-warthunder-com-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.war_thunder_wiki_ship_data_api import WarThunderWiki, Ship, ShipSummary
client = WarThunderWiki()
# List all ships and iterate summaries
for summary in client.shipsummaries.list(limit=5):
print(summary.name, summary.fleet, summary.url)
# Get full details for a specific ship
ship = client.ships.get(identifier="us_destroyer_clemson_litchfield")
print(ship.name, ship.rank, ship.br)
print(ship.card_info, ship.sections)
# Navigate from summary to detail
entry = client.shipsummary("us_destroyer_clemson_litchfield")
detail = entry.details()
print(detail.name, detail.rank, detail.url)
List all ships and boats available in the War Thunder Wiki. Covers both Bluewater Fleet and Coastal Fleet categories. Returns an array of ship identifiers, names, URLs, and fleet classifications. Each item includes an identifier usable with get_ship_details for full specifications.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of ship summary objects, each containing name, identifier, url, and fleet",
"total": "integer total count of ships returned"
},
"sample": {
"data": {
"items": [
{
"url": "https://wiki.warthunder.com/unit/us_destroyer_clemson_litchfield",
"name": "USS Litchfield",
"fleet": "Bluewater Fleet",
"identifier": "us_destroyer_clemson_litchfield"
}
],
"total": 556
},
"status": "success"
}
}About the War Thunder API
What the API Covers
The API exposes data from the War Thunder Wiki's naval vehicle catalog, which spans Bluewater Fleet warships and Coastal Fleet smaller craft. list_ships returns an array of ship objects — each with a name, identifier, url, and fleet classification — plus a total integer count. The identifier strings (e.g., us_destroyer_fletcher) follow the in-game naming convention and are the required input for the detail endpoint.
Ship Detail Data
get_ship_details accepts a single required identifier parameter and returns a structured object. The br field maps game mode abbreviations (AB, RB) to their battle rating strings. The card_info object surfaces summary data including Rank, Battle rating, Research country, Main role, Research cost, and Purchase cost. The rank field returns the in-game tier designation (e.g., II), and url gives the canonical wiki page link.
Sections and Specifications
The sections object contains parsed wiki content organized by heading: Specification, Economy, and armament-type sections. These fields allow comparison of technical parameters — such as displacement, engine output, and weapon loadouts — across vessels without manually parsing wiki markup. The level of detail within each section reflects what the wiki page itself exposes for that vehicle.
The War Thunder API is a managed, monitored endpoint for wiki.warthunder.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wiki.warthunder.com 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 wiki.warthunder.com 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 a ship comparison tool using
brbattle ratings across AB and RB game modes - Aggregate Research cost and Purchase cost from
card_infoto map naval tech-tree progression - Filter ships by
fleetclassification to separate Bluewater and Coastal Fleet lineups - Index all ship identifiers from
list_shipsto power an autocomplete search interface - Extract armament sections from
get_ship_detailsto compare weapon loadouts across vessels of the same rank - Track in-game economy data per ship using the Economy section returned in
sections - Generate rank-grouped rosters by combining the
rankfield from multipleget_ship_detailscalls
| 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.
Does War Thunder have an official public developer API for its wiki data?+
What does `get_ship_details` return for battle ratings, and does it cover all game modes?+
br field returns a mapping of game mode abbreviations to battle rating strings. Currently the response includes AB (Arcade Battles) and RB (Realistic Battles). Simulator Battles (SB) ratings are not currently surfaced. The API covers AB and RB data. You can fork it on Parse and revise it to add the missing SB battle rating field.Can I retrieve the full historical or lore text from a ship's wiki page?+
Are there any gaps in coverage — do all ships have complete section data?+
sections reflects what the underlying wiki page exposes for each vehicle. Less-documented ships may have sparse or missing specification subsections. The list_ships endpoint does return all vessels regardless of how complete their detail pages are, so some identifiers may yield partial data from get_ship_details.