{"uid":"cap_MIvM0AfdHCpHphCu799xt","slug":"rental-market-snapshot-api-x402-fdbd2137","name":"Rental Market Snapshot API (x402)","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/market-snapshot?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"bedrooms":{"type":"integer","maximum":4,"minimum":0},"postalCode":{"type":"string","pattern":"^[0-9]{5}(-[0-9]{4})?$"},"monthlyBudgetCents":{"type":"integer","maximum":100000000,"minimum":1}}},"responseSchema":{"type":"json","example":{"input":{"bedrooms":2,"postalCode":"78701","monthlyBudgetCents":230000},"trends":{"asOf":"2026-07","change1MonthPct":0.4,"change3MonthPct":1.2,"change12MonthPct":2.8},"evidence":[{"id":"ev_zori","dataset":"Zillow Observed Rent Index (ZORI)","sourceId":"zillow-research","sourceUrl":"https://www.zillow.com/research/data/","fieldPaths":["/benchmarks","/trends"],"observedAt":"2026-07-31T00:00:00Z","attribution":"Data Provided by Zillow Group; Zillow Research ZORI","contentHash":"sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a","retrievedAt":"2026-08-24T12:05:00Z"},{"id":"ev_hud","dataset":"HUD Fair Market Rents","sourceId":"hud-pdr","sourceUrl":"https://www.huduser.gov/portal/dataset/fmr-api.html","fieldPaths":["/geography/hudAreaCode","/geography/hudAreaName","/benchmarks"],"observedAt":"2026-08-24T12:00:00Z","contentHash":"sha256:7f1f38d06d9f1880b1811d889d33637384c6d768031bdd087be6c4b98e4d0055","retrievedAt":"2026-08-24T12:05:00Z"}],"warnings":["Public benchmarks are area-level context and are not live unit inventory."],"budgetFit":{"verdict":"BUDGET_ABOVE_PRIMARY_BENCHMARK","comparisons":[{"verdict":"ABOVE_BENCHMARK","benchmarkId":"ZORI_TYPICAL_ASKING_RENT","differenceCents":20000,"benchmarkRentCents":210000,"monthlyBudgetCents":230000,"differenceBasisPoints":952},{"verdict":"NEAR_BENCHMARK","benchmarkId":"HUD_FAIR_MARKET_RENT","differenceCents":10000,"benchmarkRentCents":220000,"monthlyBudgetCents":230000,"differenceBasisPoints":455}],"reasonCodes":["BUDGET_AT_LEAST_5_PERCENT_ABOVE_PRIMARY_BENCHMARK"],"interpretation":"The primary benchmark is ZORI when available, otherwise the requested-bedroom HUD Fair Market Rent. Positive differences mean the stated budget is above a benchmark.","primaryBenchmarkId":"ZORI_TYPICAL_ASKING_RENT","thresholdBasisPoints":500},"geography":{"latitude":30.2713,"longitude":-97.7426,"postalCode":"78701","hudAreaCode":"METRO12420M12420","hudAreaName":"Austin-Round Rock-Georgetown, TX HUD Metro FMR Area"},"benchmarks":[{"id":"ZORI_TYPICAL_ASKING_RENT","asOf":"2026-07","name":"Zillow Observed Rent Index typical asking rent","sourceId":"zillow-research","rentCents":210000,"bedroomScope":"ALL_BEDROOM_COUNTS","interpretation":"A smoothed ZIP-level typical observed asking rent across covered rentals; it is not bedroom-specific or live unit inventory.","geographicScope":"ZIP_CODE"},{"id":"HUD_FAIR_MARKET_RENT","name":"HUD Fair Market Rent","sourceId":"hud-pdr","rentCents":220000,"bedroomScope":"2_BEDROOM","interpretation":"A HUD program benchmark matched to the requested bedroom count; it is not a direct estimate of a specific unit's current asking rent.","geographicScope":"HUD_AREA"}],"snapshotId":"mkt_5e4c41b7f0a2938d6c12","generatedAt":"2026-08-24T12:05:00Z","limitations":["ZORI is a ZIP-level asking-rent index and is not bedroom-specific, live unit inventory, or an executed lease record.","HUD Fair Market Rent is a program benchmark and is not a direct estimate of a specific unit's current asking rent.","Budget fit compares a stated monthly budget with public benchmarks; it is not an affordability, eligibility, appraisal, or recommendation decision.","Utilities, deposits, taxes, move-in costs, concessions, and unit-specific mandatory fees are not included unless they are already reflected by a source benchmark."],"schemaVersion":"1.0","datasetVersion":"rental-ds-2026-08-24-6af7130e","methodologyVersion":"rental-market-snapshot-v1.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UOATVRsbsf3DrBLPLH9lj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns authoritative U.S. rental market benchmarks, trends, geography, and optional budget fit analysis for a given ZIP code and bedroom count, sourced from Zillow ZORI and HUD Fair Market Rent data.","exampleAgentPrompt":"What does the rental market look like for a 2-bedroom apartment in ZIP code 78701? My monthly budget is $2,300 — pull the Zillow and HUD benchmarks and tell me if I'm above or below the typical asking rent.","exampleUseCases":[{"title":"Budget fit check before renting","prompt":"I'm looking at 1-bedroom apartments in ZIP 10001 and my budget is $3,500 a month. Can you pull the current rental benchmarks and tell me if that budget is above, below, or in line with what Zillow and HUD say is typical?"},{"title":"Rental trend analysis for relocation","prompt":"We're planning to relocate to ZIP 30301 in Atlanta. Can you get the rental market snapshot for a 3-bedroom there — I want to see the 1-month, 3-month, and 12-month rent trend percentages so we know if rents are rising fast."},{"title":"Studio rent benchmark lookup","prompt":"What's the typical asking rent for a studio apartment in ZIP 94103 in San Francisco, based on the latest Zillow ZORI and HUD Fair Market Rent data?"}],"resultDescription":"A JSON object containing: normalized input (ZIP, bedrooms, budget), rent trend percentages (1-month, 3-month, 12-month), area-level rent benchmarks (ZORI typical asking rent and HUD Fair Market Rent in cents), optional budget fit verdict with per-benchmark comparisons and basis-point differences, geographic metadata (lat/lon, HUD area code and name), and full data provenance evidence records including source URLs, content hashes, and observation timestamps. Warnings clarify that benchmarks are area-level public data, not live unit listings.","failureModes":["Unsigned requests receive an x402 payment challenge and are not charged","Invalid credentials or requests that cannot produce the advertised minimum result are rejected before payment and not charged","ZIP code not found or not mappable to ZCTA geography returns an error","Bedroom count outside 0-4 range is rejected by schema validation","Budget value of 0 or exceeding maximum is rejected","ZORI or HUD data unavailable for the requested geography may return partial results with warnings"],"whenToPreferThis":"Use this endpoint when you need authoritative, sourced U.S. rental market benchmarks (Zillow ZORI + HUD FMR) for a specific ZIP code and bedroom count — especially when you need data provenance, trend percentages, and optional budget fit analysis in a single call. Prefer this over general web search when you need structured, reproducible rent benchmark data with attribution and content hashes. Not suitable for live unit listings, lease price negotiation data, or non-U.S. markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:32:47.503Z","isFirstParty":false,"canonicalSlug":"rental-market-snapshot-api-x402-fdbd2137"}