Houski Property Data

Property data for 220M+ homes in North America, Europe and South Korea: search, stats and values.

使うべきか

品質と安全性

A
説明の品質
93%
スキーマの完全性
99%
命名の品質
85%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(2)

  • LOWTool 'avm_endpoint' has short descriptionavm_endpoint 内
  • LOWTool 'avm_endpoint' description lacks action verbavm_endpoint 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~6,881トークン数(ツール定義)
~5.9 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 5.38%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "property-data": {
      "url": "https://www.houski.ca/mcp"
    }
  }
}

リモートエンドポイント

https://www.houski.ca/mcpstreamable-http

できること

ツール一覧

ツール(12)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢aggregate_endpoint(aggregation, aggregations, api_key, bbox_ne_lat, bbox_ne_lng, ...)

Get statistical aggregations for market analysis. Billed per aggregation returned. Aggregations: count, sum, mean, median, mode, min, max, quantile-10, quantile-25, quantile-40, quantile-60, quantile-75, quantile-80, quantile-85, quantile-90, quantile-95, quantile-99. Text and boolean fields only support count and mode, and only fields field_detail marks aggregatable are accepted. count counts the properties that hold a value for the field, so a count per country measures how well a field is covered there. Ask for several statistics in one call with the aggregations array instead of one call each. Every statistic must name exactly one country, with country_abbreviation, or something narrower inside one country, on the call or on its own entry, and different entries may name different countries. A bounding box or a polygon alone is not enough, and a call with a statistic that names no place, or more than one country, is refused with a 400.

入力スキーマ

