Preview docs. Hallucination Guard is the only live endpoint today.

The rest of the API surface ships through the rest of 2026. Join the waitlist to be first in line and shape what we build first.

API reference

Airbnb Deal Analyzer API

Property address in, deal verdict out. Wraps AirROI market data + arbitrage math + structured analysis into one call.

Powers the hosted Airbnb Deal Analyzer module. AirROI access is bundled. You don't need to negotiate it separately.

POST /v1/airbnb-deal/analyze

Request body

FieldTypeDescription
addressstringRequired. Normalised against USPS / Google address API server-side.
rent_estimate_monthlynumberOptional. If omitted, market rent estimate is used.
furnishing_amortization_monthlynumberOptional. Default $350.
platform_fees_pctnumberOptional. Default 0.03 (3%).
verdict_thresholdsobjectOptional. Override the green/yellow/red bands. See below.
JAVASCRIPT
const result = await prism.airbnbDeal.analyze({
  address: "1234 Main St, Nashville, TN 37210",
  rent_estimate_monthly: 2400,
  furnishing_amortization_monthly: 350,
});
PYTHON
result = prism.airbnb_deal.analyze(
    address=class="tk-str">"1234 Main St, Nashville, TN 37210",
    rent_estimate_monthly=2400,
    furnishing_amortization_monthly=350,
)
BASH
curl https://api.prism.dev/v1/airbnb-deal/analyze \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "address": "1234 Main St, Nashville, TN 37210", "rent_estimate_monthly": 2400 }'

Response

JSON
{
  "tk-key">"address_normalized": "1234 Main St, Nashville, TN 37210",
  "tk-key">"market": {
    "tk-key">"projected_annual_revenue": 47800,
    "tk-key">"occupancy_rate": 0.71,
    "tk-key">"adr": 185,
    "tk-key">"comp_count": 41,
    "tk-key">"data_provider": "airroi"
  },
  "tk-key">"math": {
    "tk-key">"monthly_revenue": 3983,
    "tk-key">"monthly_costs": 2750,
    "tk-key">"monthly_net": 1233,
    "tk-key">"annual_net": 14796,
    "tk-key">"cash_on_cash": 0.41
  },
  "tk-key">"verdict": "yellow",
  "tk-key">"reasoning": "Net is positive but thin. Occupancy is on par with the comp set; ADR is below the 70th percentile.",
  "tk-key">"red_flags": [],
  "tk-key">"yellow_flags": ["ADR below market median for the comp set"]
}

Verdict thresholds

Default bands are tuned for traditional rental arbitrage. To encode your own deal philosophy, pass verdict_thresholds:

JSON
{
  "tk-key">"verdict_thresholds": {
    "tk-key">"green_min_annual_net": 18000,
    "tk-key">"green_min_cash_on_cash": 0.5,
    "tk-key">"red_max_annual_net": 6000
  }
}

Failure modes specific to this endpoint

  • 404 resource_not_found with detail.kind: "address": couldn't normalise the address.
  • 502 upstream_unavailable: AirROI temporarily down. Retry with backoff.