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"
              }
            }
          ]
        }
      },
      {
        "id": "lifestyle_amenities",
        "data": {
          "name": "Lifestyle Amenities",
          "score": 8.2,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Rich dining and entertainment options nearby",
          "loka_tip": "Consider the variety of local amenities for daily convenience",
          "blurb": "Evaluates dining, shopping, recreation, nightlife, arts & culture, and sports facilities to assess lifestyle quality and entertainment options.",
          "submetrics": [
            {
              "id": "dining_options",
              "data": {
                "name": "Dining Options",
                "score": 8.5,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Excellent variety of restaurants and cafes within walking distance.",
                "info": "Determined by restaurant density, cuisine variety, and ratings within a 1.0-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "environment_and_surroundings",
        "data": {
          "name": "Environment and Surroundings", 
          "score": 7.1,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Good air quality with adequate green spaces",
          "loka_tip": "Air quality scores are consistently good for outdoor activities",
          "blurb": "Analyzes environmental quality, green spaces, air quality, noise levels, and disaster safety for overall environmental health.",
          "submetrics": [
            {
              "id": "air_quality",
              "data": {
                "name": "Air Quality",
                "score": 7.8,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 2.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Good air quality with low pollution levels.",
                "info": "Based on EPA air quality measurements and pollution monitoring data.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "essential_services",
        "data": {
          "name": "Essential Services",
          "score": 8.0,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Strong educational and healthcare access",
          "loka_tip": "Schools and medical facilities are easily accessible",
          "blurb": "Covers education, healthcare, daily errands, waste management, and EV charging infrastructure for essential daily needs.",
          "submetrics": [
            {
              "id": "schools_and_education",
              "data": {
                "name": "Schools and Education",
                "score": 8.3,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 2.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "High-quality schools with good ratings nearby.",
                "info": "Based on school ratings, diversity of educational options, and accessibility within a 2.0-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "safety_and_community",
        "data": {
          "name": "Safety and Community",
          "score": 7.9,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Safe neighborhood with good community feel",
          "loka_tip": "Low crime rates and strong community engagement",
          "blurb": "Assesses neighborhood safety, community engagement, pet amenities, and connectivity for overall quality of life.",
          "submetrics": [
            {
              "id": "neighborhood_safety",
              "data": {
                "name": "Neighborhood Safety",
                "score": 8.1,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Very safe area with low crime rates.",
                "info": "Based on crime statistics, police presence, and community safety measures.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      }
    ]
  },
  "places_of_interest": {
    "restaurants_cafes_diners": {
      "radius_miles": 1.0,
      "counts": {
        "total": 3
      },
      "items": [
        {
          "name": "Blue Bottle Coffee",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=abc123&key=API_KEY",
          "rating": 4.2,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.3
        },
        {
          "name": "Local Bistro",
          "address": "1650 Amphitheatre Pkwy, Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=def456&key=API_KEY",
          "rating": 4.5,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.5
        }
      ]
    },
    "schools_and_education": {
      "radius_miles": 2.0,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Mountain View Elementary",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=school123&key=API_KEY",
          "rating": 4.1,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.8
        }
      ]
    },
    "transit_access": {
      "radius_miles": 0.75,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Mountain View Transit Center",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=transit456&key=API_KEY",
          "rating": 3.8,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.6
        }
      ]
    },
    "retail_and_shopping": {
      "radius_miles": 1.5,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Google Store",
          "address": "Mountain View, CA", 
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=shop789&key=API_KEY",
          "rating": 4.3,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.2
        }
      ]
    },
    "recreational_and_entertainment": {
      "radius_miles": 2.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Shoreline Amphitheatre",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=rec123&key=API_KEY",
          "rating": 4.4,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 1.2
        }
      ]
    },
    "sports_and_fitness": {
      "radius_miles": 1.5,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "24 Hour Fitness",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=gym456&key=API_KEY",
          "rating": 3.9,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.7
        }
      ]
    },
    "medical_care_access": {
      "radius_miles": 3.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "El Camino Hospital",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=med789&key=API_KEY",
          "rating": 4.0,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 2.1
        }
      ]
    },
    "daily_errands": {
      "radius_miles": 1.0,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Safeway",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=store123&key=API_KEY",
          "rating": 4.1,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.4
        }
      ]
    },
    "green_spaces": {
      "radius_miles": 1.5,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Rengstorff Community Center Park",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=park456&key=API_KEY",
          "rating": 4.2,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.9
        }
      ]
    },
    "neighborhood_safety": {
      "radius_miles": 1.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Mountain View Police Department",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=safety789&key=API_KEY",
          "rating": 4.0,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 1.1
        }
      ]
    }
  }
}

