Search Rental Listings by Location (Zillow)
omnial/search-homes-for-rent
Given a city and state, ZIP code, or neighborhood, returns rental listings Zillow currently has for that area: address, price (a single monthly rent for a specific unit, or a min/max range for a multi-unit building), bedroom/bathroom counts, square footage, availability, building amenities, and per-page pagination counters for browsing further pages of results.
activeper callv2
Price
Up to $0.041 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from Zillow.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/search-homes-for-rent" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-homes-for-rent" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-homes-for-rent", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-homes-for-rent", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.041 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
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
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: 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. A location string Zillow cannot resolve to a real place returns an empty/null result with none of the fields below present (status COMPLETED, output null): a genuine empty result, not an error, so a caller must check for this before reading any nested field.",
"additionalProperties": true
}