POST /v1/external/analysis/create/buy
Crea analisi di acquisto
Creare una nuova analisi d'acquisto per una proprietà. Richiede dettagli della proprietà, informazioni sulla posizione e prezzo d'acquisto.
Parametri di Posizione (Condizionali)
⚠️ Fornire lat E lng, OPPURE fornire fullAddress. È richiesto almeno un metodo.
latnumberCoordinata di latitudine (deve essere fornita con lng se fullAddress non è utilizzato)
Esempio: 27.7676
lngnumberCoordinata di longitudine (deve essere fornita con lat se fullAddress non è utilizzato)
Esempio: -82.6403
fullAddressstringIndirizzo completo della proprietà (può essere utilizzato al posto delle coordinate lat/lng)
Esempio: 4935 2nd Avenue North, St. Petersburg, FL 33703
Parametri Obbligatori
purchasePriceUSDnumberPrezzo di acquisto in USD
Esempio: 350000
bedroomsnumberNumero di camere da letto
Esempio: 3
bathroomsnumberNumero di bagni
Esempio: 2
accomodatesnumberNumero di ospiti che la proprietà può accogliere
Esempio: 6
Parametri Opzionali
monthlyRentUSDnumberAffitto mensile previsto in USD per un affitto a lungo termine
Esempio: 2500
interestRatePercentagenumberPercentuale del tasso d'interesse (0-15)
Esempio: 5.1
downPaymentPercentagenumberPercentuale di acconto (0-40)
Esempio: 25
mortgageLengthnumberDurata del mutuo in anni (0-30)
Esempio: 15
squareFeetnumberSuperficie in piedi quadrati della proprietà
Esempio: 1500
statestringNome dello stato
Esempio: Florida
citystringNome della città
Esempio: St. Petersburg
countystringNome della contea
Esempio: Pinellas County
postalCodestringCodice postale
Esempio: 33703
countrystringNome del paese
Esempio: United States
streetstringNome della strada
Esempio: 2nd Avenue North
streetNumberstringNumero civico
Esempio: 4935
unitstringNumero dell'unità o dell'appartamento, se applicabile
addAICompsbooleanSelect comparables with AI and apply the resulting revenue benchmark. US properties only, and requires at least 8 usable listing photos for the address.
Esempio: true
addAIExpenseEstimatesbooleanEstimate operating expenses with AI instead of using category defaults
Esempio: 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()Risposta di esempio
{
"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
}
}
}