کھلا ڈیٹا

ڈیٹا اور 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 فیلڈز نہیں ہٹائے گا اور نہ ان کے نام بدلے گا؛ نئے فیلڈز شامل کیے جا سکتے ہیں۔