Dati aperti
Dati e API, riutilizzabili da tutti
Scoring rules 0.4 (14 Nov 2026), scores built 2026-11-14 21:20 UTC. Use them in a classroom, a newsroom or a paper; cite the version.
File
nationsrelations-pairs.csv: the scores and key facts of all 18.721 pairs (one row per pair, codes in alphabetical order).nationsrelations-countries.csv: the 194 countries with ISO codes and UN regional group./api/v1/meta: versione delle regole, data di generazione, periodi coperti dai dati, fonti, licenza./api/v1/votemap: la mappa dei voti ONU per ogni anno dal 1946 e i blocchi di voto per periodo (Nations on Record). Le risposte per le coppie contengono anchetrade_agreements_and_sanctions; quelle per i paesi contengonovoting_blocesanctions_regimes.
Colonne del file delle coppie
| Colonna | Significato |
|---|---|
a | ISO 3166-1 alpha-3 code of the country that comes first alphabetically |
b | code of the other country |
a_name | name of a |
b_name | name of b |
index | relationship index, -100 to +100; empty when votes or trade are missing |
label | Very close, Close, Neutral, Distant, Opposed or Not enough data |
votes | UN votes score, -100 to +100 (how close b stands among a's voting partners, and a among b's) |
trade | trade score, 0 to 100 (dependence of the more dependent side, log scale) |
security | security score, -100 to +100 (UCDP: fighting on opposite sides pulls down, NATO and fighting side by side push up) |
clubs | shared clubs score, 0 to 100 |
same_vote | share of recorded General Assembly votes cast the same way, last three years with data (0 to 1) |
trade_usd_per_year | goods trade both ways, US dollars a year, last three years with data |
trade_share_a | that trade as a share of all of a's trade (0 to 1) |
trade_share_b | that trade as a share of all of b's trade (0 to 1) |
shared_groups | tracked groups both belong to, separated by semicolons |
opposed_last_year | latest year UCDP records them on opposite sides as main parties or with troops; empty if never |
sentences_a_to_b | sentences in General Debate speeches, 1946 on, in which a names b |
sentences_b_to_a | sentences in which b names a |
topic_all_votes | vote agreement on all roll-call votes since 2010 (same measure as the topic columns) |
topic_disarmament | the same on disarmament votes |
topic_middle_east | the same on middle east votes |
topic_human_rights | the same on human rights votes |
topic_colonialism | the same on colonialism votes |
topic_nuclear_weapons | the same on nuclear weapons votes |
topic_economic_development | the same on economic development votes |
shared_votes_headline | shared whole-text roll-call votes in the years the headline vote agreement covers |
confidence_votes | how much data the votes score stands on: high, medium, low or none (see /method#confidence) |
API
JSON in sola lettura, aperto a qualsiasi sito web (CORS). Nessuna chiave, nessun account. Usalo con garbo: l’endpoint delle coppie costa poco, ma per favore metti in cache ciò che scarichi.
curl https://nationsrelations.org/api/v1/pair/irn-usa # either order of the codes works: irn-usa or usa-irn
curl https://nationsrelations.org/api/v1/country/deu
curl https://nationsrelations.org/api/v1/meta
curl https://nationsrelations.org/api/v1/changes # what moved in the last rebuilds of the scores
La risposta per una coppia contiene l’indice, i quattro punteggi, i fatti su cui si basano, le serie annuali (concordanza di voto, esportazioni in ciascuna direzione, frasi in cui l’uno nomina l’altro), i link alla pagina, alla scheda informativa in PDF e alla scheda di condivisione, e il blocco meta con la versione delle regole. I codici sono sempre in ordine alfabetico (a prima di b), quindi exports_a_to_b significa la stessa cosa in ogni risposta.
Incorporare una coppia
Ogni coppia può essere incorporata come piccola scheda: i due paesi, l’indice e i quattro punteggi, con un link di ritorno. Usa Incorpora nella barra in cima alla pagina di una coppia, oppure incolla:
<iframe src="https://nationsrelations.org/embed/p/irn-usa" width="520" height="330" style="border:0;max-width:100%" loading="lazy" title="NationsRelations: Iran and United States"></iframe>
The card updates when the scores do and carries the rules version and build date. Editors and chat tools that speak oEmbed can take the plain page address: https://nationsrelations.org/oembed?url=https://nationsrelations.org/p/irn-usa (JSON only). Same licence as everything else here. Embed pages are not indexed by search engines.
Licenza
I nostri punteggi e testi: CC BY-NC 4.0 (riutilizzo con attribuzione, non a fini commerciali). I dati di origine mantengono le proprie licenze:
- Country context (not scored, not in the downloads): World Bank World Development Indicators (CC BY 4.0), IMF World Economic Outlook, SIPRI Military Expenditure Database, V-Dem electoral democracy index (CC BY-SA 4.0, via Our World in Data), all through Nations on Record
- Nations on Record: UN General Assembly votes (Voeten et al.; UN Digital Library), General Debate speeches (Harvard Dataverse), IMF International Trade in Goods
- Uppsala Conflict Data Program, Dyadic and Battle-Related Deaths datasets, version 26.1 (CC BY 4.0)
- UN DESA International Migrant Stock 2024 (CC BY 3.0 IGO)
- UNHCR Refugee Population Statistics (CC BY 4.0)
- International football results 1872 to present, Mart Jürisoo (CC0)
- WTO Regional Trade Agreements database (trade agreements; reuse with attribution)
- EU Sanctions Map (EU and UN regimes, (c) European Union), OFAC (US Treasury, public domain), gov.uk (UK, Open Government Licence v3.0)
Come citare
NationsRelations. (2026). Pair scores of 18.721 country pairs [scoring rules 0.4 (14 Nov 2026), scores built 2026-11-14]. https://nationsrelations.org/data
Per i gestori di bibliografie: CITATION.cff (Citation File Format).
Stabilità
- Gli indirizzi delle pagine non cambiano:
/p/<iso3>-<iso3>per le coppie,/c/<iso3>per i paesi. Un punteggio su una pagina può cambiare quando cambiano i dati o le regole; la versione delle regole e la data di generazione riportate sulla pagina, in ogni file e in ogni PDF indicano quali. - Ogni modifica alle regole o ai dati è datata in Cosa è cambiato, con un feed Atom. Lì sono elencate anche le correzioni.
- La versione 1 dell’API non rimuoverà né rinominerà campi; potranno esserne aggiunti di nuovi.