Skip to main content
GET
/
v1
/
insights
/
neighborhood-insights
Neighborhood Insights
curl --request GET \
  --url https://api.findloka.com/v1/insights/neighborhood-insights \
  --header 'Authorization: <authorization>'
{
  "meta": {
    "api_version": "1.0.0",
    "request_id": "7f3e9a2c-4b1d-4e8f-9c3a-5d7e8f9a0b1c",
    "generated_at_utc": "2025-10-21T14:30:00.000000",
    "generated_at_utc_timestamp": 1729522200,
    "ttl_seconds": 86400,
    "etag": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "context": {
    "address": {
      "street": "1600 Amphitheatre Parkway",
      "city": "Mountain View",
      "state": "CA",
      "zip_code": "94043",
      "country": "USA"
    }
  },
  "coverage": {
    "latest_update_days": 3,
    "data_sources": ["FindLoka Proprietary AI models"]
  },
  "score_summary": {
    "loka_score": {
      "score": 78,
      "score_range": {
        "min": 0,
        "max": 100
      },
      "why_this_score": "This location offers excellent walkability and transit access, with strong amenities and good environmental quality."
    },
    "neighborhood_metrics": [
      {
        "id": "accessibility",
        "data": {
          "name": "Neighborhood Accessibility",
          "score": 7.8,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Excellent walkability with strong bike infrastructure",
          "loka_tip": "Consider proximity to public transit and walkable areas",
          "blurb": "Analyzes 52 metrics covering walkability, public transit, biking, and parking. Evaluates how easily you can access daily needs and navigate the area using various transportation options.",
          "submetrics": [
            {
              "id": "walkability",
              "data": {
                "name": "Walkability",
                "score": 8.5,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 0.5,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Easy to run daily errands and enjoy nearby spots on foot.",
                "info": "Determined by sidewalks, crosswalks, and pedestrian amenities, along with 11 additional walkability factors within a 0.5-mile radius. The distance is set to reflect a true walking zone so daily needs and transit are reachable on foot.",
                "source": "FindLoka Proprietary AI models"
              }
            },
            {
              "id": "bikeability",
              "data": {
                "name": "Bikeability",
                "score": 7.2,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.5,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Dedicated bike lanes and connected routes make cycling convenient.",
                "info": "Determined by bike lanes, shared paths, and parking facilities, along with 8 additional bikeability factors within a 1.5-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "commute_and_traffic",
        "data": {
          "name": "Commute and Traffic",
          "score": 7.5,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Smooth traffic flow with good road infrastructure",
          "loka_tip": "Consider peak traffic hours when planning commutes",
          "blurb": "Examines 52 metrics related to traffic flow, road conditions, and driving safety.",
          "submetrics": [
            {
              "id": "transit_access",
              "data": {
                "name": "Transit Access",
                "score": 8.0,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 0.75,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Multiple nearby transit options with frequent service.",
                "info": "Determined by bus stops, rail stations, and transit coverage.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      }
    ]
  }
}

​
Overview

The Neighborhood Insights API provides comprehensive data about a property’s location, including accessibility, commute & traffic, lifestyle amenities, environment, essential services, and safety & community metrics. This endpoint returns detailed scores, descriptions, and insights across 24+ individual metrics organized into 6 main categories.
To obtain an API key, please contact our sales team.

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Query Parameters

​
street
string
required
The street address (e.g., “123 Main St”)
​
city
string
required
The city name (e.g., “San Francisco”)
​
state
string
required
The state code (e.g., “CA”)
​
zip_code
string
required
The ZIP/postal code (e.g., “94102”)
​
country
string
required
The country name (e.g., “USA”)
{
  "meta": {
    "api_version": "1.0.0",
    "request_id": "7f3e9a2c-4b1d-4e8f-9c3a-5d7e8f9a0b1c",
    "generated_at_utc": "2025-10-21T14:30:00.000000",
    "generated_at_utc_timestamp": 1729522200,
    "ttl_seconds": 86400,
    "etag": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "context": {
    "address": {
      "street": "1600 Amphitheatre Parkway",
      "city": "Mountain View",
      "state": "CA",
      "zip_code": "94043",
      "country": "USA"
    }
  },
  "coverage": {
    "latest_update_days": 3,
    "data_sources": ["FindLoka Proprietary AI models"]
  },
  "score_summary": {
    "loka_score": {
      "score": 78,
      "score_range": {
        "min": 0,
        "max": 100
      },
      "why_this_score": "This location offers excellent walkability and transit access, with strong amenities and good environmental quality."
    },
    "neighborhood_metrics": [
      {
        "id": "accessibility",
        "data": {
          "name": "Neighborhood Accessibility",
          "score": 7.8,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Excellent walkability with strong bike infrastructure",
          "loka_tip": "Consider proximity to public transit and walkable areas",
          "blurb": "Analyzes 52 metrics covering walkability, public transit, biking, and parking. Evaluates how easily you can access daily needs and navigate the area using various transportation options.",
          "submetrics": [
            {
              "id": "walkability",
              "data": {
                "name": "Walkability",
                "score": 8.5,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 0.5,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Easy to run daily errands and enjoy nearby spots on foot.",
                "info": "Determined by sidewalks, crosswalks, and pedestrian amenities, along with 11 additional walkability factors within a 0.5-mile radius. The distance is set to reflect a true walking zone so daily needs and transit are reachable on foot.",
                "source": "FindLoka Proprietary AI models"
              }
            },
            {
              "id": "bikeability",
              "data": {
                "name": "Bikeability",
                "score": 7.2,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.5,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Dedicated bike lanes and connected routes make cycling convenient.",
                "info": "Determined by bike lanes, shared paths, and parking facilities, along with 8 additional bikeability factors within a 1.5-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "commute_and_traffic",
        "data": {
          "name": "Commute and Traffic",
          "score": 7.5,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Smooth traffic flow with good road infrastructure",
          "loka_tip": "Consider peak traffic hours when planning commutes",
          "blurb": "Examines 52 metrics related to traffic flow, road conditions, and driving safety.",
          "submetrics": [
            {
              "id": "transit_access",
              "data": {
                "name": "Transit Access",
                "score": 8.0,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 0.75,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Multiple nearby transit options with frequent service.",
                "info": "Determined by bus stops, rail stations, and transit coverage.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      }
    ]
  }
}

​
Response Structure

The response includes:

​
Meta Information

  • api_version: Current API version
  • request_id: Unique identifier for this request
  • generated_at_utc: Timestamp when data was generated
  • ttl_seconds: Time-to-live for cached data
  • etag: Entity tag for cache validation

​
Context

  • address: Complete address breakdown

​
Coverage

  • latest_update_days: Days since last data update
  • data_sources: List of data sources used

​
Score Summary

  • loka_score: Overall neighborhood score (0-100)
  • neighborhood_metrics: Array of 6 main category metrics, each containing:
    • Category score (weighted average of submetrics)
    • Category-level insight and loka_tip
    • Submetrics array with individual scores, descriptions, and metadata

​
Main Categories

The API returns data for 6 main categories:
  1. Neighborhood Accessibility - Walkability, bikeability, parking, main roads, airport access
  2. Commute & Traffic - Transit access, traffic flow, driving convenience, road conditions, crosswalk safety
  3. Lifestyle Amenities - Dining, shopping, recreation, nightlife, arts & culture, sports
  4. Environment & Surroundings - Environmental quality, green spaces, air quality, quietness, disaster safety
  5. Essential Services - Education, healthcare, daily errands, waste management, EV charging
  6. Safety & Community - Neighborhood safety, community vibe, pet amenities, cell signal coverage

​
Notes

  • Scores range from 0-10 for individual metrics (0-100 for overall loka_score)
  • Higher scores indicate better performance
  • Descriptions are contextual based on score level (high ≥ 7, medium ≥ 4, low < 4)
  • The address must exist in the FindLoka database with pre-calculated analytics
  • Make sure to URL-encode query parameters when making requests
⌘I