{"uid":"cap_FMUWc0WN8sjzdsRE_3Aa_","slug":"us-real-estate-geography-comparator-3dc36eee","name":"US Real Estate Geography Comparator","description":"Compare several US geographies on one real-estate metric: price momentum, gross rental yield, price to income, median home value, median gross rent or median household income. Returns a ranking plus rank, highest and lowest, spread and mean signals.","url":"https://api.agentstools.dev/realestate/compare","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":"Two or more geographies (states, metro CBSA codes, county FIPS or ZIPs), comma-separated"},"metric":{"enum":["price_momentum_yoy","gross_rental_yield","price_to_income","median_home_value","median_gross_rent","median_household_income"],"type":"string","description":"The metric to rank on (default price_momentum_yoy)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_VxXKgYDjWdG8xfE6Bn0R4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two or more US geographies on a chosen real-estate metric and returns a ranked list with spread, mean, highest, and lowest signals.","exampleAgentPrompt":"Compare Austin TX, Denver CO, and Phoenix AZ on gross rental yield — I want to see which metro ranks best, the spread, and the mean across all three.","exampleUseCases":null,"resultDescription":"Returns a ranked list of the requested geographies with their metric values, rank positions, and computed signals including the highest-value geography, lowest-value geography, spread (max minus min), and mean across all geographies for the chosen real estate metric.","failureModes":["Fewer than two geographies provided — returns validation error","Invalid or unrecognized geography code (bad FIPS, CBSA, or ZIP) — returns error or geography excluded","Unsupported metric enum value — returns 400 validation error","No data available for a requested geography — geography may be omitted from results","Missing required 'geo' query parameter — returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to compare and rank multiple US real estate markets side-by-side on a single standardized metric. Ideal for investment screening, market selection, and affordability benchmarking across states, metros, counties, or ZIP codes. Prefer this over single-market lookups when the user wants relative performance or ranking signals across geographies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:03:05.086Z","isFirstParty":false}