공개 데이터

데이터 및 API, 누구나 재사용할 수 있도록

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.

파일

  • 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: 규칙 버전, 빌드 날짜, 데이터 기간, 출처, 라이선스.
  • /api/v1/votemap: 1946년 이후 매년의 유엔 투표 지도와 기간별 투표 블록(Nations on Record). 쌍 응답에는 trade_agreements_and_sanctions도 들어 있고, 국가 응답에는 voting_bloc과 sanctions_regimes가 들어 있습니다.

쌍 파일의 열

열의미
aISO 3166-1 alpha-3 code of the country that comes first alphabetically
bcode of the other country
a_namename of a
b_namename of b
indexrelationship index, -100 to +100; empty when votes or trade are missing
labelVery close, Close, Neutral, Distant, Opposed or Not enough data
votesUN votes score, -100 to +100 (how close b stands among a's voting partners, and a among b's)
tradetrade score, 0 to 100 (dependence of the more dependent side, log scale)
securitysecurity score, -100 to +100 (UCDP: fighting on opposite sides pulls down, NATO and fighting side by side push up)
clubsshared clubs score, 0 to 100
same_voteshare of recorded General Assembly votes cast the same way, last three years with data (0 to 1)
trade_usd_per_yeargoods trade both ways, US dollars a year, last three years with data
trade_share_athat trade as a share of all of a's trade (0 to 1)
trade_share_bthat trade as a share of all of b's trade (0 to 1)
shared_groupstracked groups both belong to, separated by semicolons
opposed_last_yearlatest year UCDP records them on opposite sides as main parties or with troops; empty if never
sentences_a_to_bsentences in General Debate speeches, 1946 on, in which a names b
sentences_b_to_asentences in which b names a
topic_all_votesvote agreement on all roll-call votes since 2010 (same measure as the topic columns)
topic_disarmamentthe same on disarmament votes
topic_middle_eastthe same on middle east votes
topic_human_rightsthe same on human rights votes
topic_colonialismthe same on colonialism votes
topic_nuclear_weaponsthe same on nuclear weapons votes
topic_economic_developmentthe same on economic development votes
shared_votes_headlineshared whole-text roll-call votes in the years the headline vote agreement covers
confidence_voteshow much data the votes score stands on: high, medium, low or none (see /method#confidence)

API

읽기 전용 JSON으로, 어느 웹사이트에서나 쓸 수 있습니다(CORS). 키도 계정도 필요 없습니다. 배려해 주세요: 쌍 엔드포인트는 부담이 적지만, 가져온 데이터는 캐시해 주세요.

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

쌍 응답에는 지수, 네 가지 점수, 그 근거가 되는 사실, 연도별 시계열(투표 일치도, 양방향 수출, 서로를 언급한 문장), 페이지·PDF 팩트 시트·공유 카드 링크, 그리고 규칙 버전이 담긴 meta 블록이 있습니다. 코드는 항상 알파벳순(a가 b보다 먼저)이므로, exports_a_to_b는 모든 응답에서 같은 뜻입니다.

쌍 임베드

모든 쌍은 작은 카드로 임베드할 수 있습니다. 두 나라, 지수, 네 가지 점수와 원래 페이지로 돌아가는 링크가 담깁니다. 쌍 페이지 상단 바의 임베드를 쓰거나, 다음을 붙여 넣으세요:

<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.

라이선스

우리의 점수와 글: CC BY-NC 4.0(출처를 밝히면 재사용 가능, 상업적 목적 불가). 원본 데이터에는 각각의 라이선스가 적용됩니다:

  • 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)

인용 방법

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

참고문헌 관리 프로그램용: CITATION.cff(Citation File Format).

안정성

  • 페이지 주소는 바뀌지 않습니다: 쌍은 /p/<iso3>-<iso3>, 국가는 /c/<iso3>. 페이지의 점수는 데이터나 규칙이 바뀌면 달라질 수 있습니다. 페이지, 각 파일, 각 PDF에 적힌 규칙 버전과 빌드 날짜가 어느 쪽인지 알려 줍니다.
  • 규칙이나 데이터의 모든 변경은 바뀐 것에 날짜와 함께 기록되며 Atom 피드도 있습니다. 정정 사항도 그곳에 기록됩니다.
  • API 버전 1은 필드를 삭제하거나 이름을 바꾸지 않습니다. 새 필드는 추가될 수 있습니다.