POST /v1/external/analysis/create/buy
Kaufanalyse erstellen
Erstellen Sie eine neue Kaufanalyse für eine Immobilie. Erfordert Immobiliendetails, Standortinformationen und Kaufpreis.
Standortparameter (Bedingt)
⚠️ Geben Sie entweder lat UND lng an ODER geben Sie fullAddress an. Mindestens eine Methode ist erforderlich.
latnumberBreitengrad (muss mit lng angegeben werden, wenn fullAddress nicht verwendet wird)
Beispiel: 27.7676
lngnumberLängengrad (muss mit lat angegeben werden, wenn fullAddress nicht verwendet wird)
Beispiel: -82.6403
fullAddressstringVollständige Immobilienadresse (kann anstelle von lat/lng-Koordinaten verwendet werden)
Beispiel: 4935 2nd Avenue North, St. Petersburg, FL 33703
Erforderliche Parameter
purchasePriceUSDnumberKaufpreis in USD
Beispiel: 350000
bedroomsnumberAnzahl der Schlafzimmer
Beispiel: 3
bathroomsnumberAnzahl der Badezimmer
Beispiel: 2
accomodatesnumberAnzahl der Gäste, die die Immobilie aufnehmen kann
Beispiel: 6
Optionale Parameter
monthlyRentUSDnumberErwartete monatliche Miete in USD für langfristige Vermietung
Beispiel: 2500
interestRatePercentagenumberZinssatz in Prozent (0-15)
Beispiel: 5.1
downPaymentPercentagenumberAnzahlungsprozentsatz (0-40)
Beispiel: 25
mortgageLengthnumberHypothekenlaufzeit in Jahren (0-30)
Beispiel: 15
squareFeetnumberQuadratfußzahl der Immobilie
Beispiel: 1500
statestringName des Staates
Beispiel: Florida
citystringStadtname
Beispiel: St. Petersburg
countystringName des Landkreises
Beispiel: Pinellas County
postalCodestringPostleitzahl
Beispiel: 33703
countrystringName des Landes
Beispiel: United States
streetstringStraßenname
Beispiel: 2nd Avenue North
streetNumberstringHausnummer
Beispiel: 4935
unitstringWohnungs-/Einheitsnummer, falls zutreffend
addAICompsbooleanSelect comparables with AI and apply the resulting revenue benchmark. US properties only, and requires at least 8 usable listing photos for the address.
Beispiel: true
addAIExpenseEstimatesbooleanEstimate operating expenses with AI instead of using category defaults
Beispiel: true
curl -X POST \
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy' \
-H "x-bnbcalc-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}'const response = await fetch(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
{
method: 'POST',
headers: {
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
})
}
);
const data = await response.json();import json
import requests
data = json.loads(r'''{
"lat": 27.7676,
"lng": -82.6403,
"bedrooms": 3,
"bathrooms": 2,
"accomodates": 6,
"purchasePriceUSD": 400000
}''')
response = requests.post(
'https://atlas.bnbcalc.com/v1/external/analysis/create/buy',
headers={
'x-bnbcalc-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
json=data
)
data = response.json()Beispielantwort
{
"success": true,
"data": {
"_id": "000000000000000000000000",
"url": "https://www.bnbcalc.com/analysis/example-property/000000000000000000000000",
"currency": "USD",
"ratePerNightUSD": 364.73770491803276,
"occupancyRatePercentage": 48,
"bedrooms": 4,
"bathrooms": 4,
"commonSpaces": 1,
"accomodates": 12,
"fullAddress": "4935 2nd Avenue North, St. Petersburg, FL 33703",
"location": {
"type": "Point",
"coordinates": [
-82.6403,
27.7676
]
},
"revenue": {
"p25": 48210,
"p50": 58440,
"p75": 63944.76398163934,
"p90": 74280,
"avg": 60310
},
"adr": {
"p25": 214,
"p50": 288,
"p75": 364.73770491803276,
"p90": 431,
"avg": 318
},
"occupancy": {
"p25": 0.38,
"p50": 0.44,
"p75": 0.48,
"p90": 0.56,
"avg": 0.46
},
"quartiles": {
"25th_percentile": {
"average_daily_rate": 214,
"occupancy_rate": 38,
"revenue": 48210
},
"50th_percentile": {
"average_daily_rate": 288,
"occupancy_rate": 44,
"revenue": 58440
},
"75th_percentile": {
"average_daily_rate": 364.73770491803276,
"occupancy_rate": 48,
"revenue": 63944.76398163934
},
"90th_percentile": {
"average_daily_rate": 431,
"occupancy_rate": 56,
"revenue": 74280
}
},
"comparables": [
{
"airbnbId": "12345678",
"name": "Modern 4BR near downtown",
"listingUrl": "https://www.airbnb.com/rooms/12345678",
"bedrooms": 4,
"bathrooms": 3,
"accommodates": 10,
"annualRevenueUSD": 68420,
"occupancyRatePercentage": 52,
"averageDailyRateUSD": 361,
"distanceMiles": 0.4,
"photo_urls": [
"https://a0.muscache.com/im/pictures/example/cover.jpg",
"https://a0.muscache.com/im/pictures/example/living-room.jpg",
"https://a0.muscache.com/im/pictures/example/kitchen.jpg"
]
}
],
"downPaymentPercentage": 20,
"mortgageLength": 30,
"yearsRemainingOnMortgage": 30,
"interestRatePercentage": 4,
"propertyTaxPercentage": 0.75,
"monthlyRevenueUSD": 5328.730331803278,
"monthlyExpensesUSD": 1474.1603364983607,
"monthlyTaxesUSD": 250,
"yearOneRevenueUSD": 63944.76398163934,
"yearOneOperatingIncomeUSD": 46254.83994365901,
"yearOneMorgageAndTaxesUSD": 21324,
"yearOneCashFlowUSD": 24930.83994365901,
"yearOneCashOnCashPercentage": 24.86817214984141,
"yearOneCapRatePercentage": 11.563709985914752,
"yearOneReturnOnInvestmentPercentage": 63.78402823049849,
"yearOnePrincipalPaydownUSD": 85635.31658640636,
"yearOnePrincipalPaidUSD": 5635.31658640636,
"yearOneAppreciationUSD": 12000,
"totalCashInvestment": 100252,
"ltrPerMonthUSD": 1500,
"ltrMonthlyExpensesPercentage": 10,
"revenueBasis": "full_time_potential",
"actualAnnualRevenue": {
"p25": 24180,
"p50": 36920,
"p75": 47350,
"p90": 58810,
"average": 37640
}
}
}