Realtor Mortgage Calculator

This Apify actor calculates detailed mortgage payments and loan information across multiple locations with various loan types.

Features

• ✅ Calculate mortgage payments for multiple locations
• ✅ Support for various loan types (30-year, 15-year, ARM, FHA, VA)
• ✅ Includes property tax and insurance
• ✅ Detailed payment breakdowns
• ✅ Amortization schedules
• ✅ Total interest calculations
• ✅ Async processing for better performance
• ✅ Immediate data push (results available as they're fetched)

Input Parameters

The actor accepts the following input:

{
  "locations": ["New York, NY", "Los Angeles, CA"],
  "price": 500000,
  "down_payment": 100000,
  "loan_type_display": "30-year fixed",
  "property_tax": 10000,
  "home_insurance": 2000
}

Parameters

Parameter	Type	Required	Description
locations	array	Yes	List of locations for calculation
price	number	Yes	Home purchase price in dollars
down_payment	number	Yes	Down payment amount in dollars
loan_type_display	string	Yes	Type of mortgage loan
property_tax	integer	Yes	Annual property tax in dollars
home_insurance	integer	Yes	Annual homeowners insurance in dollars

Available Loan Types

• 30-year fixed - Traditional 30-year fixed-rate mortgage
• 20-year fixed - 20-year fixed-rate mortgage
• 15-year fixed - 15-year fixed-rate mortgage
• 10-year fixed - 10-year fixed-rate mortgage
• 7/1 ARM - 7-year adjustable-rate mortgage
• 5/1 ARM - 5-year adjustable-rate mortgage
• FHA 30-year fixed - FHA-insured 30-year fixed-rate
• VA 30-year fixed - VA-backed 30-year fixed-rate

Output

The actor outputs comprehensive mortgage calculations:

{
  "location": "New York, NY",
  "loan_details": {
    "loan_amount": 400000,
    "interest_rate": 6.5,
    "loan_type": "30-year fixed",
    "term_months": 360,
    "down_payment_percent": 20
  },
  "monthly_payment": {
    "principal_and_interest": 2528,
    "property_tax": 833,
    "home_insurance": 167,
    "pmi": 0,
    "total": 3528
  },
  "loan_summary": {
    "total_payments": 1270080,
    "total_interest": 510080,
    "total_principal": 400000,
    "total_with_down_payment": 1370080
  },
  "amortization_summary": {
    "first_year_interest": 25920,
    "first_year_principal": 4416,
    "year_5_balance": 374382,
    "year_10_balance": 341256,
    "year_15_balance": 299874,
    "payoff_date": "2054-11-12"
  },
  "affordability": {
    "monthly_income_needed": 10584,
    "annual_income_needed": 127008,
    "debt_to_income_ratio": 0.333
  }
}

Results are pushed to the dataset immediately as each location is processed.

Usage Example

Via Apify Console

1. Go to your actor's input tab
2. Enter your mortgage details:

   {
     "locations": ["San Francisco, CA", "Austin, TX", "Miami, FL"],
     "price": 750000,
     "down_payment": 150000,
     "loan_type_display": "30-year fixed",
     "property_tax": 12000,
     "home_insurance": 2500
   }
   

3. Click "Start"

Via API

Use Cases

Compare Mortgage Rates Across Cities

Different locations may have different rates and programs:

{
  "locations": ["New York, NY", "Texas", "Florida", "California"],
  "price": 500000,
  "down_payment": 100000,
  "loan_type_display": "30-year fixed",
  "property_tax": 10000,
  "home_insurance": 2000
}

15-Year vs 30-Year Comparison

Run twice with different loan types to compare:

{
  "locations": ["Denver, CO"],
  "price": 450000,
  "down_payment": 90000,
  "loan_type_display": "15-year fixed",
  "property_tax": 8000,
  "home_insurance": 1500
}

FHA Loan with Lower Down Payment

{
  "locations": ["Phoenix, AZ"],
  "price": 300000,
  "down_payment": 10500,
  "loan_type_display": "FHA 30-year fixed",
  "property_tax": 5000,
  "home_insurance": 1200
}

VA Loan for Veterans

{
  "locations": ["San Diego, CA"],
  "price": 600000,
  "down_payment": 0,
  "loan_type_display": "VA 30-year fixed",
  "property_tax": 9000,
  "home_insurance": 2000
}

ARM vs Fixed Rate

{
  "locations": ["Boston, MA"],
  "price": 550000,
  "down_payment": 110000,
  "loan_type_display": "5/1 ARM",
  "property_tax": 11000,
  "home_insurance": 2200
}

Understanding the Output

Monthly Payment Breakdown

• Principal & Interest: Core mortgage payment
• Property Tax: Annual tax divided by 12
• Home Insurance: Annual insurance divided by 12
• PMI: Private mortgage insurance (if down payment < 20%)
• Total: Complete monthly payment

Loan Summary

• Total Payments: Sum of all monthly payments
• Total Interest: Total interest paid over loan life
• Total Principal: Original loan amount
• Total with Down Payment: Complete cost of the home

Amortization Details

• Early Years: More interest, less principal
• Later Years: More principal, less interest
• Balance Milestones: Remaining balance at key points
• Payoff Date: When loan will be fully paid

Affordability Metrics

• Monthly Income Needed: Based on 28% front-end ratio
• Annual Income Needed: Monthly × 12
• Debt-to-Income: Monthly payment as % of income

Loan Type Differences

Fixed-Rate Mortgages

• 30-year: Lower monthly payment, more total interest
• 15-year: Higher monthly payment, less total interest, build equity faster
• 10-year: Highest payment, lowest total interest, fastest equity

Adjustable-Rate Mortgages (ARM)

• 5/1 ARM: Fixed for 5 years, then adjusts annually
• 7/1 ARM: Fixed for 7 years, then adjusts annually
• Lower initial rate, but rate can increase

Government-Backed Loans

• FHA: Lower down payment (3.5%), mortgage insurance required
• VA: No down payment for veterans, no PMI

Tips for Accurate Calculations

1. Down Payment: 20% or more avoids PMI
2. Property Tax: Check local rates (varies widely)
3. Insurance: Get quotes for accurate amounts
4. Loan Type: Consider how long you'll stay in the home
5. Rate Shopping: Compare across multiple lenders

Error Handling

• Missing required parameters are caught and reported
• API errors are logged with detailed messages
• Failed calculations for specific locations don't stop other locations
• All parameters are validated before API calls