{
  "type": "object",
  "properties": {
    "aggregation": {
      "description": "Aggregation type for the single-statistic form: count, sum, mean, median, mode, min, max, quantile-10, quantile-25, quantile-40, quantile-60, quantile-75, quantile-80, quantile-85, quantile-90, quantile-95 or quantile-99. Those quantiles are the only ones that exist.",
      "type": [
        "string",
        "null"
      ]
    },
    "aggregations": {
      "description": "Several statistics in one request, instead of one call each. Each entry gets its own field and aggregation, and inherits this call's location and filters unless it sets its own. Do not also set field.",
      "items": {
        "$ref": "#/$defs/AggregateRequest"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "bbox_ne_lat": {
      "description": "Bounding box northeast latitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_ne_lng": {
      "description": "Bounding box northeast longitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lat": {
      "description": "Bounding box southwest latitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lng": {
      "description": "Bounding box southwest longitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "city": {
      "description": "City name. Requires country_abbreviation and province_abbreviation, and the request is refused with a 400 error if either is missing.",
      "type": [
        "string",
        "null"
      ]
    },
    "community": {
      "description": "Community/neighborhood name. Requires country_abbreviation, province_abbreviation and city.",
      "type": [
        "string",
        "null"
      ]
    },
    "country_abbreviation": {
      "description": "Country abbreviation as location_endpoint returns it (for example \"CA\"). Any letter case is accepted. Every statistic needs a place, so pass it here or on each entry of aggregations.",
      "type": [
        "string",
        "null"
      ]
    },
    "exclude": {
      "description": "Source classes to leave out of the aggregation, comma separated: \"inferred\" leaves out every value Houski worked out, and \"inferred,observed\" keeps only values from a linked public record. Applies to a field with a source column, and the answer's values_used counts the values each statistic used. In the aggregations form every entry inherits it unless it sets its own.",
      "type": [
        "string",
        "null"
      ]
    },
    "field": {
      "description": "Field to aggregate for a single statistic. Use field_list to discover available fields. Leave this out when using aggregations.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Filters array. Format: \"field_operator=value\", with the value as plain text and not URL encoded. Use search_api_documentation for reference.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "polygon": {
      "description": "Polygon coordinates \"lat_lng,lat_lng,lat_lng\", latitude and longitude joined by an underscore. Maximum 100 points, simplify a shape that has more.",
      "type": [
        "string",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "province_abbreviation": {
      "description": "Province, state or region abbreviation as location_endpoint returns it (for example \"AB\"). Requires country_abbreviation.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key"
  ],
  "$defs": {
    "AggregateRequest": {
      "description": "One statistic inside an aggregate_endpoint batch.",
      "properties": {
        "aggregation": {
          "description": "Aggregation type: count, sum, mean, median, mode, min, max, or quantile-10 through quantile-99 from the fixed list. Text and boolean fields only support count and mode.",
          "type": "string"
        },
        "city": {
          "description": "City for this statistic only, which is how you compare two cities in one request. Defaults to the call's city.",
          "type": [
            "string",
            "null"
          ]
        },
        "community": {
          "description": "Community for this statistic only. Defaults to the call's community.",
          "type": [
            "string",
            "null"
          ]
        },
        "country_abbreviation": {
          "description": "Country abbreviation for this statistic only. Defaults to the call's country_abbreviation.",
          "type": [
            "string",
            "null"
          ]
        },
        "exclude": {
          "description": "Source classes to leave out of this statistic only, such as \"inferred\". Defaults to the call's exclude.",
          "type": [
            "string",
            "null"
          ]
        },
        "field": {
          "description": "Field to aggregate. Use field_list to discover available fields.",
          "type": "string"
        },
        "filters": {
          "description": "Extra filters for this statistic only. These are applied on top of the call's filters.",
          "items": {
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "province_abbreviation": {
          "description": "Province/state abbreviation for this statistic only. Defaults to the call's province_abbreviation.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "field",
        "aggregation"
      ],
      "type": "object"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auth_endpoint(api_key)

Check that an API key exists and is enabled. Does not bill per call. Returns api_key_authorized boolean. It does not check the key's maximum monthly spend or the unlimited plan's daily allowance, so another tool can still refuse a key that passes here.

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key to validate",
      "type": "string"
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
⚪avm_endpoint(api_key, overrides, price_quote, property_id)

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "overrides": {
      "anyOf": [
        {
          "$ref": "#/$defs/ScenarioOverrides"
        },
        {
          "type": "null"
        }
      ],
      "description": "What-if changes to the property before valuing it, for scenario testing (a finished basement, an extra bathroom). Anything left out keeps the property's real value."
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "property_id": {
      "description": "Property ID, one per call. Every call is billed at the price in this tool's description.",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "property_id"
  ],
  "$defs": {
    "ScenarioOverrides": {
      "description": "What-if property changes accepted by both /avm and /predict.",
      "properties": {
        "bathroom_full": {
          "description": "Full bathroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "bathroom_half": {
          "description": "Half bathroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "bedroom": {
          "description": "Bedroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "construction_year": {
          "description": "Year the property was built",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "den": {
          "description": "Den count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "garage_type_first": {
          "description": "Garage type. Use field_detail on garage_type_first for accepted values.",
          "type": [
            "string",
            "null"
          ]
        },
        "interior_sq_m": {
          "description": "Interior size in square metres",
          "format": "float",
          "type": [
            "number",
            "null"
          ]
        },
        "maintenance_fee": {
          "description": "Monthly maintenance or condo fee",
          "format": "float",
          "type": [
            "number",
            "null"
          ]
        },
        "property_type": {
          "description": "Property type. Use field_detail on property_type for accepted values.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡field_detail(fields)

Describe fields by name: type, accepted filter values, its source column if it has one, filtered, aggregated or predicted, which expand set it belongs to, its price per home returned, and its full description. Does not bill per call. Coverage differs by country, and the server instructions say how to check it cheaply with location_endpoint.

入力スキーマ

{
  "type": "object",
  "properties": {
    "fields": {
      "description": "Comma-separated list of field names to get details for",
      "type": "string"
    }
  },
  "required": [
    "fields"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡field_list(filter)

List the name of every public property data field, one per line. Does not bill per call. Pass filter to list only the names that contain a piece of text, for example score_, demographic_, assessment, permit or expand_listing. Follow with field_detail for each field's type, accepted filter values, aggregation support, expand set and price per value returned.

入力スキーマ

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Optional text to match inside field names, for example \"score_\", \"demographic_\", \"assessment\", \"permit\" or \"expand_listing\". Leave it out to list every field.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡geocoding_endpoint(api_key, exclude, expand, filter_expand_match, filters, ...)

Find properties near coordinates (reverse geocoding). Billed per field, per home returned. Required: latitude, longitude. Optional: radius (km), shape (circle/square). This endpoint has no country, province, city, community or address parameters. To narrow by place, put filters such as country_abbreviation_eq=CA or city_eq=Calgary in filters, spelled exactly as location_endpoint returns them, letter case included. With no such filter the point and radius may cover no more homes than one country holds, and a filter that names more than one country is refused with a 400. For active or marketable properties, add has_expand_listings_eq=true to filters, which is far cheaper than expanding listings just to filter on their presence.

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "exclude": {
      "description": "Source classes to leave out, comma separated, such as \"inferred\" or \"inferred,observed\". Checks the selected fields that have a source column, keeps a property when one of them keeps its value, and empties the rest.",
      "type": [
        "string",
        "null"
      ]
    },
    "expand": {
      "description": "Comma-separated. Values: \"listings\", \"listings_rent\", \"permits\", \"assessments\". Each attached record is a flat charge. To filter to properties that HAVE a set, use the has_expand_* boolean filters instead.",
      "type": [
        "string",
        "null"
      ]
    },
    "filter_expand_match": {
      "description": "\"any\" or \"all\". Use only when filtering on values inside expanded records.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Filters array. Format: \"field_operator=value\", with the value as plain text and not URL encoded. Use search_api_documentation for reference.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "latitude": {
      "description": "Center latitude (e.g., 51.0447)",
      "format": "double",
      "type": "number"
    },
    "longitude": {
      "description": "Center longitude (e.g., -114.0719)",
      "format": "double",
      "type": "number"
    },
    "page": {
      "description": "Page number for pagination",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "radius": {
      "description": "Search radius in kilometers",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "results_per_page": {
      "description": "Results per page",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "select": {
      "description": "Comma-separated fields to return, or \"all\"",
      "type": [
        "string",
        "null"
      ]
    },
    "shape": {
      "description": "Search shape: \"circle\" (default) or \"square\"",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key",
    "latitude",
    "longitude"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢location_endpoint(api_key, city, community, country_abbreviation, filters, ...)

Get the places Houski holds property data for, as a hierarchy of countries, provinces (or states or regions), cities and communities, with links and slugs. Billed per location returned, a small fraction of a cent each. This is the source of every country_abbreviation, province_abbreviation, city and community the other tools take. There is no paging and every matching location comes back, so scope every call: resolution=country and resolution=province are small, while resolution=city or community with no country_abbreviation and province_abbreviation returns every city of every country in one very large response. Naming a level requires naming its parents, and the endpoint returns a 400 saying so if you skip one. filters keeps only the places where at least one property matches, which is the cheapest way to check coverage. A call with filters must name exactly one country, with country_abbreviation, or something narrower inside one country, or it is refused with a 400: country_abbreviation=ca with resolution=country and filters=["parcel_number_regex=."] returns Canada only when it holds parcel numbers. Several countries take one call each. A call with no filters needs no place.

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "city": {
      "description": "City name. Requires country_abbreviation and province_abbreviation, and the endpoint returns a 400 if either is missing.",
      "type": [
        "string",
        "null"
      ]
    },
    "community": {
      "description": "Community/neighborhood name. Requires country_abbreviation, province_abbreviation and city, and the endpoint returns a 400 if any is missing.",
      "type": [
        "string",
        "null"
      ]
    },
    "country_abbreviation": {
      "description": "Country abbreviation (for example \"CA\"). Pass it with province_abbreviation on anything finer than resolution=province, or the response covers the whole country.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Filters that keep only the locations holding at least one matching property, in the \"field_operator=value\" form. \"<field>_regex=.\" keeps the places where some property has a value for that field, which is how to check a field's coverage by country or region. A call with filters must also name exactly one country, with country_abbreviation, or something narrower inside one country, so several countries take one call each.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "flat": {
      "description": "Return flat format instead of nested (default: false). Flat is roughly four times larger, because each row repeats the whole country and province block instead of nesting under it, and carries a null key for every level below the resolution. Prefer nested unless you specifically want one row per location.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "province_abbreviation": {
      "description": "Province, state or region abbreviation (for example \"AB\"). Requires country_abbreviation. The two together keep a resolution=city call to one province instead of every city of the country.",
      "type": [
        "string",
        "null"
      ]
    },
    "resolution": {
      "description": "Depth: \"country\", \"province\", \"city\", or \"community\" (default). This is the main size lever. With no country_abbreviation and province_abbreviation, stay on \"country\" or \"province\".",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡map_endpoint(abort_over, api_key, bbox_ne_lat, bbox_ne_lng, bbox_sw_lat, ...)

Get map data: pins, clusters, or heatmaps. Billed per cluster or heatmap cell returned, or per field, per home returned for pins. Scope it with all four bbox coordinates or a polygon. With no place filter, the box or polygon may cover no more homes than one country holds. A call with neither must carry a filter on one country, such as country_abbreviation_eq=CA, or on a narrower place inside one country. A call that names no place, covers more than one country's homes, or filters on more than one country is refused with a 400, so several countries take one call each. A heatmap needs all four bbox coordinates, and a heatmap scoped by a polygon alone is refused. Modes: cluster=true, heatmap=true. There is no cap on how many properties a request may match, so set abort_over yourself if you want a request to give up past a certain number. For maps of active inventory, add has_expand_listings_eq=true to filters so listing-less parcels don't pad results.

入力スキーマ

{
  "type": "object",
  "properties": {
    "abort_over": {
      "description": "Abort if results exceed this count (cost protection)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "bbox_ne_lat": {
      "description": "Bounding box northeast latitude",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_ne_lng": {
      "description": "Bounding box northeast longitude",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lat": {
      "description": "Bounding box southwest latitude",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lng": {
      "description": "Bounding box southwest longitude",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "cluster": {
      "description": "Force clustering (default: false)",
      "type": [
        "boolean",
        "null"
      ]
    },
    "cluster_over": {
      "description": "Auto-cluster when results exceed this count",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "exclude": {
      "description": "Source classes to leave out, comma separated, such as \"inferred\" or \"inferred,observed\". Checks the selected fields that have a source column and the heatmap field, and a heatmap of a field uses only the kept values (heatmap_values_used counts them).",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Filters array. Format: \"field_operator=value\", with the value as plain text and not URL encoded. Use search_api_documentation for reference.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "heatmap": {
      "description": "Enable heatmap mode (default: false)",
      "type": [
        "boolean",
        "null"
      ]
    },
    "heatmap_aggregation_field": {
      "description": "Field for heatmap intensity (e.g., \"estimate_list_price\"). Without this, uses density.",
      "type": [
        "string",
        "null"
      ]
    },
    "heatmap_aggregation_invert_intensity": {
      "description": "Invert intensity (true = lower values show higher intensity, good for affordability)",
      "type": [
        "boolean",
        "null"
      ]
    },
    "heatmap_aggregation_type": {
      "description": "Heatmap aggregation: \"mean\", \"median\", or \"sum\"",
      "type": [
        "string",
        "null"
      ]
    },
    "heatmap_cell_limit": {
      "description": "Max heatmap cells (default: 1000, max: 10000)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "page": {
      "description": "Page number for pagination, pins only (default: 1)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "polygon": {
      "description": "Polygon coordinates \"lat_lng,lat_lng,lat_lng\", an alternative to bbox for pins and clusters. A heatmap needs all four bbox values and is refused with a polygon alone.",
      "type": [
        "string",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "results_per_page": {
      "description": "Results per page (for pins only)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "select": {
      "description": "Comma-separated fields to return",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢predict_endpoint(api_key, fields, last, next, overrides, ...)

Predict property values over time. Billed per predicted field, once for each date and each property. Required: property_id, start_date, fields. Find the property_id first with search_endpoint or properties_endpoint. Supports batch requests and parameter overrides for scenario testing.

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "fields": {
      "description": "Fields to predict: \"estimate_sale_price\", \"estimate_list_price\", \"estimate_rent_monthly\"",
      "type": "string"
    },
    "last": {
      "description": "Periods before start_date to include. A range reaching before 2021-01-01 is refused",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "next": {
      "description": "Periods after start_date to include. A range reaching past today is refused, because the models do not forecast",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "overrides": {
      "anyOf": [
        {
          "$ref": "#/$defs/ScenarioOverrides"
        },
        {
          "type": "null"
        }
      ],
      "description": "What-if changes to the property before predicting, for scenario testing. Anything left out keeps the property's real value."
    },
    "period": {
      "description": "Time granularity: \"day\", \"week\", \"month\" (default), \"year\"",
      "type": [
        "string",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "property_id": {
      "description": "Property ID(s), comma-separated for batch requests",
      "type": "string"
    },
    "start_date": {
      "description": "Reference date in YYYY-MM-DD format, from 2021-01-01 to today",
      "type": "string"
    }
  },
  "required": [
    "api_key",
    "property_id",
    "fields",
    "start_date"
  ],
  "$defs": {
    "ScenarioOverrides": {
      "description": "What-if property changes accepted by both /avm and /predict.",
      "properties": {
        "bathroom_full": {
          "description": "Full bathroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "bathroom_half": {
          "description": "Half bathroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "bedroom": {
          "description": "Bedroom count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "construction_year": {
          "description": "Year the property was built",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "den": {
          "description": "Den count",
          "format": "uint16",
          "maximum": 65535,
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "garage_type_first": {
          "description": "Garage type. Use field_detail on garage_type_first for accepted values.",
          "type": [
            "string",
            "null"
          ]
        },
        "interior_sq_m": {
          "description": "Interior size in square metres",
          "format": "float",
          "type": [
            "number",
            "null"
          ]
        },
        "maintenance_fee": {
          "description": "Monthly maintenance or condo fee",
          "format": "float",
          "type": [
            "number",
            "null"
          ]
        },
        "property_type": {
          "description": "Property type. Use field_detail on property_type for accepted values.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡properties_endpoint(address, api_key, bbox_ne_lat, bbox_ne_lng, bbox_sw_lat, ...)

Retrieve property data (hundreds of fields) with filtering, sorting, and expansion. Billed per field, per home returned: each selected field's price for each home that has a value for it, so a field with no value for a home is not billed. Always set select= to limit fields. For comparables, 'good' properties, or active inventory, add has_expand_listings_eq=true to filters: a fast indexed boolean filter that excludes the long tail of listing-less parcels (use has_expand_listings_rent_eq=true for rentals). Use expand=listings,permits,assessments only when you actually need the related records, not just to filter on their existence (has_expand_permits_eq=true and has_expand_assessments_eq=true cover that). Take place names and abbreviations from location_endpoint. Every call must name exactly one country, with country_abbreviation, or something narrower inside one country, such as a province, a city, or a property_id_eq or property_id_in filter. A bounding box or a polygon alone is not enough, and a call that names no place, or more than one country, is refused with a 400. Several countries take one call each. When select names a field with a source column, pass exclude=inferred unless the user wants inferred values too or the call looks up one named property. Set price_quote=true first when the row count is unknown. See search_api_documentation for full filter syntax.

入力スキーマ

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Address for a single property lookup. Letter case and punctuation do not matter, but abbreviations are not rewritten, so write road types in full as the address field does (\"Place\", not \"Pl\"). Requires country_abbreviation, province_abbreviation and city. For fuzzy, abbreviated or partial addresses use search_endpoint instead.",
      "type": [
        "string",
        "null"
      ]
    },
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "bbox_ne_lat": {
      "description": "Bounding box northeast latitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_ne_lng": {
      "description": "Bounding box northeast longitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lat": {
      "description": "Bounding box southwest latitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "bbox_sw_lng": {
      "description": "Bounding box southwest longitude. All four bbox values are required together.",
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "city": {
      "description": "City name as location_endpoint returns it (for example \"Calgary\"). Letter case, accents and punctuation do not matter. Requires country_abbreviation and province_abbreviation, and the request is refused with a 400 error if either is missing.",
      "type": [
        "string",
        "null"
      ]
    },
    "community": {
      "description": "Community/neighborhood name. Letter case, accents and punctuation do not matter. Requires country_abbreviation, province_abbreviation and city, and the request is refused with a 400 error if any is missing.",
      "type": [
        "string",
        "null"
      ]
    },
    "community_in": {
      "description": "Several community names, comma separated. This is a plain filter on the community name, so it compares each name exactly, letter case included, and spelled as location_endpoint returns it. It needs no other location parameter, but without city it matches communities with those names in every city.",
      "type": [
        "string",
        "null"
      ]
    },
    "country_abbreviation": {
      "description": "Country abbreviation as location_endpoint returns it (for example \"CA\", \"US\", \"GB\" or \"KR\"). Any letter case is accepted. Pass it on every call that does not name a narrower place with a filter such as property_id_in, because a call that names no place is refused. A call covers one country, so several countries take one call each.",
      "type": [
        "string",
        "null"
      ]
    },
    "exclude": {
      "description": "Source classes to leave out, comma separated: \"inferred\" leaves out every value Houski worked out, and \"inferred,observed\" keeps only values from a linked public record. Checks the selected fields that have a source column (field_detail names it), keeps a property when one of them keeps its value, and empties the rest. search_api_documentation page filter lists every class.",
      "type": [
        "string",
        "null"
      ]
    },
    "expand": {
      "description": "Comma-separated. Values: \"listings\", \"listings_rent\", \"permits\", \"assessments\". Each attached record is a flat charge, so only include when you need the related records themselves. To filter to properties that HAVE a set, prefer the indexed boolean filters passed via `filters` (has_expand_listings_eq=true, has_expand_listings_rent_eq=true, has_expand_permits_eq=true, has_expand_assessments_eq=true) over expanding with `filter_expand_match=all`. They are far faster and cheaper.",
      "type": [
        "string",
        "null"
      ]
    },
    "filter_expand_match": {
      "description": "\"any\" or \"all\". Use this only when filtering on values inside expanded records (for example expand_permit_content_regex). To filter on mere presence of a set, use the has_expand_* boolean filters in `filters` instead.",
      "type": [
        "string",
        "null"
      ]
    },
    "filters": {
      "description": "Filters array. Format: \"field_operator=value\", with the value as plain text and not URL encoded. Operators: _eq, _neq, _gte, _lte, _gt, _lt, _in, _regex, _nregex (rows that do not match the regex). Text values compare exactly, letter case included (property_type_eq=House). To narrow to a place, use the country_abbreviation, province_abbreviation, city, community and address arguments, which ignore letter case, rather than filters such as city_eq. Use search_api_documentation for full reference.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "page": {
      "description": "Page number for pagination (default: 1)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "polygon": {
      "description": "Polygon coordinates \"lat_lng,lat_lng,lat_lng\", latitude and longitude joined by an underscore. Maximum 100 points, simplify a shape that has more.",
      "type": [
        "string",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "province_abbreviation": {
      "description": "Province, state or region abbreviation as location_endpoint returns it (for example \"AB\" in Canada). Any letter case is accepted. Requires country_abbreviation.",
      "type": [
        "string",
        "null"
      ]
    },
    "results_per_page": {
      "description": "Results per page (default: 6, max: 1000)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "select": {
      "description": "Comma-separated fields to return, or \"all\". Use field_list to discover fields.",
      "type": [
        "string",
        "null"
      ]
    },
    "sort_by": {
      "description": "Sort field. Format: \"field_sort=asc\" or \"field_sort=desc\"",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢search_api_documentation(page)

Access API documentation pages for filter syntax, field references, and endpoint details. Does not bill per call. Pass an unknown page to get the full list of pages back.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Documentation page to read, for example \"filter\", \"properties\" or \"pricing\". Pass an unknown value to get the full list of pages back in the error.",
      "type": "string"
    }
  },
  "required": [
    "page"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢search_endpoint(api_key, country_abbreviation, exclude, max_results, price_quote, ...)

Find property_id using fuzzy address matching. Billed per field, per home returned. Handles typos, abbreviations, partial addresses. Pass country_abbreviation to keep every match in one country. Use returned property_id with other endpoints for detailed data.

入力スキーマ

{
  "type": "object",
  "properties": {
    "api_key": {
      "description": "API key for authentication",
      "type": "string"
    },
    "country_abbreviation": {
      "description": "Only return matches from one country, by its country_abbreviation as location_endpoint returns it (for example \"GB\"). Default: every country. A query that names a province, a state, or a postal code already ranks its own country first.",
      "type": [
        "string",
        "null"
      ]
    },
    "exclude": {
      "description": "Source classes to leave out, comma separated, such as \"inferred\" or \"inferred,observed\". Checks the selected fields that have a source column, keeps a match when one of them keeps its value, and empties the rest.",
      "type": [
        "string",
        "null"
      ]
    },
    "max_results": {
      "description": "Max results (default: 10, max: 25)",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "price_quote": {
      "description": "Return the cost of this request without billing it or returning data",
      "type": [
        "boolean",
        "null"
      ]
    },
    "query": {
      "description": "Address query. Handles partial addresses, building names, typos. Include city for better accuracy.",
      "type": "string"
    },
    "select": {
      "description": "Comma-separated fields to return",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "api_key",
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 12 件