{"uid":"cap_5xRZ3wcFrKT7wihcBgijK","slug":"rafid-property-compare-api-fb128e2a","name":"Rafid Property Compare API","description":"Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.","url":"https://api.rafidsystem.com/api/v1/x402/property/compare?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"array","items":{"type":"object","required":["propertyValue","annualRent","name"],"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"annualRent":{"type":"number","maximum":1000000000000,"minimum":0},"maintenance":{"type":"number","maximum":1000000000000,"minimum":0,"description":"Legacy alias for maintenanceCost; supply only one"},"propertyValue":{"type":"number","maximum":1000000000000,"minimum":0.01},"serviceCharge":{"type":"number","maximum":1000000000000,"minimum":0},"vacancyRatePct":{"type":"number","maximum":100,"minimum":0},"maintenanceCost":{"type":"number","maximum":1000000000000,"minimum":0},"otherAnnualCosts":{"type":"number","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":20,"minItems":2}}},"responseSchema":{"type":"json","example":{"properties":[{"name":"A","note":"Calculations only; excludes financing, taxes, transaction fees and capital appreciation.","currency":"OMR","netYield":8.47,"annualRent":7200,"grossYield":8.47,"netYieldPct":8.47,"paybackYears":11.81,"grossYieldPct":8.47,"propertyValue":85000,"annualNetIncome":7200,"grossAnnualIncome":7200,"annualOperatingCost":0,"effectiveAnnualRent":7200,"annualOperatingCosts":0},{"name":"B","note":"Calculations only; excludes financing, taxes, transaction fees and capital appreciation.","currency":"OMR","netYield":7,"annualRent":7000,"grossYield":7,"netYieldPct":7,"paybackYears":14.29,"grossYieldPct":7,"propertyValue":100000,"annualNetIncome":7000,"grossAnnualIncome":7000,"annualOperatingCost":0,"effectiveAnnualRent":7000,"annualOperatingCosts":0}],"sortedByNetYield":["A","B"]}},"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_qtjbodRmIMp896Al-qjpH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares 2–20 properties side-by-side by computing gross yield, net yield, payback period, and ranking them by net return","exampleAgentPrompt":"Compare these two properties for me: Property A is worth 85,000 OMR with 7,200 OMR annual rent and no maintenance costs, and Property B is worth 100,000 OMR with 7,000 OMR annual rent and no maintenance costs — which one gives a better net yield?","exampleUseCases":[{"title":"Rental portfolio yield ranking","prompt":"I'm looking at three flats to invest in: Flat Muscat worth 120,000 with 10,800 annual rent and 1,200 maintenance, Flat Salalah worth 95,000 with 8,000 annual rent and 800 maintenance, and Flat Sohar worth 75,000 with 6,500 annual rent and 500 maintenance — rank them by net yield so I know which is the best investment."},{"title":"Vacation rental vs long-term let comparison","prompt":"Help me decide between two properties: a vacation rental worth 200,000 generating 22,000 annual rent but with 4,000 maintenance and 2,000 service charge, versus a long-term let worth 180,000 generating 18,000 annual rent with only 1,500 maintenance — which has a better net yield and how many years to pay back?"},{"title":"Pre-purchase investment due diligence","prompt":"Before I make an offer, can you compare Property Alpha valued at 250,000 with 20,000 annual rent, 5% vacancy rate, and 3,000 maintenance against Property Beta valued at 310,000 with 26,000 annual rent, 3% vacancy rate, and 4,500 maintenance — I need gross yield, net yield, and payback years for both."}],"resultDescription":"Returns an array of enriched property objects each containing gross yield %, net yield %, payback years, annual net income, effective annual rent, and annual operating costs, plus a top-level array listing the property names sorted from highest to lowest net yield.","failureModes":["Fewer than 2 properties supplied — minimum array size is 2","Missing required fields (propertyValue, annualRent, name) on any property object — returns validation error","Property value of 0 or below — fails minimum constraint","Both 'maintenance' and 'maintenanceCost' supplied simultaneously — ambiguous legacy alias conflict","More than 20 properties in array — exceeds maxItems limit","Payment failure or insufficient USDC balance — 402 Payment Required before computation runs"],"whenToPreferThis":"Use this endpoint when an agent needs to objectively rank or compare multiple real estate investment options by financial return metrics (yield, payback) rather than qualitative features. It is ideal when the user has concrete property values and rental figures and needs a structured, sorted output. Prefer this over a generic calculator when you need simultaneous multi-property comparison with ranked output in a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:40:11.755Z","isFirstParty":false,"canonicalSlug":"rafid-property-compare-api-fb128e2a"}