{"uid":"cap_3He68Lrkx_QEglKbTGRUT","slug":"sparks-re-api-property-text-full-analysis-c47b0d4c","name":"Sparks RE API — Property Text Full Analysis","description":"Submit raw property text/MLS copy. Uses Gemini to extract property specs, scan for FHA compliance violations, and calculate investment financials in a single report. Cost: $0.05 USDC.","url":"https://sparks-re-api.sparksdigital-re.workers.dev/property/analyze-text?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","description":"Raw listing description copy"}}},"responseSchema":{"type":"json","example":{"fha_report":{"is_compliant":false,"flagged_phrases":[{"phrase":"Christian family/community","suggestion":"welcoming community","violation_category":"Religion"}],"violation_count":1,"compliant_rewrite":"..."},"listing_data":{"zip":"46220","city":"Indianapolis","state":"IN","address":"789 Maple Ave","bedrooms":3,"lot_size":"0.25 acres","bathrooms":2,"raw_price":"$295,000","year_built":1998,"square_feet":1850,"monthly_rent":2200,"property_type":"SFR"},"investor_metrics":{"dscr":1.12,"annual_noi":16908,"loan_amount":236000,"down_payment":59000,"monthly_rent":2200,"purchase_price":295000,"cap_rate_percent":5.73,"monthly_cashflow":-160.96,"monthly_expenses":2360.96,"monthly_mortgage":1569.96,"cash_on_cash_percent":-3.27,"gross_rent_multiplier":11.17}}},"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_epfCO7j7oyM4j6351l7zW","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":"Submits raw property listing text/MLS copy to extract structured specs, scan for FHA Fair Housing compliance violations, and compute investment financial metrics in one combined report.","exampleAgentPrompt":"Analyze this MLS listing copy for FHA Fair Housing violations and investment financials: 'Charming 3BR/2BA SFR in Indianapolis at 789 Maple Ave, asking $295,000, estimated rent $2,200/mo, built 1998, 1,850 sqft — perfect for a Christian family in a quiet community.'","exampleUseCases":[{"title":"FHA compliance check before publishing","prompt":"Before I post this listing, can you check it for any Fair Housing Act violations and suggest compliant rewrites? Here's the copy: 'Quiet neighborhood, great for families with traditional values, near a wonderful church community, 4BR/3BA at $420,000.'"},{"title":"Investor due diligence on raw MLS text","prompt":"I'm evaluating a rental property and only have the raw MLS text — can you pull out the key specs and tell me the cap rate, DSCR, and monthly cashflow? Here's the description: '2BR/1BA duplex in Columbus OH, asking $180,000, estimated rent $1,400/mo, built 2002, 950 sqft per unit.'"},{"title":"Automated listing audit for property manager","prompt":"Run a full analysis on this listing description I received from an agent — I need the structured property data, any Fair Housing red flags with suggested fixes, and the investor return numbers all in one shot: 'Spacious SFR in Austin, 4BD/2BA, 2,100 sqft, $525,000 asking, rents around $2,800/mo, perfect for an English-speaking professional couple.'"}],"resultDescription":"Returns a JSON object with three sections: (1) listing_data with structured property fields (address, city, state, zip, bedrooms, bathrooms, sqft, lot size, year built, price, rent, property type); (2) fha_report with compliance status, flagged phrases with violation categories and suggested rewrites, violation count, and a fully compliant rewrite of the listing; (3) investor_metrics including purchase price, down payment, loan amount, monthly rent, monthly mortgage, monthly expenses, monthly cashflow, annual NOI, cap rate, DSCR, cash-on-cash return, and gross rent multiplier.","failureModes":["Malformed or empty text input returns a 400 error","Gemini AI parsing fails to extract usable property data if text is too vague or unstructured","FHA scan may miss nuanced discriminatory language not clearly tied to a protected class","Investment metrics may be inaccurate if rent or price cannot be reliably parsed from text","Payment of $0.05 USDC via x402 not completed results in 402 Payment Required","Rate limiting or Cloudflare Worker timeout on very long listing texts"],"whenToPreferThis":"Choose this endpoint when you have raw listing text or MLS copy and need all three analyses — property extraction, FHA compliance, and investment metrics — in a single API call rather than chaining three separate endpoints. It is the most cost-effective and efficient path when starting from unstructured text. Prefer the URL-based scrape endpoint if you have a listing webpage instead of raw text, or the dedicated FHA-scan endpoint if you only need compliance checking without financial analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:05:28.144Z","isFirstParty":false,"canonicalSlug":"sparks-re-api-property-text-full-analysis-c47b0d4c"}