{"uid":"cap_lPeTdhIwnPyhsz_n9zrL4","slug":"homepulse-home-improvement-roi-analyzer-a8aa6892","name":"HomePulse Home Improvement ROI Analyzer","description":"Home improvement cost and ROI estimate for any project (kitchen remodel, deck addition, bathroom remodel, and more): project cost, resale value added, DIY-vs-contractor guidance, and a parts/materials list. For homeowner and renovation agents. Takes a project and optional home value.","url":"https://homepulse-seven.vercel.app/api/home/improve","method":"GET","headers":{},"bodySchema":{"type":"object","required":["project"],"properties":{"zip":{"type":"string","description":"Legacy alias for location (ZIP/postal code)"},"lang":{"type":"string","description":"lang"},"country":{"type":"string","description":"Country (e.g. US, UK, CA, DE, AU) — sets currency and permit/planning-permission terminology"},"project":{"type":"string","description":"Project type (e.g. kitchen-remodel, deck-addition, new-roof)"},"location":{"type":"string","description":"Postal code or city (e.g. 90210, M5V 2T6, SW1A, Berlin)"},"home_value":{"type":"integer","description":"Current estimated home value, in local currency"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pdZns5Mqqz72RcDhJUpD0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a home improvement project and returns estimated costs, value added, DIY-vs-contractor guidance, and a parts list","exampleAgentPrompt":"Can you run a home improvement ROI analysis on adding a mid-range kitchen remodel to my 3-bedroom house in Austin, TX — I want to know the estimated cost, how much value it'll add, whether I should DIY or hire a contractor, and what parts I'd need?","exampleUseCases":null,"resultDescription":"Returns a structured analysis including estimated project cost, estimated value added to the home, calculated ROI percentage, a DIY-vs-contractor recommendation with rationale, and an itemized parts/materials list for the specified home improvement project.","failureModes":["Unrecognized or ambiguous project type returns an error or generic response","Missing location may reduce accuracy of cost and value estimates","Extremely niche or custom projects may yield low-confidence estimates","API returns 402 if payment header is missing or USDC payment fails","Rate limiting may occur for high-frequency callers"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive home improvement analysis that combines cost estimation, resale value impact, DIY feasibility guidance, and a materials list in a single call. Prefer this over the resale-ROI-only endpoint when the user also needs contractor vs. DIY guidance and a parts list, not just NAR Cost vs. Value data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:14.420Z","isFirstParty":false}