> ## 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.

# Ideological Lean Score

> Derived from US Census Bureau data and voting records. The score runs
from 1 (predominantly conservative) through 128 (evenly split) to 255
(predominantly liberal). A score of 0 means no data is available for
the location.



## OpenAPI

````yaml /openapi.json get /demographics/ideological-lean
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/ideological-lean:
    get:
      tags:
        - Demographics
      summary: Ideological Lean Score
      description: |-
        Derived from US Census Bureau data and voting records. The score runs
        from 1 (predominantly conservative) through 128 (evenly split) to 255
        (predominantly liberal). A score of 0 means no data is available for
        the location.
      operationId: ihuus_demographics_ideological_lean
      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/IdeologicalLeanResponse'
        '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:
    IdeologicalLeanResponse:
      properties:
        result:
          $ref: '#/components/schemas/IdeologicalLeanResult'
          description: >-
            The Ideological Lean result. A score of 0 means no Census or voting
            data is available for the given coordinates.
      type: object
      required:
        - result
      title: IdeologicalLeanResponse
      description: API response for an Ideological Lean lookup.
      examples:
        - result:
            description: 'Largely liberal: liberal majority with a modest opposing presence.'
            score: 168
    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
    IdeologicalLeanResult:
      properties:
        score:
          type: integer
          title: Score
          description: >-
            Ideological Lean score (0-255). Derived from US Census Bureau data
            and voting records. Scores toward 1 indicate a predominantly
            conservative area; scores toward 255 indicate a predominantly
            liberal area; 128 represents an even split. 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: IdeologicalLeanResult
      description: Ideological Lean score for a location.
      examples:
        - description: 'Largely liberal: liberal majority with a modest opposing presence.'
          score: 168
    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>``.'

````