{"uid":"cap_KdCplCeWptpBhamjSDFP4","slug":"realestate-rents-e1918a1e","name":"realestate-rents","description":"Rental market indicators for a geography: HUD Fair Market Rents by bedroom count when a HUD token is configured, plus the Census ACS median gross rent as context. Falls back to the ACS rent when HUD is not configured. Aggregate market tier, US only.","url":"https://payai.agentstools.dev/realestate/rents","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["geo"],"properties":{"geo":{"type":"string","description":"A state, metro CBSA code, county FIPS, ZIP, or address"},"type":{"enum":["auto","state","county","cbsa","zip","address"],"type":"string","description":"How to read geo (auto reads a 5-digit number as a ZIP)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bxk4iy2H0KBLySQALJ36X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns HUD Fair Market Rents by bedroom count and Census ACS median gross rent for a US geography, with an aggregate market tier classification.","exampleAgentPrompt":"What are the HUD Fair Market Rents by bedroom size and the Census median gross rent for ZIP code 78701 in Austin, and what rental market tier does it fall into?","exampleUseCases":[{"title":"Rental affordability check by ZIP","prompt":"What are the HUD Fair Market Rents for a 1-bedroom and 2-bedroom unit in ZIP code 30303, and what market tier is that area?"},{"title":"Metro-level rent benchmarking","prompt":"Pull the rental market indicators for the Dallas-Fort Worth metro CBSA — I need the fair market rents by bedroom count and the Census median gross rent to benchmark against our portfolio."},{"title":"County housing analysis","prompt":"What does HUD say fair market rent is for each bedroom size in Los Angeles County (FIPS 06037), and is it a high, mid, or low market tier?"}],"resultDescription":"Returns HUD Fair Market Rent figures broken down by bedroom count (0–4+ bedrooms) for the specified geography when HUD is configured, alongside the Census ACS median gross rent as a contextual reference, plus an aggregate market tier label (e.g. high, mid, low) classifying the rental market. Falls back to ACS median rent alone when HUD data is unavailable. US geographies only.","failureModes":["Invalid or unrecognized geo string — returns error or empty result","Non-US geography provided — endpoint only covers US markets","Ambiguous ZIP or address that cannot be resolved to a geography","HUD token not configured — falls back to ACS median rent only, no per-bedroom breakdown","Rate limit or payment failure — x402 payment required before response is served"],"whenToPreferThis":"Choose this endpoint when you need official HUD Fair Market Rent benchmarks by bedroom count for US housing market analysis, affordability assessments, or voucher program research. It is the right choice when you want both HUD and Census ACS rent data fused with a market tier classification in a single call, covering any US geography level from address to state. Prefer it over generic real estate listing APIs when you need government-sourced rent standards rather than observed listing prices.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:53:41.725Z","isFirstParty":false}