دادهی باز
داده و 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 ۱۸٬۷۲۱ 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: نقشهی رأی سازمان ملل برای هر سال از ۱۹۴۶ و بلوکهای رأیگیری در هر دوره (Nations on Record). پاسخهای مربوط به جفتهاtrade_agreements_and_sanctionsرا هم دارند؛ پاسخهای مربوط به کشورهاvoting_blocوsanctions_regimesرا.
ستونهای فایل جفتها
| ستون | معنا |
|---|---|
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 فقطخواندنی، باز برای هر وبسایتی (CORS). بدون کلید، بدون حساب کاربری. ملاحظه کنید: نقطهی پایانی جفت هزینهی کمی دارد، اما لطفاً آنچه را دریافت میکنید ذخیره (cache) کنید.
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 ۱۸٬۷۲۱ 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 هیچ فیلدی را حذف نمیکند یا تغییر نام نمیدهد؛ ممکن است فیلدهای تازه افزوده شوند.