RealEstateAPI

naftiko: 1.0.0-alpha2
info:
  label: RealEstateAPI
  description: RealEstateAPI.com provides expressive property data APIs for prop-tech applications. Endpoints include property
    search, property detail, comparables, AVM (automated valuation), parcel boundary lookups, MLS data, skip tracing, and
    involuntary lien data. All endpoints accept JSON and require an x-api-key header.
  tags:
  - Realestateapi
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: realestateapi
    baseUri: https://api.realestateapi.com
    description: RealEstateAPI HTTP API.
    authentication:
      type: apikey
      in: header
      name: x-api-key
      value: '{{REALESTATEAPI_TOKEN}}'
    resources:
    - name: v2-propertysearch
      path: /v2/PropertySearch
      operations:
      - name: post-v2-propertysearch
        method: POST
        description: Search properties
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-propertydetail
      path: /v2/PropertyDetail
      operations:
      - name: post-v2-propertydetail
        method: POST
        description: Get a detailed property record
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-propertycomps
      path: /v2/PropertyComps
      operations:
      - name: post-v2-propertycomps
        method: POST
        description: Retrieve comparable properties
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-avm
      path: /v2/AVM
      operations:
      - name: post-v2-avm
        method: POST
        description: Automated valuation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-propertyboundary
      path: /v2/PropertyBoundary
      operations:
      - name: post-v2-propertyboundary
        method: POST
        description: Retrieve a property's parcel boundary (GeoJSON)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-mlssearch
      path: /v2/MLSSearch
      operations:
      - name: post-v2-mlssearch
        method: POST
        description: Search MLS active and historical listings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-mlsdetail
      path: /v2/MLSDetail
      operations:
      - name: post-v2-mlsdetail
        method: POST
        description: Retrieve MLS listing detail
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-skiptrace
      path: /v2/SkipTrace
      operations:
      - name: post-v2-skiptrace
        method: POST
        description: Skip trace an owner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-involuntaryliens
      path: /v2/InvoluntaryLiens
      operations:
      - name: post-v2-involuntaryliens
        method: POST
        description: Search involuntary liens
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: realestateapi-rest
    description: REST adapter for RealEstateAPI.
    resources:
    - path: /v2/PropertySearch
      name: post-v2-propertysearch
      operations:
      - method: POST
        name: post-v2-propertysearch
        description: Search properties
        call: realestateapi.post-v2-propertysearch
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/PropertyDetail
      name: post-v2-propertydetail
      operations:
      - method: POST
        name: post-v2-propertydetail
        description: Get a detailed property record
        call: realestateapi.post-v2-propertydetail
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/PropertyComps
      name: post-v2-propertycomps
      operations:
      - method: POST
        name: post-v2-propertycomps
        description: Retrieve comparable properties
        call: realestateapi.post-v2-propertycomps
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/AVM
      name: post-v2-avm
      operations:
      - method: POST
        name: post-v2-avm
        description: Automated valuation
        call: realestateapi.post-v2-avm
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/PropertyBoundary
      name: post-v2-propertyboundary
      operations:
      - method: POST
        name: post-v2-propertyboundary
        description: Retrieve a property's parcel boundary (GeoJSON)
        call: realestateapi.post-v2-propertyboundary
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/MLSSearch
      name: post-v2-mlssearch
      operations:
      - method: POST
        name: post-v2-mlssearch
        description: Search MLS active and historical listings
        call: realestateapi.post-v2-mlssearch
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/MLSDetail
      name: post-v2-mlsdetail
      operations:
      - method: POST
        name: post-v2-mlsdetail
        description: Retrieve MLS listing detail
        call: realestateapi.post-v2-mlsdetail
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/SkipTrace
      name: post-v2-skiptrace
      operations:
      - method: POST
        name: post-v2-skiptrace
        description: Skip trace an owner
        call: realestateapi.post-v2-skiptrace
        outputParameters:
        - type: object
          mapping: $.
    - path: /v2/InvoluntaryLiens
      name: post-v2-involuntaryliens
      operations:
      - method: POST
        name: post-v2-involuntaryliens
        description: Search involuntary liens
        call: realestateapi.post-v2-involuntaryliens
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: realestateapi-mcp
    transport: http
    description: MCP adapter for RealEstateAPI for AI agent use.
    tools:
    - name: post-v2-propertysearch
      description: Search properties
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-propertysearch
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-propertydetail
      description: Get a detailed property record
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-propertydetail
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-propertycomps
      description: Retrieve comparable properties
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-propertycomps
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-avm
      description: Automated valuation
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-avm
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-propertyboundary
      description: Retrieve a property's parcel boundary (GeoJSON)
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-propertyboundary
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-mlssearch
      description: Search MLS active and historical listings
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-mlssearch
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-mlsdetail
      description: Retrieve MLS listing detail
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-mlsdetail
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-skiptrace
      description: Skip trace an owner
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-skiptrace
      outputParameters:
      - type: object
        mapping: $.
    - name: post-v2-involuntaryliens
      description: Search involuntary liens
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: realestateapi.post-v2-involuntaryliens
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    REALESTATEAPI_TOKEN: REALESTATEAPI_TOKEN