Class DataDumps

Access to the Politics & War daily data dumps (https://politicsandwar.com/data).

Each method downloads a category's dump, unzips and parses it, and returns the rows fully typed and cast (see the row interfaces in DataDumpRowMap). With no date the most recent available dump is used; pass a YYYY-MM-DD date to fetch a specific day.

Example

const pnwkit = new PnWKit("your-api-key");

const nations = await pnwkit.dataDumps.nations();          // NationRow[]
const wars = await pnwkit.dataDumps.wars("2026-08-01");     // WarRow[]
const cities = await pnwkit.dataDumps.get("cities");        // CityRow[]

Index

Constructors

constructor

Methods

alliances cities get nations trades wars

Constructors

constructor

new DataDumps(): DataDumps

Returns DataDumps

Methods

alliances

alliances(date?: string): Promise<AllianceRow[]>
Fetch the alliances dump.
Parameters
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<AllianceRow[]>
- Defined in dataDumps/index.ts:40

cities

cities(date?: string): Promise<CityRow[]>
Fetch the cities dump.
Parameters
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<CityRow[]>
- Defined in dataDumps/index.ts:49

get

get<C extends DataDumpCategory>(
category: C,
date?: string,
): Promise<DataDumpRowMap[C][]>
Fetch a dump by category name.
Type Parameters
- C extends DataDumpCategory
Parameters
- category: C
  The dump category (see DataDumpCategory)
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<DataDumpRowMap[C][]>
The parsed, type-cast rows for the category
- Defined in dataDumps/index.ts:31

nations

nations(date?: string): Promise<NationRow[]>
Fetch the nations dump.
Parameters
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<NationRow[]>
- Defined in dataDumps/index.ts:58

trades

trades(date?: string): Promise<TradeRow[]>
Fetch the trades dump.
Parameters
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<TradeRow[]>
- Defined in dataDumps/index.ts:67

wars

wars(date?: string): Promise<WarRow[]>
Fetch the wars dump.
Parameters
- Optionaldate: string
  Optional dump date (YYYY-MM-DD); defaults to the latest available
Returns Promise<WarRow[]>
- Defined in dataDumps/index.ts:76

Class DataDumps

Example

Index

Constructors

Methods

Constructors

constructor

Returns DataDumps

Methods

alliances

Parameters

Returns Promise<AllianceRow[]>

cities

Parameters

Returns Promise<CityRow[]>

get

Type Parameters

Parameters

Returns Promise<DataDumpRowMap[C][]>

nations

Parameters

Returns Promise<NationRow[]>

trades

Parameters

Returns Promise<TradeRow[]>

wars

Parameters

Returns Promise<WarRow[]>

Settings

On This Page