Referencja API

punkty końcowe

POSTUtwórz analizę zakupu POSTUtwórz analizę arbitrażu POSTUtwórz własną analizę POSTUtwórz analizę Cohost

ZASOBY

Pierwsze kroki Uwierzytelnianie Kody błędów

Poradniki API

Cennik API Przykłady użycia API Punkty końcowe API Jak zacząć Pokrycie danych Porównanie API

Dokumentacja API danych Airbnb

Witamy w API BNBCalc. Ta dokumentacja pomoże Ci zintegrować analizę nieruchomości krótkoterminowych w Twojej aplikacji.

Użyj API danych Airbnb BNBCalc, aby uzyskać przychody z nieruchomości, obłożenie, ADR, aktywne porównywalne oferty Airbnb, percentyle, metryki inwestycyjne i publiczne adresy URL raportów do aplikacji, raportów, oceny ryzyka i narzędzi zarządzania.

Pierwsze kroki

Aby rozpocząć korzystanie z API danych Airbnb BNBCalc, będziesz musiał:

1. Utwórz konto BNBCalc lub zaloguj się do istniejącego konta

2. Przejdź do ustawień konta, aby wygenerować klucz API

3. Dołącz swój klucz API do wszystkich żądań API, używając nagłówka x-bnbcalc-api-key.

4. Zacznij wysyłać zapytania, aby uzyskać dostęp do danych i analiz nieruchomości.

Wszystkie punkty końcowe API korzystają z HTTPS i zwracają odpowiedzi w formacie JSON. Przechowuj klucze API na swoim serwerze, nie w kodzie przeglądarki lub klienta mobilnego. Zewnętrzne trasy API są obecnie ograniczone do 100 żądań na sekundę i używają standardowych kodów odpowiedzi HTTP, aby wskazać sukces lub porażkę.

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelnienia za pomocą klucza API. Klucze API są powiązane z Twoim kontem BNBCalc, powinny być przechowywane po stronie serwera i nigdy nie powinny być ujawniane w kodzie front-end. Dodaj swój klucz API do nagłówka żądania, jak pokazano poniżej:

x-bnbcalc-api-key: YOUR_API_KEY

Możesz wygenerować klucze API samodzielnie z sekcji ustawień konta. Do każdego żądania API dołącz nagłówek x-bnbcalc-api-key, aby się uwierzytelnić.

POST/v1/external/analysis/create/buy

Utwórz analizę zakupu

Utwórz nową analizę zakupu nieruchomości. Wymaga szczegółów dotyczących nieruchomości, informacji o lokalizacji oraz ceny zakupu.

Parametry Lokalizacji (Warunkowe)

⚠️ Podaj lat I lng, LUB podaj fullAddress. Wymagana jest co najmniej jedna metoda.

latnumberwarunkowe

Współrzędna szerokości geograficznej (musi być podana z lng, jeśli fullAddress nie jest używany)(e.g., 27.7676)

lngnumberwarunkowe

Współrzędna długości geograficznej (musi być podana z lat, jeśli fullAddress nie jest używany)(e.g., -82.6403)

fullAddressstringwarunkowe

Pełny adres nieruchomości (może być używany zamiast współrzędnych lat/lng)(e.g., 4935 2nd Avenue North, St. Petersburg, FL 33703)

Parametry Wymagane

purchasePriceUSDnumberwymagane

Cena zakupu w USD(e.g., 350000)

bedroomsnumberwymagane

Liczba sypialni(e.g., 3)

bathroomsnumberwymagane

Liczba łazienek(e.g., 2)

accomodatesnumberwymagane

Liczba gości, których nieruchomość może pomieścić(e.g., 6)

Parametry Opcjonalne

monthlyRentUSDnumberopcjonalne

Oczekiwany miesięczny czynsz w USD za wynajem długoterminowy(e.g., 2500)

interestRatePercentagenumberopcjonalne

Oprocentowanie w procentach (0-15)(e.g., 5.1)

squareFeetnumberopcjonalne

