Bwendi Context API

List all markets at or above the requested economic tier for a country. The special tier hubs uses an 80/20 rule on Huff-catchment intensity to auto-detect the primary market hubs.

GET /markets/prime/CM

{
  "tier": "prime",
  "country_code": "CM",
  "count": 8,
  "markets": [
    {
      "name": "Douala",
      "type": "city",
      "lat": 4.0483,
      "lng": 9.7043,
      "population": 2768400,
      "economic_tier": "dominant",
      "market_score": 11.5
    }
  ]
}

Hierarchy: dominant › prime › high › integrated › moderate › peripheral › marginal › isolated

Edge-only — no backend round-trip. Three variants:

{
  "name": "Cameroon",
  "localName": "Cameroun",
  "code": "CM",
  "callingCode": "+237",
  "flag": "🇨🇲",
  "lang": "fr",
  "currency": {
    "symbol": "FCFA",
    "code": "XAF",
    "name": "Central African CFA Franc",
    "localName": "Franc CFA"
  }
}

Auto-resolves the country code from coordinates using a 0.25° edge grid, then returns the full context. Response header x-resolved-cc shows the detected country.

GET /context/3.8667/11.5167

Response is identical to /context/:cc/:lat/:lng below.

Full geographic context for a coordinate inside a known country.

GET /context/CM/3.8667/11.5167

{
  "name": "Yaoundé",
  "ascii_name": "Yaounde",
  "lat": 3.8667,
  "lng": 11.5167,
  "type": "city",
  "within": {
    "name": "Centre",
    "label": "Région",
    "type": "region",
    "level": 4
  },
  "label": "Ville",
  "population": 2765568,
  "language": "fr",
  "economic_tier": "dominant",
  "distance": 0,
  "direction": "N",
  "context": "In Yaoundé, Centre region",
  "anchors": {
    "immediate": ["city"],
    "local": ["city"],
    "reachable": ["city"]
  },
  "markets": [
    {
      "name": "Douala",
      "type": "city",
      "distance": 194,
      "direction": "SW",
      "population": 2768400,
      "economic_tier": "dominant",
      "priority": 1,
      "text": "194km SW to Douala"
    }
  ],
  "nearby": [
    {
      "name": "Mballa II",
      "type": "suburb",
      "distance": 2.1,
      "direction": "NE"
    }
  ],
  "country": {
    "name": "Cameroon",
    "localName": "Cameroun",
    "code": "CM",
    "callingCode": "+237",
    "flag": "🇨🇲",
    "lang": "fr",
    "currency": {
      "symbol": "FCFA",
      "code": "XAF",
      "name": "Central African CFA Franc"
    }
  }
}

Fuzzy place name search within a country. Returns matching settlements ranked by population.

GET /search/CM?q=Douala

{
  "country_code": "CM",
  "query": "Douala",
  "count": 3,
  "results": [
    {
      "name": "Douala",
      "type": "city",
      "lat": 4.0483,
      "lng": 9.7043,
      "population": 2768400,
      "economic_tier": "dominant",
      "within": "Littoral"
    }
  ]
}

Resolves full location context, then feeds it along with a user prompt to Gemini for AI-powered geospatial analysis. Returns the complete context response plus the AI interpretation.

POST /interpret/CM/3.8667/11.5167
Content-Type: application/json

{ "prompt": "What is the commercial potential?" }

Returns the full context response (same as /context) plus:

"ai": {
  "prompt": "What is the commercial potential?",
  "response": "This location is Cameroon's political capital with a population of 2.8M. The dominant economic tier and high gravity score indicate strong commercial integration. Douala, the economic hub, is 194km SW — the dual-hub corridor between these cities is the most commercially active zone in the country..."
}

Server health check — no authentication required.

{
  "status": "ok",
  "uptime": 84210,
  "countries_loaded": 47,
  "memory_mb": 128,
  "timestamp": "2026-02-14T12:00:00.000Z"
}

List all available countries, or get detailed info for a specific country.

// GET /countries
{
  "built": ["AD","AE","CM","NG",...],
  "built_count": 47,
  "source": [...],
  "source_count": 200
}

// GET /countries/CM
{
  "country_code": "CM",
  "has_data": true,
  "has_db": true,
  "db_size_mb": 12.4,
  "db_modified": "2026-02-14T10:00:00Z",
  "config": {...}
}

All supported translation languages and their count.

{
  "languages": {
    "fr": "Français",
    "es": "Español",
    "de": "Deutsch",
    ...
  },
  "country_count": 47,
  "unique_languages": ["fr","es","de",...],
  "unique_count": 24
}