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

# Location Search

> Search by latitude/longitude with an optional radius in miles. By default, nearby searches exclude parcels without assigned addresses unless you explicitly set `includeUnassignedAddress=true`.



## OpenAPI

````yaml /api-reference/openapi.json get /public/property/location/
openapi: 3.1.0
info:
  title: Property Data API
  description: API for looking up property details by address and unit number.
  version: 1.0.0
servers:
  - url: https://app.realie.ai/api
security: []
paths:
  /public/property/location/:
    get:
      tags:
        - Property
      summary: Location Search
      description: >-
        Search by latitude/longitude with an optional radius in miles. By
        default, nearby searches exclude parcels without assigned addresses
        unless you explicitly set `includeUnassignedAddress=true`.
      operationId: locationSearch
      parameters:
        - name: longitude
          in: query
          required: true
          schema:
            type: number
            format: float
          description: The longitude coordinate of the center point for the search.
        - name: latitude
          in: query
          required: true
          schema:
            type: number
            format: float
          description: The latitude coordinate of the center point for the search.
        - name: radius
          in: query
          required: false
          schema:
            type: number
            format: float
            minimum: 0
            maximum: 2
            default: 1
          description: >-
            The radius in miles to search from the center point. Maximum value
            is 2 miles.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
          description: Maximum number of results to return. Defaults to 10, maximum is 100.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
          description: Number of records to skip. Defaults to 0.
        - name: residential
          in: query
          required: false
          schema:
            type: boolean
          description: >-
            Filter for residential properties only. If true, returns only
            residential properties. If false, returns only non-residential
            properties.
        - name: includeUnassignedAddress
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: >-
            If true, include nearby parcels that do not yet have an assigned
            address. By default, null or blank addresses are excluded.
      responses:
        '200':
          description: Properties found successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  properties:
                    type: array
                    description: Array of properties found within the specified radius.
                    items:
                      type: object
                  metadata:
                    type: object
                    properties:
                      limit:
                        type: integer
                        description: Limit value applied to the request
                      offset:
                        type: integer
                        description: Number of records skipped
                      count:
                        type: integer
                        description: Number of records found
                      searchCenter:
                        type: object
                        properties:
                          longitude:
                            type: number
                            description: The longitude of the search center point
                          latitude:
                            type: number
                            description: The latitude of the search center point
                      radiusMiles:
                        type: number
                        description: The radius in miles used for the search
                      includeUnassignedAddress:
                        type: boolean
                        description: >-
                          Whether parcels without assigned addresses were
                          included in the search
        '400':
          description: Bad Request - Missing or invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: >-
                      Bad Request: longitude, latitude, and radius must be valid
                      numbers
        '401':
          description: Unauthorized - Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: 'Unauthorized: API key is missing'
        '403':
          description: Forbidden - Usage limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: 'Forbidden: Usage limit exceeded'
        '404':
          description: Not Found - No properties found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: No properties found
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Description of the error that occurred.
                    example: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      name: Authorization
      in: header
      description: Provide your API key directly in the header.

````