Powierzchnia nieruchomości w stopach kwadratowych(e.g., 1500)

statestringopcjonalne

Nazwa stanu(e.g., Florida)

citystringopcjonalne

Nazwa miasta(e.g., St. Petersburg)

countystringopcjonalne

Nazwa hrabstwa(e.g., Pinellas County)

postalCodestringopcjonalne

Kod pocztowy(e.g., 33703)

countrystringopcjonalne

Nazwa kraju(e.g., United States)

streetstringopcjonalne

Nazwa ulicy(e.g., 2nd Avenue North)

streetNumberstringopcjonalne

Numer domu(e.g., 4935)

unitstringopcjonalne

Numer jednostki/mieszkania, jeżeli dotyczy

Przykładowe zapytanie

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()

Przykładowa odpowiedź

{
  "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
      }
    ],
    "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,
    "yearOneAppreciationUSD": 12000,
    "totalCashInvestment": 100252,
    "ltrPerMonthUSD": 1500,
    "ltrMonthlyExpensesPercentage": 10
  }
}

POST/v1/external/analysis/create/arb

Utwórz analizę arbitrażu

Utwórz nową analizę arbitrażu (arbitraż najmu) dla nieruchomości. Używa tych samych wymaganych pól co analiza zakupu.

Parametry Lokalizacji (Warunkowe)

⚠️ Podaj lat I lng, LUB podaj fullAddress. Wymagana jest co najmniej jedna metoda.

latnumberwarunkowe

Współrzędna szerokości geograficznej (musi być podana z lng, jeśli fullAddress nie jest używany)(e.g., 27.7676)

lngnumberwarunkowe

Współrzędna długości geograficznej (musi być podana z lat, jeśli fullAddress nie jest używany)(e.g., -82.6403)

fullAddressstringwarunkowe

Pełny adres nieruchomości (może być używany zamiast współrzędnych lat/lng)(e.g., 4935 2nd Avenue North, St. Petersburg, FL 33703)

Parametry Wymagane

monthlyRentUSDnumberwymagane

Oczekiwany miesięczny czynsz w USD za wynajem długoterminowy(e.g., 2500)

bedroomsnumberwymagane

Liczba sypialni(e.g., 3)

bathroomsnumberwymagane

Liczba łazienek(e.g., 2)

accomodatesnumberwymagane

Liczba gości, których nieruchomość może pomieścić(e.g., 6)

Parametry Opcjonalne

purchasePriceUSDnumberopcjonalne

Cena zakupu w USD(e.g., 350000)

squareFeetnumberopcjonalne

Powierzchnia nieruchomości w stopach kwadratowych(e.g., 1500)

statestringopcjonalne

Nazwa stanu(e.g., Florida)

citystringopcjonalne

Nazwa miasta(e.g., St. Petersburg)

countystringopcjonalne

Nazwa hrabstwa(e.g., Pinellas County)

postalCodestringopcjonalne

Kod pocztowy(e.g., 33703)

countrystringopcjonalne

Nazwa kraju(e.g., United States)

streetstringopcjonalne

Nazwa ulicy(e.g., 2nd Avenue North)

streetNumberstringopcjonalne

Numer domu(e.g., 4935)

unitstringopcjonalne

Numer jednostki/mieszkania, jeżeli dotyczy

Przykładowe zapytanie

curl -X POST \
  https://atlas.bnbcalc.com/v1/external/analysis/create/arb \
  -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,
  "monthlyRentUSD": 2000
}'

