Free tier available

Landvex Intelligence API

Societal intelligence for any application. Free tier available.

Try the demo → Get API key
Quickstart Authentication Point intelligence Contradiction Opportunities Cities Batch Vision Pricing Live demo
Quickstart
Base URL
https://api.landvex.com/v1/
Authentication: All requests require X-Api-Key: <key> in the request header. Free tier keys are available — request access.
curl
curl https://api.landvex.com/v1/intelligence/point \
  -H "X-Api-Key: YOUR_API_KEY" \
  -G \
  --data-urlencode "lat=59.334" \
  --data-urlencode "lng=18.063" \
  --data-urlencode "profile=business"
Authentication & limits
API key header
Include X-Api-Key: <your-key> on every request. Keys are tied to your tier and rate limits.
Response format
All responses are JSON. Scores are 0–100. Timestamps are ISO 8601 UTC. HTTP 429 is returned when rate limit is exceeded; back off and retry after Retry-After seconds.
HTTPS only
All API traffic must use HTTPS. HTTP requests are redirected or rejected.
Endpoints
GET /v1/intelligence/point

Returns district-level societal intelligence for a geographic coordinate. Includes an overall assessment score, grade, and colour, plus granular indices and a contradiction signal.

curl
curl "https://api.landvex.com/v1/intelligence/point?lat=59.334&lng=18.063&profile=business" \
  -H "X-Api-Key: YOUR_API_KEY"
response
{
  "district": "Vasastan",
  "city": "Stockholm",
  "country": "SE",
  "assessment": {
    "score": 82,
    "grade": "B+",
    "color": "#34c759"
  },
  "indices": {
    "commercial_vitality": 78,
    "infrastructure": 91,
    "urban_growth": 64,
    "safety": 88,
    "foot_traffic": 73
  },
  "contradiction": {
    "detected": false,
    "score": 0.12
  },
  "confidence": 0.94,
  "data_lag_hours": 168,
  "timestamp": "2026-06-22T03:00:00Z"
}
FieldTypeDescription
districtstringName of the matched district/neighbourhood
assessment.score0–100Overall intelligence score for the requested profile
assessment.gradestringLetter grade (A+, A, B+, … D)
assessment.colorhexColour for map visualisation
indicesobjectGranular sub-scores (0–100 each)
contradiction.detectedboolTrue when field data conflicts with official records
contradiction.score0–1Severity of contradiction signal
confidence0–1Model confidence based on data coverage
data_lag_hoursintHours since underlying data was collected
Profiles
businessfranchiseretailinvestmentresidentiallogisticshospitality
GET /v1/contradiction

Returns detailed contradiction analysis for a coordinate — identifying where field observations diverge from official planning data, census records, or prior assessments.

curl
curl "https://api.landvex.com/v1/contradiction?lat=59.334&lng=18.063" \
  -H "X-Api-Key: YOUR_API_KEY"
response
{
  "district": "Vasastan",
  "contradiction_index": 0.12,
  "severity": "low",
  "signals": [],
  "official_score": 80,
  "field_score": 83,
  "delta": +3,
  "confidence": 0.94
}
GET /v1/opportunities

Returns ranked location opportunities globally for a given business profile. Useful for site selection, market entry, and expansion planning.

curl
curl "https://api.landvex.com/v1/opportunities?profile=franchise&limit=5" \
  -H "X-Api-Key: YOUR_API_KEY"
response
{
  "profile": "franchise",
  "opportunities": [
    {
      "rank": 1,
      "city": "Bangkok",
      "district": "Sukhumvit",
      "lat": 13.742, "lng": 100.557,
      "score": 91,
      "rationale": "High foot traffic, growing expat density, low competition"
    },
    // … up to limit
  ],
  "total_locations_analysed": 4820
}
Profiles
franchiseretailinvestmentresidentiallogisticshospitality
GET /v1/cities/:city

Returns city-level intelligence including overall scores, district breakdown, and trend data for the requested profile.

curl
curl "https://api.landvex.com/v1/cities/stockholm?profile=investment" \
  -H "X-Api-Key: YOUR_API_KEY"
response
{
  "city": "Stockholm",
  "country": "SE",
  "profile": "investment",
  "score": 79,
  "grade": "B",
  "top_districts": [
    { "name": "Östermalm", "score": 88 },
    { "name": "Södermalm", "score": 83 },
    { "name": "Vasastan",  "score": 82 }
  ],
  "population": 975000,
  "data_lag_hours": 168
}
POST /v1/intelligence/batch

Analyse multiple coordinates in a single request. Returns an array of point intelligence objects in the same order as input. Available from Starter tier.

curl
curl -X POST https://api.landvex.com/v1/intelligence/batch \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "points": [
      { "lat": 59.334, "lng": 18.063 },
      { "lat": 57.706, "lng": 11.967 }
    ],
    "profile": "business"
  }'
response
{
  "profile": "business",
  "results": [
    { "district": "Vasastan",   "score": 82, "grade": "B+" },
    { "district": "Haga",       "score": 76, "grade": "B"  }
  ],
  "count": 2
}
POST /v1/vision/analyze

Analyses a street-level or aerial image combined with a geographic coordinate to produce a vision-enhanced intelligence assessment. Available from Professional tier.

curl
curl -X POST https://api.landvex.com/v1/vision/analyze \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_path": "/path/to/image.jpg",
    "lat": 13.742,
    "lng": 100.557,
    "city": "bangkok"
  }'
response
{
  "district": "Sukhumvit",
  "vision_score": 88,
  "vision_signals": [
    "High foot traffic density",
    "Modern retail streetscape",
    "Visible construction activity"
  ],
  "combined_score": 91,
  "confidence": 0.89,
  "image_quality": "good"
}

Pricing
Plans
All plans include access to historical data. Upgrade at any time.
Free
$0
1,000 req / month
  • Historical data
  • Point intelligence
  • Area queries
  • JSON responses
Starter
$99/mo
50,000 req / month
  • 7-day data lag
  • Batch API
  • City + district
  • Opportunities
Enterprise
Custom
Unlimited
  • Live data feed
  • SLA guarantee
  • Dedicated pipeline
  • Custom integration
Contact for Enterprise →

Live demo
// Response will appear here… // Uses GET /v1/intelligence/point with your parameters.
Ready

Support
Developer support
api@landvex.com — integration help, bug reports, feedback
Enterprise sales
enterprise@landvex.com — volume pricing, SLA, dedicated pipeline