API

Programmatic access to global trust data. Open, free, no authentication required.

Base URL

https://api.trustatlas.org

Format

JSON

Auth

None required

Quick Start

Fetch trust data for any country in seconds:

curl "https://api.trustatlas.org/country/USA"

# Response includes time series for all four pillars:
# interpersonal, institutional, governance, and media trust

Endpoints

GET/countries

List all countries with their latest trust scores and metadata.

curl "https://api.trustatlas.org/countries"

Example response

[
  {
    "iso3": "DNK",
    "name": "Denmark",
    "region": "Europe",
    "interpersonal": 74.2,
    "institutional": 62.1,
    "governance": 88.0,
    "media": 56.0
  },
  ...
]

GET/country/:iso3

Get detailed time series data for a specific country.

curl "https://api.trustatlas.org/country/USA"

Example response

{
  "iso3": "USA",
  "name": "United States",
  "region": "North America",
  "series": [
    { "year": 2024, "interpersonal": 30.1, ... },
    { "year": 2022, "interpersonal": 31.2, ... }
  ]
}

GET/trends/global

Get latest scores for all countries by pillar. Use for map visualizations.

curl "https://api.trustatlas.org/trends/global?pillar=governance"

Example response

{
  "pillar": "governance",
  "year": 2024,
  "countries": [
    { "iso3": "DNK", "name": "Denmark", "score": 88.0 },
    ...
  ]
}

GET/trends/regions

Get aggregated trust statistics by geographic region.

curl "https://api.trustatlas.org/trends/regions?pillar=interpersonal"

Example response

{
  "regions": [
    {
      "region": "Northern Europe",
      "avgScore": 62.4,
      "countryCount": 10
    },
    ...
  ]
}

GET/methodology

Get the current methodology specification as JSON.

curl "https://api.trustatlas.org/methodology"

Example response

{
  "version": "0.6.0",
  "pillars": {
    "interpersonal": { ... },
    "institutional": { ... },
    "governance": { ... },
    "media": { ... }
  }
}

GET/sources

Get metadata for all data sources including licenses and citations.

curl "https://api.trustatlas.org/sources"

Example response

[
  {
    "source": "WVS",
    "name": "World Values Survey",
    "license": "Custom Terms",
    "commercial_use_allowed": false,
    "citation_template": "World Values Survey..."
  },
  ...
]

GET/trends/countries

Batch fetch trend data for multiple countries. Supports pillars (social, institutions, media) and supplementary indicators (financial).

curl "https://api.trustatlas.org/trends/countries?iso3=VNM,CHN,USA&pillar=financial"

Example response

{
  "countries": {
    "VNM": {
      "name": "Vietnam",
      "region": "Asia",
      "financial": [
        {"year": 2020, "score": 94.2, "source": "WVS"}
      ]
    },
    "CHN": {
      "name": "China",
      "financial": [{"year": 2018, "score": 91.0, ...}]
    },
    "USA": {
      "name": "United States",
      "financial": [{"year": 2017, "score": 10.3, ...}]
    }
  }
}

Rate Limits

100 requests per minute per IP. Responses are cached for 24 hours.

Need higher limits? Open an issue on GitHub.

Full Documentation

Complete API reference with all parameters, error codes, and data schemas.

View on GitHub