{"uid":"cap_O6Q0nMIgtkSRdaAVvi_5d","slug":"sparks-re-api-analyze-listing-url-889027bc","name":"Sparks RE API — Analyze Listing URL","description":"Submit a listing webpage URL to scrape. Scrapes public details, extracts specs, and auto-calculates compliance and financials in a single report. Recommends screenshot fallback if blocked. Cost: $0.05 USDC.","url":"https://sparks-re-api.sparksdigital-re.workers.dev/property/analyze-url?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"Real estate listing webpage URL"}}},"responseSchema":{"type":"json","example":{"fha_report":{"is_compliant":true,"flagged_phrases":[],"violation_count":0,"compliant_rewrite":"..."},"listing_data":{"zip":"46204","city":"Indianapolis","state":"IN","address":"123 Main St","bedrooms":3,"lot_size":"0.20 acres","bathrooms":2,"raw_price":"$250,000","year_built":2010,"square_feet":1500,"monthly_rent":2000,"property_type":"SFR"},"investor_metrics":{"dscr":1.19,"annual_noi":15480,"loan_amount":200000,"down_payment":50000,"monthly_rent":2000,"purchase_price":250000,"cap_rate_percent":6.19,"monthly_cashflow":-40.6,"monthly_expenses":2040.6,"monthly_mortgage":1330.6,"cash_on_cash_percent":-0.97,"gross_rent_multiplier":10.42}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5As5dn423-XWis5SrKMjW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes a real estate listing webpage URL to extract property specs, run FHA compliance checks, and compute investor financial metrics in a single report.","exampleAgentPrompt":"Can you analyze this Zillow listing for me — https://www.zillow.com/homedetails/123-main-st/12345_zpid/ — and give me the property specs, whether it's FHA compliant, and the key investment numbers like cap rate and monthly cashflow?","exampleUseCases":[{"title":"Quick investor due diligence on a listing","prompt":"I found this property on Realtor.com — https://www.realtor.com/realestateandhomes-detail/456-Oak-Ave_Indianapolis_IN_46204_M12345 — can you pull the specs and tell me the cap rate, DSCR, and whether the cashflow is positive?"},{"title":"FHA compliance check before publishing","prompt":"Before my agent posts this listing live, can you scrape the page at https://www.homesnap.com/listing/789-Elm-St-Indianapolis-IN and flag any Fair Housing Act violations in the description?"},{"title":"Research comparable investment property","prompt":"I'm evaluating a rental property at https://www.redfin.com/IN/Indianapolis/321-Pine-St-46201/home/12345 — pull all the details and show me the NOI, gross rent multiplier, and down payment estimate."}],"resultDescription":"Returns a JSON object with three sections: listing_data (address, city, state, zip, bedrooms, bathrooms, square feet, lot size, year built, property type, raw price, monthly rent), fha_report (is_compliant flag, flagged phrases, violation count, compliant rewrite suggestion), and investor_metrics (purchase price, loan amount, down payment, monthly rent, monthly mortgage, monthly expenses, monthly cashflow, annual NOI, cap rate percent, cash-on-cash percent, DSCR, gross rent multiplier).","failureModes":["Listing page is behind a login wall or bot block — endpoint recommends using the screenshot fallback endpoint instead","URL is invalid or the page returns a 404 — extraction fails with an error","Listing page has non-standard HTML layout that prevents data parsing — partial or empty fields returned","Monthly rent not listed on the page — investor metrics may be incomplete or estimated","Scrape returns stale cached data if the listing has been updated recently"],"whenToPreferThis":"Use this endpoint when you have a direct URL to a real estate listing webpage and want a single-call pipeline that combines scraping, property data extraction, FHA compliance scanning, and investor financial calculations. Prefer it over the text-submission or screenshot endpoints when the listing URL is publicly accessible without authentication. If the page blocks scraping, fall back to the screenshot endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:20.949Z","isFirstParty":false,"canonicalSlug":"sparks-re-api-analyze-listing-url-889027bc"}