const response = await fetch(
  'https://atlas.bnbcalc.com/v1/external/analysis/create/arb',
  {
    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,
  "monthlyRentUSD": 2000
})
  }
);
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,
  "monthlyRentUSD": 2000
}''')

response = requests.post(
    'https://atlas.bnbcalc.com/v1/external/analysis/create/arb',
    headers={
        'x-bnbcalc-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=data
)
data = response.json()

Przykładowa odpowiedź

{
  "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
      }
    ],
    "monthlyRentUSD": 2000,
    "yearOneRentUSD": 24000,
    "monthlyRevenueUSD": 13432.825977452352,
    "monthlyExpensesUSD": 2263.6108575197586,
    "yearOneRevenueUSD": 161193.91172942822,
    "yearOneOperatingIncomeUSD": 134030.58143919113,
    "yearOneCashFlowUSD": 110030.58143919116,
    "yearOneCashOnCashPercentage": 1317.415965507557,
    "totalCashInvestment": 8352
  }
}

POST/v1/external/analysis/create/owned

Utwórz własną analizę

Utwórz nową analizę posiadanej nieruchomości. Wykorzystuje te same wymagane pola, co analiza zakupu.

Parametry Lokalizacji (Warunkowe)

⚠️ Podaj lat I lng, LUB podaj fullAddress. Wymagana jest co najmniej jedna metoda.

latnumberwarunkowe

Współrzędna szerokości geograficznej (musi być podana z lng, jeśli fullAddress nie jest używany)(e.g., 27.7676)

lngnumberwarunkowe

Współrzędna długości geograficznej (musi być podana z lat, jeśli fullAddress nie jest używany)(e.g., -82.6403)

fullAddressstringwarunkowe

Pełny adres nieruchomości (może być używany zamiast współrzędnych lat/lng)(e.g., 4935 2nd Avenue North, St. Petersburg, FL 33703)

Parametry Wymagane

purchasePriceUSDnumberwymagane

Cena zakupu w USD(e.g., 350000)

downPaymentPercentagenumberwymagane

Procentowy wkład własny (0-40)(e.g., 20)

interestRatePercentagenumberwymagane

Oprocentowanie w procentach (0-15)(e.g., 5.1)

mortgageLengthnumberwymagane

Okres kredytowania hipotecznego w latach (0-30)(e.g., 30)

yearsRemainingOnMortgagenumberwymagane

Pozostałe lata kredytu hipotecznego (Nie mogą być wyższe niż okres kredytu hipotecznego)

bedroomsnumberwymagane

Liczba sypialni(e.g., 3)

bathroomsnumberwymagane

Liczba łazienek(e.g., 2)

accomodatesnumberwymagane

Liczba gości, których nieruchomość może pomieścić(e.g., 6)

Parametry Opcjonalne

monthlyRentUSDnumberopcjonalne

Oczekiwany miesięczny czynsz w USD za wynajem długoterminowy(e.g., 2500)

squareFeetnumberopcjonalne

Powierzchnia nieruchomości w stopach kwadratowych(e.g., 1500)

statestringopcjonalne

Nazwa stanu(e.g., Florida)

citystringopcjonalne

Nazwa miasta(e.g., St. Petersburg)

countystringopcjonalne

Nazwa hrabstwa(e.g., Pinellas County)

postalCodestringopcjonalne

Kod pocztowy(e.g., 33703)

countrystringopcjonalne

Nazwa kraju(e.g., United States)

streetstringopcjonalne

Nazwa ulicy(e.g., 2nd Avenue North)

streetNumberstringopcjonalne

Numer domu(e.g., 4935)

unitstringopcjonalne

Numer jednostki/mieszkania, jeżeli dotyczy

Przykładowe zapytanie

curl -X POST \
  https://atlas.bnbcalc.com/v1/external/analysis/create/owned \
  -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": 350000,
  "downPaymentPercentage": 20,
  "interestRatePercentage": 5.1,
  "mortgageLength": 30,
  "yearsRemainingOnMortgage": 30
}'

const response = await fetch(
  'https://atlas.bnbcalc.com/v1/external/analysis/create/owned',
  {
    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": 350000,
  "downPaymentPercentage": 20,
  "interestRatePercentage": 5.1,
  "mortgageLength": 30,
  "yearsRemainingOnMortgage": 30
})
  }
);
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": 350000,
  "downPaymentPercentage": 20,
  "interestRatePercentage": 5.1,
  "mortgageLength": 30,
  "yearsRemainingOnMortgage": 30
}''')