​
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"
              }
            }
          ]
        }
      },
      {
        "id": "lifestyle_amenities",
        "data": {
          "name": "Lifestyle Amenities",
          "score": 8.2,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Rich dining and entertainment options nearby",
          "loka_tip": "Consider the variety of local amenities for daily convenience",
          "blurb": "Evaluates dining, shopping, recreation, nightlife, arts & culture, and sports facilities to assess lifestyle quality and entertainment options.",
          "submetrics": [
            {
              "id": "dining_options",
              "data": {
                "name": "Dining Options",
                "score": 8.5,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Excellent variety of restaurants and cafes within walking distance.",
                "info": "Determined by restaurant density, cuisine variety, and ratings within a 1.0-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "environment_and_surroundings",
        "data": {
          "name": "Environment and Surroundings", 
          "score": 7.1,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Good air quality with adequate green spaces",
          "loka_tip": "Air quality scores are consistently good for outdoor activities",
          "blurb": "Analyzes environmental quality, green spaces, air quality, noise levels, and disaster safety for overall environmental health.",
          "submetrics": [
            {
              "id": "air_quality",
              "data": {
                "name": "Air Quality",
                "score": 7.8,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 2.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Good air quality with low pollution levels.",
                "info": "Based on EPA air quality measurements and pollution monitoring data.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "essential_services",
        "data": {
          "name": "Essential Services",
          "score": 8.0,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Strong educational and healthcare access",
          "loka_tip": "Schools and medical facilities are easily accessible",
          "blurb": "Covers education, healthcare, daily errands, waste management, and EV charging infrastructure for essential daily needs.",
          "submetrics": [
            {
              "id": "schools_and_education",
              "data": {
                "name": "Schools and Education",
                "score": 8.3,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 2.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "High-quality schools with good ratings nearby.",
                "info": "Based on school ratings, diversity of educational options, and accessibility within a 2.0-mile radius.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      },
      {
        "id": "safety_and_community",
        "data": {
          "name": "Safety and Community",
          "score": 7.9,
          "score_range": {
            "min": 0,
            "max": 10
          },
          "insight": "Safe neighborhood with good community feel",
          "loka_tip": "Low crime rates and strong community engagement",
          "blurb": "Assesses neighborhood safety, community engagement, pet amenities, and connectivity for overall quality of life.",
          "submetrics": [
            {
              "id": "neighborhood_safety",
              "data": {
                "name": "Neighborhood Safety",
                "score": 8.1,
                "score_range": {
                  "min": 0,
                  "max": 10
                },
                "location_radius_miles": 1.0,
                "time_window": {
                  "value": 30,
                  "unit": "days"
                },
                "description": "Very safe area with low crime rates.",
                "info": "Based on crime statistics, police presence, and community safety measures.",
                "source": "FindLoka Proprietary AI models"
              }
            }
          ]
        }
      }
    ]
  },
  "places_of_interest": {
    "restaurants_cafes_diners": {
      "radius_miles": 1.0,
      "counts": {
        "total": 3
      },
      "items": [
        {
          "name": "Blue Bottle Coffee",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=abc123&key=API_KEY",
          "rating": 4.2,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.3
        },
        {
          "name": "Local Bistro",
          "address": "1650 Amphitheatre Pkwy, Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=def456&key=API_KEY",
          "rating": 4.5,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.5
        }
      ]
    },
    "schools_and_education": {
      "radius_miles": 2.0,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Mountain View Elementary",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=school123&key=API_KEY",
          "rating": 4.1,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.8
        }
      ]
    },
    "transit_access": {
      "radius_miles": 0.75,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Mountain View Transit Center",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=transit456&key=API_KEY",
          "rating": 3.8,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.6
        }
      ]
    },
    "retail_and_shopping": {
      "radius_miles": 1.5,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Google Store",
          "address": "Mountain View, CA", 
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=shop789&key=API_KEY",
          "rating": 4.3,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.2
        }
      ]
    },
    "recreational_and_entertainment": {
      "radius_miles": 2.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Shoreline Amphitheatre",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=rec123&key=API_KEY",
          "rating": 4.4,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 1.2
        }
      ]
    },
    "sports_and_fitness": {
      "radius_miles": 1.5,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "24 Hour Fitness",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=gym456&key=API_KEY",
          "rating": 3.9,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.7
        }
      ]
    },
    "medical_care_access": {
      "radius_miles": 3.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "El Camino Hospital",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=med789&key=API_KEY",
          "rating": 4.0,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 2.1
        }
      ]
    },
    "daily_errands": {
      "radius_miles": 1.0,
      "counts": {
        "total": 2
      },
      "items": [
        {
          "name": "Safeway",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=store123&key=API_KEY",
          "rating": 4.1,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.4
        }
      ]
    },
    "green_spaces": {
      "radius_miles": 1.5,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Rengstorff Community Center Park",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=park456&key=API_KEY",
          "rating": 4.2,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 0.9
        }
      ]
    },
    "neighborhood_safety": {
      "radius_miles": 1.0,
      "counts": {
        "total": 1
      },
      "items": [
        {
          "name": "Mountain View Police Department",
          "address": "Mountain View, CA",
          "photo_url": "https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=safety789&key=API_KEY",
          "rating": 4.0,
          "rating_range": {
            "min": 0,
            "max": 5
          },
          "distance_miles": 1.1
        }
      ]
    }
  }
}

​
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

​
Places of Interest

  • places_of_interest: Detailed information about nearby amenities and services, organized into 10 categories:
    • Each category includes radius_miles, total counts, and up to 5 top-rated places
    • Individual place objects contain name, address, photo_url, rating (0-5), and distance_miles
    • Categories: restaurants/cafes/diners, schools/education, transit access, retail/shopping, recreational/entertainment, sports/fitness, medical care, daily errands, green spaces, and neighborhood safety

​
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)
  • Places of interest ratings range from 0-5 (Google Places rating system)
  • Higher scores indicate better performance
  • Descriptions are contextual based on score level (high ≥ 7, medium ≥ 4, low < 4)
  • Each places_of_interest category returns up to 5 top-rated places within the specified radius
  • Place objects include photo URLs, ratings, and calculated distances from the property
  • The address must exist in the FindLoka database with pre-calculated analytics
  • Make sure to URL-encode query parameters when making requests