> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ihuus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Population Age Profile

> Derived from the most recent US Census Bureau data. Scores range from
1 (predominantly young adults aged 20-34, few children or seniors) to
255 (predominantly senior, strong 65+ population and high median age).
128 represents a balanced age mix across young adults, families, and
older residents. A score of 0 means no data is available.



## OpenAPI

````yaml /openapi.json get /demographics/population-profile
openapi: 3.1.0
info:
  title: Neighborhood Intelligence API
  description: >-
    High-performance geospatial API for neighborhood-level intelligence. Covers
    K-12 school search and four scored dimension groups: Vibe (privacy,
    walkability, visual appeal, dog friendliness, urban-rural character,
    liveliness), Environment (acoustic comfort, air quality, industrial
    proximity), Demographics (health insurance coverage, ideological lean,
    population age profile), and Risk (flood and fire hazard).
  contact:
    name: iHuus, Inc.
    url: https://ihuus.com/
  version: 0.1.0
servers:
  - url: https://api.ihuus.com/v1
    description: iHuus API v1
security:
  - BearerAuth: []
tags:
  - name: Schools & Ratings
    description: >-
      Search for K-12 schools by geographic coordinates. Results include
      distance, school level, district information, demographics, and
      performance metrics where available.
  - name: Vibe
    description: >-
      Neighborhood vibe dimension scores. Each endpoint returns a 0-255 score
      for a single dimension (privacy, walkability, visual appeal, dog
      friendliness, urban-rural character) along with a semantic description.
  - name: Environment
    description: >-
      Environment dimension scores (0-255). Includes composite noise levels, air
      quality, and other environmental factors accompanied by detailed source
      breakdowns.
  - name: Demographics
    description: >-
      Demographic dimension scores (0-255) derived from US Census Bureau data.
      Includes health insurance coverage and other population-level indicators.
  - name: Risk
    description: >-
      Risk dimension scores (0-255). Covers natural hazard exposure including
      flood and fire risk, derived from FEMA and other authoritative hazard
      datasets. Lower scores indicate higher risk.
  - name: Tools
    description: >-
      Auxiliary tools for processing data and agent assistance, such as
      geocoding addresses into geospatial coordinates.
paths:
  /demographics/population-profile:
    get:
      tags:
        - Demographics
      summary: Population Age Profile
      description: |-
        Derived from the most recent US Census Bureau data. Scores range from
        1 (predominantly young adults aged 20-34, few children or seniors) to
        255 (predominantly senior, strong 65+ population and high median age).
        128 represents a balanced age mix across young adults, families, and
        older residents. A score of 0 means no data is available.
      operationId: ihuus_demographics_population_profile
      parameters:
        - name: lat
          in: query
          required: true
          schema:
            type: number
            maximum: 90
            minimum: -90
            title: Lat
            description: >-
              The latitude of the location in decimal degrees (WGS 84). Must be
              between -90 and 90.
          description: >-
            The latitude of the location in decimal degrees (WGS 84). Must be
            between -90 and 90.
        - name: lon
          in: query
          required: true
          schema:
            type: number
            maximum: 180
            minimum: -180
            title: Lon
            description: >-
              The longitude of the location in decimal degrees (WGS 84). Must be
              between -180 and 180.
          description: >-
            The longitude of the location in decimal degrees (WGS 84). Must be
            between -180 and 180.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PopulationProfileResponse'
        '401':
          description: Unauthorized — API key is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: Too Many Requests — rate limit or monthly quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    PopulationProfileResponse:
      properties:
        result:
          $ref: '#/components/schemas/PopulationProfileResult'
          description: >-
            The Population Age Profile result. A score of 0 means no Census data
            is available for the given coordinates.
      type: object
      required:
        - result
      title: PopulationProfileResponse
      description: API response for a Population Age Profile lookup.
      examples:
        - result:
            description: >-
              Mixed: balanced spread of young adults, families, and older
              residents.
            score: 108
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message.
      required:
        - detail
      title: ErrorResponse
      description: >-
        Standard error response returned on authentication failure and
        rate-limit violations.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PopulationProfileResult:
      properties:
        score:
          type: integer
          title: Score
          description: >-
            Population Age Profile score (0-255). Derived from the most recent
            US Census Bureau data. Lower scores indicate a younger-skewing area
            dominated by young adults (20-34); higher scores indicate a
            senior-skewing area with a strong 65+ population and high median
            age. 128 represents a balanced age mix. 0 means no data is
            available.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: >-
            A short human-readable narrative explaining the score and the key
            factors that influenced it at this location.
      type: object
      required:
        - score
      title: PopulationProfileResult
      description: Population Age Profile score for a location.
      examples:
        - description: >-
            Mixed: balanced spread of young adults, families, and older
            residents.
          score: 108
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Your access token or API key. Pass as ``Authorization: Bearer <token>``.'

````