Server definition
- Hash
- sha256:b4bc42ee19394d41ba06080f83fa385cde72dc1cb7ee9d0b06a23b450f59fc68
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "Property data for Canada, the United States, Great Britain, Latvia, Slovenia, Czechia, France, Spain, the Netherlands, Finland, Poland, Norway, Switzerland, Estonia, Austria and South Korea: 220+ million properties, 400+ fields each. Each property is one home with its own address and property_id, so each flat in a building is its own row. Where a building's homes have no addresses of their own, the building is one row, a Duplex or Multiplex in property_type. Property data costs about $0.001 per value returned, plus $0.001 per nested row for each expand= set. A field with no value for a home is not billed, and every matching home is still returned. Endpoints that do not return property records are billed per thing returned instead: $0.01 per aggregate value, $0.001 per predicted value, $0.00001 per map cluster or heatmap cell, $0.00001 per location. Nothing is billed on how much data was searched, only on what comes back, so a filter across the whole country costs the same as one across a single street when the same amount is returned.\n\nStart with the tools that do not bill per call. field_list names every field, field_detail gives a field's type, accepted filter values, whether it can be sorted, filtered, aggregated or predicted, its expand set and its price per value returned, search_api_documentation reads the documentation pages, and auth_endpoint checks a key. Every billed tool takes price_quote=true, which returns what the call would cost without billing it or returning data.\n\nThree levers control both cost and answer quality:\n\n1. Narrow the columns: always set select= to only the fields you'll actually use.\n\n2. Narrow the rows to records with real signal. Many properties in the database are homes with little recorded data beyond their address. For comparables, market analysis, 'find me a property like X', or anything where the user expects active or marketable inventory, add has_expand_listings_eq=true (or has_expand_listings_rent_eq=true for rentals) to filters. These are indexed boolean filters on the property record itself, so they're far cheaper and faster than expanding listings just to drop empties with filter_expand_match=all. Skip them only when the user explicitly wants the full universe (mailing lists, full market footprint, raw counts).\n\n3. Check what the place covers before a large query. Coverage differs by country and region, so a field that is filled in one country can be empty in another. To see which countries hold any value for a filterable field, call location_endpoint with resolution=country and filters=[\"<field>_regex=.\"], which lists only the countries where at least one property has that field, for a fraction of a cent. To count the properties that hold it, call aggregate_endpoint with aggregation=count on the field, one entry per country in the aggregations array, because count leaves out empty values.\n\nPlaces come from location_endpoint, never from memory. resolution=country lists every country with its country_abbreviation, and resolution=province with one country_abbreviation lists its provinces, states or regions. To narrow to a place, use the country_abbreviation, province_abbreviation, city and community parameters, and address on properties_endpoint. They ignore letter case, accents and punctuation, so city=calgary and city=Calgary find the same city. Filters compare the stored text exactly, letter case included, so a filter such as city_eq=calgary finds nothing. Use a filter on a place field only where no place parameter fits: on geocoding_endpoint and map_endpoint, for several places at once (community_in), or for a city name across every province, and then write the value exactly as location_endpoint spells it. Neither form rewrites address abbreviations, so turn an address a person typed into a property_id with search_endpoint.\n\nMoney is in the currency of the property's country, with no exchange rate applied, so read country_abbreviation before comparing or totalling values across countries.\n\nNot every value is read from a record. A field with a source column, which field_detail names, says where each property's value came from: a web address of the public record the value was read from, or one of the words Inferred, Observed or User. Pass exclude=inferred by default to properties_endpoint, geocoding_endpoint, map_endpoint, search_endpoint or aggregate_endpoint whenever the select, or the field aggregated, names a field with a source column, to leave out every value Houski worked out. Leave it out when the user asks for every value, inferred ones included, when the answer needs every home or every named property back, such as a total, a heatmap of an estimate or a lookup by address or property_id, and when no selected field has a source column, since the API refuses exclude with nothing to check. exclude=inferred,observed keeps only the values a linked public record gave. exclude takes inferred, observed or user. It checks the selected fields that have a source column, keeps a property when one of them keeps its value, empties the checked values it leaves out, and lists the checked fields in checked_fields. A value it leaves out is not billed, and a property whose checked values are all left out is not returned or billed, so a user who wants only recorded values pays only for those. search_api_documentation with page filter explains it in full.\n\nThe same fast boolean filters exist for every expand set: has_expand_permits_eq=true for permit presence and has_expand_assessments_eq=true for assessment presence. Use expand= with filter_expand_match only when you need the expanded records themselves or when filtering on values inside them (for example expand_permit_content_regex).\n\nThe /avm endpoint costs $5.00 per call: confirm with the user before using.\n\nSpending is capped: every Houski account has a maximum monthly API spend ($199 USD for a new account, set by the owner at https://www.houski.ca/dashboard/api). A call that would go past it is refused and not billed.\n\nUse cases: market analysis, investment research, property valuations, mailing lists, lead generation, insurance underwriting, mortgage lending, urban planning, demographic analysis, climate and flood risk assessment, portfolio management, construction planning, rental analysis, and more.",
"tools": [
{
"description": "Get statistical aggregations for market analysis. Billed per aggregate value 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.",
"inputSchema": {
"$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",
"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.",
"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"
],
"type": "object"
},
"name": "aggregate_endpoint",
"outputSchema": null
},
{
"description": "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, so a billed tool can still refuse a key that passes here.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"api_key": {
"description": "API key to validate",
"type": "string"
}
},
"required": [
"api_key"
],
"type": "object"
},
"name": "auth_endpoint",
"outputSchema": null
},
{
"description": null,
"inputSchema": {
"$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": {
"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"
],
"type": "object"
},
"name": "avm_endpoint",
"outputSchema": null
},
{
"description": "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 value 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"description": "Comma-separated list of field names to get details for",
"type": "string"
}
},
"required": [
"fields"
],
"type": "object"
},
"name": "field_detail",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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"
]
}
},
"type": "object"
},
"name": "field_list",
"outputSchema": null
},
{
"description": "Find properties near coordinates (reverse geocoding). Billed per value 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. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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"
],
"type": "object"
},
"name": "geocoding_endpoint",
"outputSchema": null
},
{
"description": "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: resolution=country with filters=[\"parcel_number_regex=.\"] lists only the countries that hold parcel numbers.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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.",
"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"
],
"type": "object"
},
"name": "location_endpoint",
"outputSchema": null
},
{
"description": "Get map data: pins, clusters, or heatmaps. Billed per cluster or heatmap cell returned, or per value returned for pins. Scope it with all four bbox coordinates or a polygon: with neither, every property in every country is in scope. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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"
],
"type": "object"
},
"name": "map_endpoint",
"outputSchema": null
},
{
"description": "Predict property values over time. Billed per predicted value, which is one field on one date for one 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.",
"inputSchema": {
"$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": {
"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"
],
"type": "object"
},
"name": "predict_endpoint",
"outputSchema": null
},
{
"description": "Retrieve property data (hundreds of fields) with filtering, sorting, and expansion. Billed per value 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. 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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.",
"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"
],
"type": "object"
},
"name": "properties_endpoint",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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"
],
"type": "object"
},
"name": "search_api_documentation",
"outputSchema": null
},
{
"description": "Find property_id using fuzzy address matching. Billed per value 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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"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"
],
"type": "object"
},
"name": "search_endpoint",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b4bc42ee19394d41ba06080f83fa385cde72dc1cb7ee9d0b06a23b450f59fc68 | sha256sum