Use AirROI API with Postman

Install Postman

Download the Postman desktop app from postman.com/downloads for Windows, macOS, or Linux. Alternatively, use the web version directly in your browser at web.postman.co.

Create a New GET Request

Click the + tab to open a new request. Set the method dropdown to GET and enter the following URL:

https://api.airroi.com/calculator/estimate

Next, navigate to the Headers tab and add a new header:

Add Query Parameters

Switch to the Params tab in Postman and add the following key-value pairs. Postman will automatically append them to the URL.

Your complete URL should now read: https://api.airroi.com/calculator/estimate?lat=34.052235&lng=-118.243683&bedrooms=2&baths=1&guests=4&currency=usd

Send and Read the Response

Click the blue Send button. Postman will display the JSON response in the body panel below. Here is what each key field means:

{
  "revenue": 52400,
  "average_daily_rate": 195,
  "occupancy": 0.74,
  "percentiles": {
    "revenue": {
      "avg": 52400,
      "p25": 38200,
      "p50": 49800,
      "p75": 61500,
      "p90": 78300
    },
    "average_daily_rate": {
      "avg": 195,
      "p25": 145,
      "p50": 185,
      "p75": 235,
      "p90": 310
    },
    "occupancy": {
      "avg": 0.74,
      "p25": 0.58,
      "p50": 0.72,
      "p75": 0.85,
      "p90": 0.93
    }
  },
  "monthly_revenue_distributions": [
    3200, 3400, 4100, 4800, 5600, 5900,
    6200, 5800, 4600, 3900, 3100, 3800
  ],
  "comparable_listings": [
    {
      "listing_id": "12345678",
      "revenue": 48200,
      "average_daily_rate": 180,
      "occupancy": 0.73,
      "bedrooms": 2,
      "distance_miles": 0.3
    }
  ],
  "currency": "usd"
}

Try a POST Request

Some endpoints use POST requests with a JSON body. Let's search for Airbnb listings in Los Angeles. Create a new request, change the method to POST, and enter:

https://api.airroi.com/listings/search/market

Add the same X-API-KEY header, plus a Content-Type: application/json header. Then go to the Body tab, select raw, choose JSON from the dropdown, and paste:

{
  "market": {
    "country": "us",
    "region": "california",
    "locality": "los angeles"
  },
  "filter": {},
  "sort": {},
  "pagination": {
    "page_size": 10,
    "offset": 0
  },
  "currency": "usd"
}

Click Send. The response will contain an array of listings matching the market criteria, each with detailed property information, performance metrics, and pricing data. Use pagination.offset to page through results.

Export Results

Once you have a response you want to save, Postman gives you several options:

• Save as JSON — Click the three-dot menu next to the response body and select "Save Response" then "Save to a file". Choose a location and save the .json file for further analysis.

• Copy to clipboard — Click anywhere in the response body, press Ctrl+A (or Cmd+A) to select all, then copy. Paste into any text editor, spreadsheet, or data tool.

• Export collection — Right-click your collection in the sidebar and choose "Export". This saves all your requests, headers, and parameters as a portable JSON file you can share with colleagues.