response = requests.post(
    'https://atlas.bnbcalc.com/v1/external/analysis/create/owned',
    headers={
        'x-bnbcalc-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=data
)
data = response.json()

Przykładowa odpowiedź

{
  "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
      }
    ],
    "downPaymentPercentage": 20,
    "mortgageLength": 30,
    "yearsRemainingOnMortgage": 30,
    "interestRatePercentage": 5.1,
    "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,
    "yearOneAppreciationUSD": 12000,
    "totalCashInvestment": 100252,
    "ltrPerMonthUSD": 1500,
    "ltrMonthlyExpensesPercentage": 10
  }
}

POST/v1/external/analysis/create/cohost

Utwórz analizę Cohost

Utwórz historię współgospodarzy

Parametry Lokalizacji (Warunkowe)

⚠️ Podaj lat I lng, LUB podaj fullAddress. Wymagana jest co najmniej jedna metoda.

latnumberwarunkowe

Współrzędna szerokości geograficznej (musi być podana z lng, jeśli fullAddress nie jest używany)(e.g., 27.7676)

lngnumberwarunkowe

Współrzędna długości geograficznej (musi być podana z lat, jeśli fullAddress nie jest używany)(e.g., -82.6403)

fullAddressstringwarunkowe

Pełny adres nieruchomości (może być używany zamiast współrzędnych lat/lng)(e.g., 4935 2nd Avenue North, St. Petersburg, FL 33703)

Parametry Wymagane

bedroomsnumberwymagane

Liczba sypialni(e.g., 3)

bathroomsnumberwymagane

Liczba łazienek(e.g., 2)

accomodatesnumberwymagane

Liczba gości, których nieruchomość może pomieścić(e.g., 6)

Parametry Opcjonalne

cohostCommissionPercentagenumberopcjonalne

Procent prowizji współgospodarza(e.g., 10)

squareFeetnumberopcjonalne

Powierzchnia nieruchomości w stopach kwadratowych(e.g., 1500)

statestringopcjonalne

Nazwa stanu(e.g., Florida)

citystringopcjonalne

Nazwa miasta(e.g., St. Petersburg)

countystringopcjonalne

Nazwa hrabstwa(e.g., Pinellas County)

postalCodestringopcjonalne

Kod pocztowy(e.g., 33703)

countrystringopcjonalne

Nazwa kraju(e.g., United States)

streetstringopcjonalne

Nazwa ulicy(e.g., 2nd Avenue North)

streetNumberstringopcjonalne

Numer domu(e.g., 4935)

unitstringopcjonalne

Numer jednostki/mieszkania, jeżeli dotyczy

Przykładowe zapytanie

curl -X POST \
  https://atlas.bnbcalc.com/v1/external/analysis/create/cohost \
  -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
}'

const response = await fetch(
  'https://atlas.bnbcalc.com/v1/external/analysis/create/cohost',
  {
    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
})
  }
);
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
}''')

response = requests.post(
    'https://atlas.bnbcalc.com/v1/external/analysis/create/cohost',
    headers={
        'x-bnbcalc-api-key': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json=data
)
data = response.json()

Przykładowa odpowiedź

{
  "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
      }
    ],
    "yearOneRevenueUSD": 161193.91172942825,
    "yearOneCohostReturnUSD": 116059.61644518835,
    "yearOneCohostCommissionUSD": 32238.78234588565
  }
}

Kody błędów

API BNBCalc używa standardowych kodów statusu odpowiedzi HTTP, aby wskazać sukces lub porażkę żądań API. Pomyślnie utworzone raporty zwracają kody 2xx, podczas gdy błędy zwracają kody 4xx lub 5xx z dodatkowymi informacjami o błędzie w treści odpowiedzi. Będziesz obciążany tylko za pomyślnie utworzone raporty.

200

Sukces

400

Błędne żądanie - Nieprawidłowe parametry

401

Nieautoryzowany - Nieprawidłowy klucz API

429

Zbyt wiele żądań - Przekroczono limit trasy API zewnętrznego

500

Wewnętrzny błąd serwera