wiki.warthunder.com 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.
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'
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.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of ship 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"
},
{
"url": "https://wiki.warthunder.com/unit/us_destroyer_clemson_barker",
"name": "USS Barker",
"fleet": "Bluewater Fleet",
"identifier": "us_destroyer_clemson_barker"
}
],
"total": 555
},
"status": "success"
}
}About the wiki.warthunder.com 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.
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.
- 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 | 250 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.