Real Estate Investment API - Airbnb ROI, Rents, Comps

Run the numbers on any US rental property. Short term and long term income, occupancy, cap rate, cash on cash return and cash flow - side by side on the same row, never blended - plus the comps behind them, the market around them, and whether short term letting is even legal there.

What this actor does

• Both strategies, always separate. Every property, listing and market row carries an Airbnb figure and a traditional figure in their own columns: rental income, cap rate and cash on cash return for each. Averaging the two answers no question anyone actually has.
• A full investment analysis per property. Cap rate, cash on cash return, monthly cash flow, total expenses and ROI, with your own assumptions for purchase price, down payment, loan term, interest rate, occupancy, maintenance, management, tax, insurance and startup cost.
• Rental comps that are actually comparable. Nearby short term rentals with their nightly rates, occupancy and earnings, and nearby long term rentals with their rents - sorted by similarity, distance, occupancy, price or income.
• Rent estimates by bedroom count. Studio through four bedroom values for a city, ZIP code or neighborhood, plus a detail row per bedroom tier with the minimum, maximum, average and median rent, the sample count, and the rent adjusted for vacancy.
• Property records. Beds, baths, square footage, year built, lot size, parcel number, the full sale and loan history, the assessment and tax history, and what several valuation houses each think the property is worth.
• Short term rental listings in depth. One Airbnb or VRBO listing with its nightly rate, modelled revenue, occupancy, reviews, capacity and whether it is still live - plus its last twelve months and its forward projections.
• Whole markets. Active listings, market summaries, occupancy for every listing in a market, revenue percentiles, the property type mix, what each amenity is associated with, twelve months of history, top cities and neighborhoods, and an investment heatmap across a map box.
• Short term rental regulations. Legal status, permit requirements, occupancy limits and minimum stays by city, with a link to the official source. The one lookup that can invalidate every other number on this page.
• Pay per result. You are charged for rows carrying a real record. Addresses the provider cannot match, markets with no coverage and searches that find nothing are free.

Bring your own key

This actor calls the provider with your own API key, from your developer account. Paste it into the API key field, or set it as the DATA_API_KEY secret. Nothing runs on anyone else's credentials, and a run without a key ends cleanly with an explanation rather than failing.

Set the state, and check the city name

Every endpoint on this API requires the two letter state code. This is not a formality: the provider validates parameters before it checks your key, so a request without a state comes back as a bare rejection that mentions nothing else - and would come back the same way with a perfect key. This actor refuses such a run up front and says so, and never reports a missing-parameter rejection as a credential problem.

City names are the other quiet trap. The provider drops "City" and "Town" suffixes by its own naming rules, so "Ashville City" finds nothing while "Ashville" works. This actor strips those suffixes automatically, and validate city mode checks a name and returns the canonical spelling plus suggestions before you spend anything on it.

Occupancy is two different numbers

The provider reads the occupancy you supply as a percentage of the year or as nights per year, depending on a separate flag that defaults to percentage. Sending 65 meaning "65 percent" while the flag says nights is a silent five-fold error that propagates through every return it calculates, and nothing in the response says it happened.

So this actor takes the unit explicitly - percentage or nights - derives the flag from it, and writes the unit onto every investment row. You cannot get it wrong by accident, and you can tell afterwards which you used.

What this actor will not do

The provider's API also returns property owners' contact details, demographics, household income and wealth scores. Those endpoints are deliberately not implemented here. This actor reads property and market data, not personal information about named individuals.

Example output

{
  "recordType": "investment",
  "requested": "5505272",
  "found": true,
  "propertyId": "5505272",
  "address": "1823 Schyler Love Lane",
  "city": "El Paso",
  "state": "TX",
  "listPrice": 289000,
  "occupancyUnit": "percent",
  "airbnbRentalIncome": 3235,
  "airbnbOccupancy": 62,
  "airbnbCapRate": 7.41,
  "airbnbCashOnCash": 9.34,
  "airbnbCashFlow": 1204,
  "traditionalRentalIncome": 1270,
  "traditionalOccupancy": 95,
  "traditionalCapRate": 3.18,
  "traditionalCashOnCash": 1.92,
  "traditionalCashFlow": 213
}

