Skip to content

AirROI (STR comps and market series)

Role

AirROI is the live short-term rental (STR) source for agents. It finds STR comps near a subject property and supplies the market-level STR series (ADR, occupancy, revenue) in catalog trends. It is not sale ingest.

Tools

Job MCP tool Needs
STR listing comps near lat/lng airroi_listings_comparables AIRROI_API_KEY; deal lat/lng
Market STR series refresh_deal_trends(gap_fill=true) / refresh_airroi_trends AIRROI_API_KEY

Both are paid. Call them only when STR is in scope (str in comps_kinds / strategy_intent) — never for LTR-only, flip-only or wholesale-only runs.

Usage

  1. airroi_listings_comparables(…) returns candidates only — review them before saving.
  2. Persist with add_deal_comps(kind=str, source=airroi); keep image_url when present.
  3. Market-level STR series go through get_agent_manual(workflow=trends). Coverage is zip, neighborhood, city and county (county only for county geos), up to 60 months; state and MSA are unsupported.

Gotchas

  • Never invent ADR or occupancy; patch adr_nightly / occupancy_pct only after evidence.
  • Catalog trends are not listing comps — they answer different questions.
  • Optional add-ons: VRBO geo comps, and AirDNA for known Airbnb URLs when AirDNA credentials are configured.
  • Research comps: get_agent_manual(workflow=research)
  • Trends: get_agent_manual(workflow=trends)
  • Catalog: get_agent_manual(workflow=data-sources)