{"uid":"cap_TsUjDa6qDzxsw1Dpw5mtk","slug":"agent-data-apis-rental-search-d2d24ee8","name":"Agent Data APIs – Rental Search","description":"An x402-paid API suite for autonomous agents. The freight operation preserves deterministic U.S. DOT/FMCSA carrier checks. A self-contained rental market snapshot returns available public rent benchmarks, trends, provenance, and optional budget fit from a ZIP code and bedroom count. Other rental operations normalize, deduplicate, search, compare, and analyze rental observations supplied by a caller who is authorized to process them. Zillow Research ZORI, U.S. Census ZCTA geography, and HUD Fair Market Rent data are not represented as unit-level listings or executed lease rents. Unsigned requests receive the x402 challenge before validation. Credential-bearing retries that are invalid or cannot produce the advertised minimum result are rejected before payment verification and settlement and are not charged.","url":"https://192.3.171.233/v1/rentals/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string"},"limit":{"type":"integer"},"bedrooms":{"type":"object"},"location":{"type":"object"},"petPolicy":{"type":"string"},"candidates":{"type":"array","items":{"type":"object"}},"propertyTypes":{"type":"array","items":{"type":"string"}},"monthlyCostCents":{"type":"object"},"maxListingAgeDays":{"type":"integer"},"requiredAmenities":{"type":"array","items":{"type":"string"}}}},"responseSchema":{"type":"json","example":{"market":{"evidence":[{"id":"ev_zori","dataset":"Zillow Observed Rent Index (ZORI)","sourceId":"zillow-research","sourceUrl":"https://rentals.example/listings/AUS-1200-12A","fieldPaths":["/typicalRentCents"],"observedAt":"2026-08-23T16:00:00Z","attribution":"Caller-authorized property manager feed","contentHash":"sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a","retrievedAt":"2026-08-24T12:05:00Z"}],"latitude":30.2713,"warnings":["Market benchmarks are area-level context and are not substitutes for property-level comparables."],"longitude":-97.7426,"postalCode":"78701","generatedAt":"2026-08-24T12:00:00Z","hudAreaCode":"METRO12420M12420","hudAreaName":"Austin-Round Rock-Georgetown, TX HUD Metro FMR Area","sourceCount":2,"datasetVersion":"rental-ds-2026-08-24-6af7130e","change1MonthPct":0.3,"change3MonthPct":1.1,"typicalRentAsOf":"2026-07","change12MonthPct":-0.8,"typicalRentCents":229400,"hudFairMarketRentsCents":{"0":143000,"1":160000,"2":195000,"3":254000}},"matches":[{"address":{"city":"AUSTIN","unit":"12A","line1":"1200 CONGRESS AVE","state":"TX","postalCode":"78701"},"sources":["property-manager-feed"],"bedrooms":2,"latitude":30.2752,"amenities":["IN_UNIT_LAUNDRY","PARKING"],"bathrooms":2,"furnished":false,"listingId":"lst_8c896d29ce93b5f421f4","longitude":-97.7426,"petPolicy":"PETS_ALLOWED","matchScore":98,"observedAt":"2026-08-23T16:00:00Z","propertyId":"prp_79dd77a282d20d5f2860","squareFeet":1040,"listingKind":"LONG_TERM","reasonCodes":["NORMALIZED_AND_DEDUPLICATED"],"evidenceRefs":["ev_listing_1"],"propertyType":"MULTIFAMILY","baseRentCents":210000,"duplicateCount":2,"dataQualityFlags":[],"dataQualityScore":94,"totalMonthlyCostCents":222500,"marketDifferencePercent":-3.4,"pricePerSquareFootCents":214,"effectiveMonthlyRentCents":206390,"mandatoryMonthlyFeesCents":12500},{"address":{"city":"AUSTIN","unit":"804","line1":"501 BRAZOS ST","state":"TX","postalCode":"78701"},"sources":["property-manager-feed"],"bedrooms":2,"latitude":30.2752,"amenities":["IN_UNIT_LAUNDRY","PARKING"],"bathrooms":2,"furnished":false,"listingId":"lst_907f470119bf8210575c","longitude":-97.7426,"petPolicy":"PETS_ALLOWED","matchScore":91,"observedAt":"2026-08-23T16:00:00Z","propertyId":"prp_c13a528761a591b8e0b4","squareFeet":1040,"listingKind":"LONG_TERM","reasonCodes":["NORMALIZED_AND_DEDUPLICATED"],"evidenceRefs":["ev_listing_1"],"propertyType":"MULTIFAMILY","baseRentCents":224000,"duplicateCount":2,"dataQualityFlags":[],"dataQualityScore":91,"totalMonthlyCostCents":232000,"marketDifferencePercent":-3.4,"pricePerSquareFootCents":214,"effectiveMonthlyRentCents":232000,"mandatoryMonthlyFeesCents":8000}],"evidence":[{"id":"ev_listing_1","dataset":"Rental listing observation","sourceId":"property-manager-feed","sourceUrl":"https://rentals.example/listings/AUS-1200-12A","fieldPaths":["/matches/0"],"observedAt":"2026-08-23T16:00:00Z","attribution":"Caller-authorized property manager feed","contentHash":"sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a","retrievedAt":"2026-08-24T12:05:00Z"}],"searchId":"srch_47de9a7a4f3c162f21b8","warnings":["Candidate observations are caller supplied; verify current availability and lease terms with the property manager."],"generatedAt":"2026-08-24T12:05:00Z","resultCount":2,"schemaVersion":"1.0","datasetVersion":"rental-ds-2026-08-24-6af7130e","methodologyVersion":"rental-intelligence-v1.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0BaIL_CifvpmuvwmEv_r2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search, normalize, deduplicate, and rank rental listings from caller-supplied observations, enriched with public rent benchmarks (Zillow ZORI, HUD FMR) for a given ZIP code and bedroom count","exampleAgentPrompt":"Search for available 2-bedroom long-term rentals in ZIP code 78701 with a budget under $2,300 per month, pets allowed, in-unit laundry required, and return up to 10 results ranked by match score — I also want the Zillow and HUD market benchmarks for that area.","exampleUseCases":[{"title":"Budget-fit apartment search with benchmarks","prompt":"Find me 2-bedroom rentals in ZIP 78701 for under $2,200 a month — pets allowed — and tell me how those listings compare to the Zillow typical rent and HUD fair market rent for the area."},{"title":"Pet-friendly rental screening with amenity filter","prompt":"I have a list of rental candidates in 78701 — can you normalize and deduplicate them, then return only the ones that are pet-friendly, have parking, and are within $2,500 a month for a 2-bedroom?"},{"title":"Relocation market snapshot for remote worker","prompt":"I'm thinking about relocating to Austin, ZIP 78701. Can you pull available 1-bedroom rentals under $1,800 per month and show me the current rent trends — 1-month, 3-month, and 12-month changes — along with the HUD fair market rent?"}],"resultDescription":"A JSON response containing: (1) matched rental listings with normalized address, rent in cents, bedrooms, bathrooms, square feet, pet policy, amenities, match score, data quality score, market difference percent, mandatory fees, and evidence references; (2) a market context block with Zillow ZORI typical rent, HUD Fair Market Rents by bedroom count, 1/3/12-month change percentages, geographic coordinates, HUD area name, dataset version, and provenance evidence records including content hashes and attribution.","failureModes":["Unsigned or missing x402 credential returns an HTTP 402 challenge before any validation","Invalid credentials or insufficient balance rejected before payment settlement — no charge","No listings match the filter criteria — empty matches array returned with market block still populated","ZIP code not found in ZCTA or ZORI coverage — warnings array populated, benchmark fields may be null","Candidate observations fail normalization due to missing required fields — rejected with validation error","Rate limiting or server error returns 5xx with no charge applied"],"whenToPreferThis":"Use this endpoint when you need to search and rank rental observations that have already been gathered (from property-manager feeds or similar sources) against public rent benchmarks, or when you need a self-contained market snapshot (ZORI + HUD FMR) for a specific ZIP and bedroom count. Prefer this over raw Zillow or HUD APIs when you need deduplicated, normalized, scored results with provenance in a single x402-paid call at $0.02 USDC. Not suitable for executing leases, accessing unit-level MLS data, or retrieving commercial property data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:40.565Z","isFirstParty":false}