{
  "name": "HomePulse",
  "description": "Global home intelligence API for buyers, sellers, owners, and renters, in any country. 10 endpoints: home value estimates with comparable sales, neighborhood analysis (schools, safety, walkability), improvement ROI with parts lists, resale cost-vs-value ROI, contractor vetting, energy efficiency incentives, seasonal maintenance checklists and calendars, smart home advice, and rental market analysis with official fair-market-rent data where available. Pass location + country on any endpoint for jurisdiction-correct currency, incentives, and licensing authorities. Pay-per-query via x402 micropayments on Base.",
  "url": "https://homepulse.theaslangroupllc.com",
  "version": "1.3.0",
  "capabilities": [
    "home-value-estimation",
    "comparable-sales-analysis",
    "neighborhood-profiling",
    "school-ratings",
    "safety-analysis",
    "walkability-scoring",
    "improvement-roi-analysis",
    "resale-cost-vs-value-roi",
    "contractor-vetting",
    "energy-efficiency-incentives",
    "diy-vs-contractor-guidance",
    "amazon-parts-links",
    "seasonal-maintenance-checklists",
    "seasonal-maintenance-calendar",
    "smart-home-recommendations",
    "rental-market-analysis",
    "fair-market-rent-benchmarks",
    "jurisdiction-aware-guidance"
  ],
  "data_sources": [
    "HUD Fair Market Rent API (huduser.gov) — official US government FMR data by county/state, free token required (US only)",
    "Tavily — real-time market data, neighborhood research, contractor licensing, comparable sales; queries adapt to country/location",
    "Claude — synthesis and plain-English, jurisdiction-correct analysis"
  ],
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc"
  },
  "endpoints": [
    { "path": "/api/home/value", "method": "GET", "description": "Home value estimate with comparable sales, market trend, confidence rating, and best time to act. Works for any country.", "parameters": [{"name": "address", "required": false}, {"name": "location", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/neighborhood", "method": "GET", "description": "Neighborhood analysis — school ratings, relative safety, walkability, character, demographics, best-for breakdown. Jurisdiction-aware HOA and flood-risk guidance.", "parameters": [{"name": "location", "required": false}, {"name": "city", "required": false}, {"name": "state", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/improve", "method": "GET", "description": "Home improvement ROI analysis — cost, value added, recoup rating, DIY vs contractor, permit/planning-permission guidance by jurisdiction, materials list with Amazon links.", "parameters": [{"name": "project", "required": true}, {"name": "home_value", "required": false}, {"name": "location", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/roi", "method": "GET", "description": "Home improvement resale ROI — US NAR Cost vs Value data, or the closest local benchmark for non-US countries.", "parameters": [{"name": "project", "required": true}, {"name": "region", "required": false}, {"name": "country", "required": false}, {"name": "home_value", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/contractor", "method": "GET", "description": "Contractor vetting guide — licensing/registration authority, insurance requirements, red flags, contract checklist, correct for the stated country's regulatory regime.", "parameters": [{"name": "trade", "required": true}, {"name": "location", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/energy", "method": "GET", "description": "Home energy efficiency — improvements ranked by payback period with the country-correct incentive program applied.", "parameters": [{"name": "home_type", "required": false}, {"name": "location", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "age", "required": false}, {"name": "sqft", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.10, "payment_required": true },
    { "path": "/api/home/maintain", "method": "GET", "description": "Seasonal maintenance checklist — prioritized tasks with cost estimates, DIY feasibility, and tools/supplies with Amazon links. Hemisphere-corrected seasons.", "parameters": [{"name": "season", "required": false}, {"name": "region", "required": false}, {"name": "country", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.08, "payment_required": true },
    { "path": "/api/home/maintenance", "method": "GET", "description": "Full personalized seasonal maintenance calendar by region, home age, features, and country.", "parameters": [{"name": "region", "required": true}, {"name": "country", "required": false}, {"name": "home_age", "required": false}, {"name": "season", "required": false}, {"name": "features", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.08, "payment_required": true },
    { "path": "/api/home/smart", "method": "GET", "description": "Smart home ecosystem advisor — Matter compatibility, device recommendations, ecosystem fit, plug/voltage/availability notes by country.", "parameters": [{"name": "ecosystem", "required": false}, {"name": "room", "required": false}, {"name": "budget", "required": false}, {"name": "country", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.08, "payment_required": true },
    { "path": "/api/home/rent", "method": "GET", "description": "Rental market analysis — price ranges by bedroom, market trend, official fair-market-rent benchmark where available (US HUD FMR only), best neighborhoods, and renting vs buying.", "parameters": [{"name": "location", "required": false}, {"name": "city", "required": false}, {"name": "state", "required": false}, {"name": "country", "required": false}, {"name": "zip", "required": false, "note": "legacy alias for location"}, {"name": "bedrooms", "required": false}, {"name": "county", "required": false}, {"name": "lang", "required": false}], "price_usd": 0.08, "payment_required": true }
  ],
  "openapi": "https://homepulse.theaslangroupllc.com/openapi.json",
  "llms_txt": "https://homepulse.theaslangroupllc.com/llms.txt",
  "contact": "https://homepulse.theaslangroupllc.com"
}