Contract
input_schema.json
{
"type": "object",
"required": [
"location"
],
"properties": {
"page": {
"type": "integer",
"description": "Page number for pagination (1-based)"
},
"location": {
"type": "string",
"description": "City and state, ZIP code, or neighborhood (e.g., 'Los Angeles, CA', '10001', 'Brooklyn, NY')"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"area": {
"type": "number",
"description": "Square footage. Only observed on single-unit listings."
},
"beds": {
"type": "number",
"description": "Bedroom count. Only observed on single-unit listings."
},
"zpid": {
"type": "string",
"description": "Zillow's identifier for this listing. Numeric on a single-unit listing (e.g. '2081483157'); on a building listing, observed as a composite of its latitude/longitude (e.g. '30.485666--97.772224') rather than a plain zpid."
},
"baths": {
"type": "number",
"description": "Bathroom count. Only observed on single-unit listings."
},
"price": {
"type": "string",
"description": "Formatted monthly price (e.g. '$2,026/mo'). Only observed on single-unit listings."
},
"units": {
"type": "array",
"items": {
"type": "object",
"properties": {
"beds": {
"type": "string",
"description": "Bedroom count for this unit tier, as a string (e.g. '2')."
},
"price": {
"type": "string",
"description": "e.g. '$1,164+'."
},
"roomForRent": {
"type": "boolean"
}
},
"additionalProperties": true
},
"description": "Per-bedroom-count price breakdown for a building listing. Only observed on building listings."
},
"address": {
"type": "string",
"description": "Full single-line address for this listing."
},
"hdpData": {
"type": "object",
"properties": {
"homeInfo": {
"type": "object",
"properties": {
"daysOnZillow": {
"type": "number",
"description": "Days this listing has been active on Zillow."
},
"rentZestimate": {
"type": "number",
"description": "Zillow's estimated market rent for this unit."
}
},
"additionalProperties": true
}
},
"description": "Only observed on single-unit listings.",
"additionalProperties": true
},
"latLong": {
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
},
"additionalProperties": true
},
"baseRent": {
"type": "number",
"description": "Base monthly rent, before required fees. Only observed on single-unit listings."
},
"hasVideo": {
"type": "boolean"
},
"has3DModel": {
"type": "boolean",
"description": "Whether a 3D/virtual tour is available."
},
"isBuilding": {
"type": "boolean",
"description": "True when this result is a multi-unit building (see `listings` description above). Absent (not `false`) on the single-unit listings observed."
},
"statusText": {
"type": "string",
"description": "Short listing headline (often the building name)."
},
"statusType": {
"type": "string",
"description": "e.g. 'FOR_RENT'."
},
"addressCity": {
"type": "string"
},
"maxBaseRent": {
"type": "number",
"description": "Highest base rent across the building's units. Only observed on building listings."
},
"minBaseRent": {
"type": "number",
"description": "Lowest base rent across the building's units. Only observed on building listings."
},
"addressState": {
"type": "string"
},
"buildingName": {
"type": "string",
"description": "The property/building's marketing name."
},
"addressStreet": {
"type": "string",
"description": "Street address (and unit, when applicable)."
},
"addressZipcode": {
"type": "string"
},
"countryCurrency": {
"type": "string",
"description": "Currency symbol, e.g. '$'."
},
"availabilityDate": {
"type": "string",
"description": "e.g. '2026-09-14 00:00:00'."
},
"factsAndFeatures": {
"type": "object",
"properties": {
"hasSpa": {
"type": "boolean"
},
"hasPool": {
"type": "boolean"
},
"hasFireplace": {
"type": "boolean"
},
"fullBathroomCount": {
"type": "number"
},
"hasAirConditioning": {
"type": "boolean"
}
},
"description": "Only observed on single-unit listings.",
"additionalProperties": true
},
"unformattedPrice": {
"type": "number",
"description": "The numeric value of `price` with no formatting. Only observed on single-unit listings."
},
"availabilityCount": {
"type": "number",
"description": "Number of available units. Only observed on building listings."
},
"isUndisclosedAddress": {
"type": "boolean",
"description": "True when Zillow withholds the exact address."
},
"listCardRecommendation": {
"type": "object",
"properties": {
"zovInsight": {
"type": "object",
"properties": {
"rarity": {
"type": "string",
"description": "e.g. '8%' -- share of nearby listings with this amenity."
},
"regionName": {
"type": "string",
"description": "The metro/region this rarity percentage is computed over, e.g. 'Austin'."
},
"amenityType": {
"type": "string",
"description": "e.g. 'Playground', 'Lounge'."
},
"displayString": {
"type": "string"
}
},
"description": "A single highlighted amenity, with its local rarity.",
"additionalProperties": true
},
"flexFieldRecommendations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contentType": {
"type": "string",
"description": "e.g. 'frSpecialOffer', 'frPriceCut', 'homeInsight'."
},
"displayString": {
"type": "string",
"description": "e.g. 'Special offer', '8 Weeks Free', '$82'."
}
},
"additionalProperties": true
},
"description": "Short promotional call-outs, e.g. a move-in special or a price cut."
}
},
"description": "Merchandising call-outs Zillow surfaces for this listing.",
"additionalProperties": true
},
"shouldShowRequestOnPrice": {
"type": "boolean",
"description": "True when Zillow hides the exact price behind a 'request price' prompt."
},
"shouldShowZestimateAsPrice": {
"type": "boolean"
},
"totalRequiredMonthlyMaxFee": {
"type": "number",
"description": "Highest required monthly fee on top of base rent."
},
"totalRequiredMonthlyMinFee": {
"type": "number",
"description": "Lowest required monthly fee on top of base rent."
},
"listPriceIncludesRequiredMonthlyFees": {
"type": "boolean"
}
},
"additionalProperties": true
},
"description": "One entry per matching rental. Two distinct listing shapes were observed on the one real search calibrated: a multi-unit BUILDING listing (`isBuilding: true`) carries `minBaseRent`/`maxBaseRent`/`availabilityCount`/`units[]` and omits `price`/`baseRent`/`beds`/`baths`/`area`/`hdpData`; a single-unit listing (`isBuilding` absent) carries `price`/`unformattedPrice`/`baseRent`/`beds`/`baths`/`area`/`hdpData` and omits the building-only fields. Not every field below is present on every listing."
},
"totalPages": {
"type": "number",
"description": "Total pages of results available for this search."
},
"currentPage": {
"type": "number",
"description": "The page number of this result set (1-based)."
},
"resultsPerPage": {
"type": "number",
"description": "Listings included per page (41 on the one real call observed)."
},
"totalResultCount": {
"type": "number",
"description": "Total matching listings across all pages."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on the one real search observed."
}
},
"description": "The search-results record, as returned at routing.responseResultPath ($.output). A location string Zillow cannot resolve to a real place returns an empty/null result with none of the fields below present -- confirmed via examples/zzznonexistent-empty.json (status COMPLETED, cost 0, billedUnits 0, output null): a genuine empty result, not an error, so a caller must check for this before reading any nested field.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.04095 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 8, 2026