FAQ

How do I calculate Airbnb ROI for a property?

Run investment performance with the property ID and your own assumptions - purchase price, down payment, loan term, interest rate, occupancy, running costs. It returns cap rate, cash on cash return, monthly cash flow, total expenses and ROI for the short term strategy and the long term strategy in separate columns, so you can see which one the property is actually for. Investment breakdown does the same one strategy at a time with a monthly and annual split.

What is the difference between cap rate and cash on cash return?

Cap rate is net operating income over the purchase price, ignoring how you paid for it. Cash on cash return is annual cash flow over the cash you actually put in, so it moves with the mortgage. A cash purchase makes the two converge; a heavily financed one pulls them apart. Both are returned for both strategies.

How do I find Airbnb rental comps near a property?

Run Airbnb comps with the neighborhood ID and, optionally, the property ID of the subject. It returns nearby short term rentals with matching bedroom and bathroom counts, each with its nightly rate, occupancy, modelled income, review count and distance, sorted by similarity, occupancy, income or distance. The provider's own default page size is three, which is not a comp set, so this actor asks for twenty unless you say otherwise. Long term comps does the equivalent for traditional leases by city or ZIP code.

What rent can I get for a property in this area?

Run rent estimate with a city, ZIP code or neighborhood and a strategy. It returns the studio through four bedroom values for the area, the sample count behind them, and a detail row per bedroom tier with the minimum, maximum, average and median rent - plus the rental income adjusted for the provider's vacancy assumption, which is the number to use in an underwriting model rather than the raw average.

Is short term renting legal in a given city?

Run short term regulations with a state and city. It returns the legal status, the regulation rating, whether a permit is required, occupancy limits, minimum stay requirements and a link to the official source. Worth running before any of the revenue modes: a strong Airbnb cap rate in a city that bans short lets is not an investment case.

What market data can I get for a city or ZIP code?

Market lookup gives cap rate, occupancy, median home price, nightly rate and rental income for a city, ZIP, neighborhood or address. Revenue stats adds the percentiles behind those medians. Property types breaks the market down by home type with counts and per-type income. Market history returns rental income, nightly rate and occupancy month by month with year on year changes. Amenity performance says what each amenity is associated with in revenue terms. Top markets, top Airbnb cities and top neighborhoods rank locations within a state.

How do I find a neighborhood ID?

Run city neighborhoods with a state and city. Every other neighborhood-level mode takes that identifier. Top neighborhoods returns the highest-occupancy ones directly.

Why can I only see inactive MLS listings?

Because MLS redistribution rules restrict what can be shared through a third-party API. The provider states that MLS data shared this way is limited to inactive listings. Active for-sale inventory comes through the listing search and nearby property modes instead.

Can I get owner contact details?

Not through this actor. The provider's API does expose owner contact, demographic and financial endpoints, and they are deliberately left out here - this actor returns property and market data, not personal information about named individuals.

What does it cost?

Pricing is per result. You pay for rows that carry a real record: a listing, a property, an investment analysis, a rent estimate, a short term listing, a performance period, a market, a statistic, a tax or sale record, a valuation, a regulation or a school. Addresses the provider cannot match, markets with no coverage and searches that find nothing are all free. Apify platform usage is included in the per-result price.

Does the actor fail if my key is wrong?

No. A missing key, a refused key, an exhausted plan allowance and an input that needs filling in all end the run cleanly with the reason as the run's status message. Only a real fault - a provider outage, or a bug here - fails a run.

Keyword map

real estate investment API, Airbnb data API, short term rental data API, rental property ROI calculator API, cap rate API, cash on cash return data, Airbnb occupancy rate data, Airbnb revenue estimate API, rental comps API, long term rental comps, rent estimate by ZIP code, US property records API, property sale history API, property tax history data, MLS listings data, real estate market data API, short term rental regulations by city, VRBO listing data, investment property search API, neighborhood investment data.