Dữ liệu mở
Dữ liệu và API, cho bất kỳ ai tái sử dụng
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.
Tệp
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: phiên bản quy tắc, ngày tạo bản dựng, các khoảng thời gian dữ liệu, nguồn, giấy phép./api/v1/votemap: bản đồ bỏ phiếu tại Liên Hợp Quốc cho mỗi năm kể từ 1946 và các khối bỏ phiếu theo từng thời kỳ (Nations on Record). Kết quả cho một cặp còn cótrade_agreements_and_sanctions; kết quả cho một quốc gia cóvoting_blocvàsanctions_regimes.
Các cột của tệp cặp
| Cột | Ý nghĩa |
|---|---|
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 chỉ đọc, mở cho mọi trang web (CORS). Không cần khóa, không cần tài khoản. Xin hãy nhẹ tay: endpoint cho cặp rất nhẹ, nhưng vui lòng lưu bộ nhớ đệm những gì bạn tải về.
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
Kết quả cho một cặp gồm chỉ số, bốn điểm số, các dữ kiện đằng sau chúng, chuỗi số liệu theo năm (mức đồng thuận phiếu bầu, xuất khẩu theo mỗi chiều, số câu nhắc đến nhau), liên kết tới trang, tờ thông tin PDF và thẻ chia sẻ, cùng khối meta với phiên bản quy tắc. Các mã luôn theo thứ tự bảng chữ cái (a trước b), nên exports_a_to_b có cùng một nghĩa trong mọi kết quả.
Nhúng một cặp
Mỗi cặp có thể được nhúng dưới dạng một thẻ nhỏ: hai quốc gia, chỉ số và bốn điểm số, kèm liên kết trở lại. Dùng Nhúng trên thanh ở đầu trang cặp, hoặc dán:
<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.
Giấy phép
Điểm số và văn bản của chúng tôi: CC BY-NC 4.0 (được tái sử dụng khi ghi nguồn, không dùng cho mục đích thương mại). Dữ liệu nguồn giữ giấy phép riêng của chúng:
- 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)
Cách trích dẫn
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
Cho phần mềm quản lý tài liệu tham khảo: CITATION.cff (Citation File Format).
Tính ổn định
- Địa chỉ trang không thay đổi:
/p/<iso3>-<iso3>cho các cặp,/c/<iso3>cho các quốc gia. Một điểm số trên trang có thể thay đổi khi dữ liệu hoặc quy tắc thay đổi; phiên bản quy tắc và ngày tạo bản dựng trên trang, trong mỗi tệp và trong mỗi PDF cho biết là cái nào. - Mọi thay đổi về quy tắc hoặc dữ liệu đều được ghi ngày trên trang Điều gì đã thay đổi, kèm nguồn cấp Atom. Các đính chính cũng được liệt kê ở đó.
- Phiên bản 1 của API sẽ không xóa hay đổi tên các trường; có thể thêm trường mới.