API

Country sentiment data API

The public API is read-only at launch: anonymous requests are available with low limits, and free API keys unlock higher limits for researchers, publishers, and builders. Commercial exports and high-volume access come later.

Endpoints

GET /api/rankings?category=most-loved&window=24h

Top ranked countries for a category and time window.

GET /api/categories

Ranking categories, vote types, labels, and enabled defaults.

GET /api/countries

Country, territory, observer, and disputed records with ISO metadata.

GET /api/country/palestine

One country profile with multi-category score map.

GET /api/compare?countryA=palestine&countryB=israel

Two-country score comparison.

GET /api/trends?category=most-divisive

Fastest rising, biggest drops, velocity, and reason trends.

GET /api/map?category=safest-to-visit

Map-ready country score data.

GET /api/world-cup/teams

World Cup 2026 teams, flags, groups, status, and sentiment scores.

GET /api/world-cup/matches?status=scheduled

World Cup fixtures, results, venues, and fairness overlays.

GET /api/world-cup/rankings?category=deserves-cup

Tournament rankings for deserves-cup, team support, fairness, controversy, and FIFA trust.

GET /api/world-cup/history

Historic World Cup match-results archive for context and research.

Access model

Anonymous GET requests: strict free limits, CORS enabled, cache headers included.

API keys: send Authorization: Bearer mhn_live_... for higher free limits.

Attribution required: “Data: MostHatedNation.com Global Country Sentiment Index”.

Vote submission is not exposed as a public automation API.

Response shape

{
  "category": "most-loved",
  "window": "24h",
  "data": [
    {
      "slug": "japan",
      "iso3": "JPN",
      "name": "Japan",
      "rank": 1,
      "score": 92.4,
      "confidence": "High",
      "recordType": "country"
    }
  ]
}

Keys, research, and commercial use

Use the contact page for free API key requests, research access, data corrections, attribution questions, or commercial export discussions. The launch API favors predictable cached reads over per-request billing.