Societal intelligence for any application. Free tier available.
X-Api-Key: <key> in the request header. Free tier keys are available — request access.
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"
X-Api-Key: <your-key> on every request. Keys are tied to your tier and rate limits.Retry-After seconds.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 "https://api.landvex.com/v1/intelligence/point?lat=59.334&lng=18.063&profile=business" \
-H "X-Api-Key: YOUR_API_KEY"
{
"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"
}
| Field | Type | Description |
|---|---|---|
| district | string | Name of the matched district/neighbourhood |
| assessment.score | 0–100 | Overall intelligence score for the requested profile |
| assessment.grade | string | Letter grade (A+, A, B+, … D) |
| assessment.color | hex | Colour for map visualisation |
| indices | object | Granular sub-scores (0–100 each) |
| contradiction.detected | bool | True when field data conflicts with official records |
| contradiction.score | 0–1 | Severity of contradiction signal |
| confidence | 0–1 | Model confidence based on data coverage |
| data_lag_hours | int | Hours since underlying data was collected |
businessfranchiseretailinvestmentresidentiallogisticshospitality
Returns detailed contradiction analysis for a coordinate — identifying where field observations diverge from official planning data, census records, or prior assessments.
curl "https://api.landvex.com/v1/contradiction?lat=59.334&lng=18.063" \
-H "X-Api-Key: YOUR_API_KEY"
{
"district": "Vasastan",
"contradiction_index": 0.12,
"severity": "low",
"signals": [],
"official_score": 80,
"field_score": 83,
"delta": +3,
"confidence": 0.94
}
Returns ranked location opportunities globally for a given business profile. Useful for site selection, market entry, and expansion planning.
curl "https://api.landvex.com/v1/opportunities?profile=franchise&limit=5" \
-H "X-Api-Key: YOUR_API_KEY"
{
"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
}
franchiseretailinvestmentresidentiallogisticshospitality
Returns city-level intelligence including overall scores, district breakdown, and trend data for the requested profile.
curl "https://api.landvex.com/v1/cities/stockholm?profile=investment" \
-H "X-Api-Key: YOUR_API_KEY"
{
"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
}
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 -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"
}'
{
"profile": "business",
"results": [
{ "district": "Vasastan", "score": 82, "grade": "B+" },
{ "district": "Haga", "score": 76, "grade": "B" }
],
"count": 2
}
Analyses a street-level or aerial image combined with a geographic coordinate to produce a vision-enhanced intelligence assessment. Available from Professional tier.
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"
}'
{
"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"
}