{"uid":"cap_IXy-X51eI8S9VvZN3QU8i","slug":"realestate-compare-edb59890","name":"realestate-compare","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://payai.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_C9Pa9iUWU2YOZ42An7BR-","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":"Rank and compare multiple US geographies side-by-side on a chosen real estate metric such as price momentum, rental yield, or median home value.","exampleAgentPrompt":"Can you compare Austin TX, Phoenix AZ, and Nashville TN on gross rental yield and tell me which market ranks highest right now?","exampleUseCases":[{"title":"Investor rental yield market scouting","prompt":"I'm deciding where to buy a rental property — can you compare gross rental yield across Miami FL, Tampa FL, Atlanta GA, and Charlotte NC so I know which market gives the best returns?"},{"title":"Affordability comparison across metros","prompt":"How do San Francisco, Denver, and Austin compare on price to income ratio? I want to know which city is most and least affordable for buyers right now."},{"title":"Year-over-year price momentum ranking","prompt":"Can you rank Seattle, Portland, Phoenix, and Las Vegas by price momentum year over year so I can see which housing market is heating up the fastest?"}],"resultDescription":"Returns a ranked list of the submitted geographies sorted by the chosen metric, along with each geography's rank position, the metric value, which geography ranked highest and lowest, and summary statistics including the spread (max minus min) and mean across all geographies compared.","failureModes":["Fewer than two geographies provided — endpoint requires at least two for comparison","Invalid or unrecognized geography codes (bad FIPS, CBSA, or ZIP) return an error or are omitted","Metric enum value not recognized returns a validation error","Data unavailable for a specific geography or metric combination may return partial results or missing values","Network or payment failure results in a 402 or timeout response"],"whenToPreferThis":"Use this endpoint when you need a structured side-by-side ranking of multiple US real estate markets on a single metric. It is ideal for investment screening, market research, and affordability analysis where you want not just raw values but comparative rank context (highest, lowest, spread, mean). Prefer this over a single-geography lookup when the user's question is explicitly comparative ('which of these markets is best for X').","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:49:18.427Z","isFirstParty":false}