{"uid":"cap_MgkIaHE43t9E7Y6M25kqR","slug":"agent-data-apis-rental-listing-analysis-69e79cd0","name":"Agent Data APIs – Rental Listing Analysis","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/analyze","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"policy":{"type":"object"},"target":{"type":"object"},"candidates":{"type":"array","items":{"type":"object"}}}},"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}},"target":{"address":{"city":"Austin","unit":"901","line1":"600 Guadalupe St","state":"TX","postalCode":"78701"},"bedrooms":2,"latitude":30.2704,"bathrooms":2,"longitude":-97.7462,"squareFeet":1020,"propertyType":"MULTIFAMILY","baseRentCents":235000,"mandatoryMonthlyFeesCents":15000},"verdict":"ABOVE_MARKET","evidence":[{"id":"ev_listing_1","dataset":"Rental listing observation","sourceId":"property-manager-feed","sourceUrl":"https://rentals.example/listings/AUS-1200-12A","fieldPaths":["/topComparables/0"],"observedAt":"2026-08-23T16:00:00Z","attribution":"Caller-authorized property manager feed","contentHash":"sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a","retrievedAt":"2026-08-24T12:05:00Z"}],"warnings":["The estimate uses asking-rent observations, not executed lease rents.","The confidence score is heuristic and uncalibrated; inspect the returned comparables."],"analysisId":"anl_78e2ee30bfb1ee2f394f","confidence":{"band":"MEDIUM","score":78,"method":"HEURISTIC_V1_UNCALIBRATED","factors":[{"name":"effectiveSampleSize","score":0.74,"weight":0.3},{"name":"similarity","score":0.91,"weight":0.25},{"name":"freshness","score":0.88,"weight":0.2},{"name":"targetCompleteness","score":1,"weight":0.15},{"name":"dataQuality","score":0.92,"weight":0.1}],"methodologyVersion":"rental-intelligence-v1.0"},"generatedAt":"2026-08-24T12:05:00Z","reasonCodes":["AT_LEAST_5_PERCENT_ABOVE_COMP_ESTIMATE"],"schemaVersion":"1.0","datasetVersion":"rental-ds-2026-08-24-6af7130e","plausibleRange":{"method":"WEIGHTED_P25_P75","lowCents":212000,"highCents":231000},"topComparables":[{"weight":0.86,"ageDays":1.83,"listing":{"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":0,"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},"distanceMiles":0.62,"similarityScore":0.94,"adjustmentReasonCodes":["SIZE_ADJUSTED","BATHROOM_ADJUSTED"],"adjustedMonthlyCostCents":218500}],"differenceCents":28000,"estimatedRentCents":222000,"methodologyVersion":"rental-intelligence-v1.0","differenceBasisPoints":1261,"advertisedMonthlyCents":250000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_svvJ0MybFN4uFiAmqJJ4y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a target rental property against caller-supplied comparable listings and public market benchmarks (Zillow ZORI, HUD FMR) to produce a market-position verdict, confidence score, and evidence trail.","exampleAgentPrompt":"Analyze whether the 2-bedroom unit at 600 Guadalupe St, Austin TX 78701 with a base rent of $2,350/month and $150 in mandatory fees is above, at, or below market — compare it against these three nearby comparable listings I'm authorized to share and include Zillow ZORI and HUD Fair Market Rent context for that ZIP code.","exampleUseCases":[{"title":"Lease pricing review for property manager","prompt":"I need to know if our 2-bed/2-bath unit at 600 Guadalupe St, Austin TX 78701 at $2,350/month is priced competitively — compare it against the five listings I'm uploading and show me where it lands versus the Zillow ZORI and HUD benchmarks for 78701."},{"title":"Rental offer evaluation for prospective tenant","prompt":"I'm looking at a 1-bedroom apartment in ZIP code 10011 listed at $3,200/month — can you analyze it against these four comparable units I found and tell me if it's above or below market with a confidence score?"},{"title":"Portfolio rent benchmarking for real estate analyst","prompt":"Run a market analysis on this multifamily unit in Denver 80203 — it's a 3-bedroom at $2,800 base rent with $75 in mandatory fees — using these eight comparable observations and tell me the verdict, 12-month trend, and HUD Fair Market Rent for that area."}],"resultDescription":"Returns a JSON object containing: a market verdict string (e.g. ABOVE_MARKET), a confidence band (LOW/MEDIUM/HIGH) with a numeric score, an array of ranked comparable evidence items with attribution and content hashes, market context from Zillow ZORI (typical rent, 1/3/12-month % change, as-of date), HUD Fair Market Rents by bedroom count, geographic coordinates, HUD area name and code, dataset version, a unique analysis ID, and an array of warnings about data limitations.","failureModes":["Unsigned or credential-less request returns HTTP 402 with x402 payment challenge before any validation","Invalid credentials or requests that cannot produce the advertised minimum result are rejected before payment and not charged","Insufficient or zero comparable candidates may yield LOW confidence band or rejection","Malformed target or candidate objects return validation errors","ZIP code not covered by ZORI or HUD data returns partial market context with warnings","Truncated or non-deduplicable candidate array reduces verdict reliability"],"whenToPreferThis":"Prefer this endpoint when you need a structured, evidence-backed market-position verdict for a specific rental unit — especially when you have caller-authorized comparable listings to submit alongside public benchmarks. It is purpose-built for agents operating in rental market workflows that require attribution chains, content hashes, and provenance-aware analysis combining Zillow ZORI, HUD FMR, and proprietary feeds. Use it over generic search or lookup endpoints when you need a computed verdict (ABOVE/AT/BELOW market) with a confidence score rather than raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:45.102Z","isFirstParty":false}