{"openapi":"3.0.3","info":{"title":"Sparks Real Estate, Fair Housing & Web Compliance Intelligence API","version":"1.5.2","description":"14-in-1 PropTech, LegalTech, ADA/WCAG, TCPA Voice & Web Intelligence API by Sparks Digital LLC. Includes RESO property data normalization, Fair Housing Act (42 U.S.C. 3604c) 7-protected-class compliance auditing, rental investment underwriting, ADA Title II / WCAG 2.1 AA + Overlay/PDF auditing, Agentic Readiness inspection, TCPA Voice Quiet-Hours compliance, SEC EDGAR filings, URL-to-Markdown extraction, and Base L2 smart contract/gas auditing.","contact":{"name":"Sparks Digital LLC","url":"https://digisparks.net","email":"garrett@digisparks.net"}},"servers":[{"url":"https://sparks-re-api.sparksdigital-re.workers.dev","description":"Global Cloudflare Edge Production"}],"paths":{"/property/factual":{"post":{"tags":["Real Estate Intelligence"],"summary":"Extract Structured RESO Property Specs from Listing Text","description":"Parses address, city, state, zip, bedrooms, bathrooms, square_feet, lot_size, year_built, property_type, and price from unstructured MLS remarks or property descriptions.","operationId":"normalizeProperty","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["raw_text"],"properties":{"raw_text":{"type":"string","example":"Charming 3 bed, 2 bath ranch at 742 E Main St, Brownsburg, IN 46112. 1,850 sqft, built in 1998. Listed at $285,000."}}}}}},"responses":{"200":{"description":"Normalized property specification object"}}}},"/property/fha-compliance":{"post":{"tags":["Real Estate Intelligence"],"summary":"Fair Housing Act (FHA) 7-Protected-Class Compliance Scanner","description":"Audits real estate marketing copy against 50+ discriminatory patterns across Race, Color, Religion, National Origin, Sex, Familial Status, and Disability, returning flagged phrases and a compliant rewrite.","operationId":"checkFhaCompliance","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["listing_text"],"properties":{"listing_text":{"type":"string","example":"Great family home for mature empty nesters near the local church."}}}}}},"responses":{"200":{"description":"FHA compliance report and compliant rewrite"}}}},"/property/investor-metrics":{"post":{"tags":["Real Estate Intelligence"],"summary":"Rental Property Investment & Underwriting Calculator (Cap Rate, DSCR, NOI)","description":"Computes Cap Rate %, Cash-on-Cash Return %, Debt Service Coverage Ratio (DSCR), Gross Rent Multiplier (GRM), Annual NOI, and Monthly Net Cashflow.","operationId":"calculateInvestorMetrics","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["purchase_price","monthly_rent"],"properties":{"purchase_price":{"type":"number","example":285000},"monthly_rent":{"type":"number","example":2350},"down_payment_percent":{"type":"number","example":20},"interest_rate":{"type":"number","example":6.5}}}}}},"responses":{"200":{"description":"Underwriting metrics breakdown"}}}},"/property/analyze-text":{"post":{"tags":["Real Estate Intelligence"],"summary":"All-in-One Listing Text Analyzer (Specs + Fair Housing + Cashflow)","description":"Extracts structured property specs, audits Fair Housing compliance, and computes rental investment metrics in a single consolidated call.","operationId":"analyzePropertyText","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","example":"4 bed 2.5 bath home at 742 E Main St, Brownsburg IN 46112 for $285,000. Est rent $2,350/mo."}}}}}},"responses":{"200":{"description":"Consolidated property intelligence report"}}}},"/property/analyze-url":{"post":{"tags":["Real Estate Intelligence"],"summary":"Scrape & Analyze Public Property Listing URL","description":"Fetches a public listing webpage, extracts property specifications, runs Fair Housing compliance checks, and calculates investor metrics.","operationId":"analyzePropertyUrl","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","example":"https://digisparks.net"}}}}}},"responses":{"200":{"description":"Scraped property analysis report"}}}},"/property/analyze-image":{"post":{"tags":["Real Estate Intelligence"],"summary":"Multimodal Property Screenshot & Photo Inspector","description":"Analyzes a base64-encoded property listing screenshot or photo for property specs, Fair Housing compliance, and investor returns.","operationId":"analyzePropertyImage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["image"],"properties":{"image":{"type":"string","description":"Base64-encoded PNG/JPEG image"},"mime_type":{"type":"string","example":"image/png"},"caption":{"type":"string","example":"3 bed 2 bath brick ranch listed at $295,000"}}}}}},"responses":{"200":{"description":"Image property intelligence report"}}}},"/utilities/extract":{"post":{"tags":["Web & Compliance Utilities"],"summary":"Clean URL/HTML to LLM-Ready Markdown Extractor","description":"Strips scripts, ads, and boilerplate from any public webpage URL or raw HTML and returns clean Markdown, heading hierarchy, link count, and word count.","operationId":"extractWebMarkdown","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","example":"https://digisparks.net"},"html":{"type":"string"}}}}}},"responses":{"200":{"description":"Clean Markdown and metadata"}}}},"/utilities/wcag-audit":{"post":{"tags":["Web & Compliance Utilities"],"summary":"ADA Title II & WCAG 2.1 Level AA Website Accessibility Scanner","description":"Scans any webpage URL or raw HTML for structural WCAG 2.1 AA violations (missing alt text, missing lang, empty links, unlabeled form inputs, zoom locks) and outputs a 0-100 compliance score.","operationId":"auditWcagCompliance","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","example":"https://digisparks.net"},"html":{"type":"string"}}}}}},"responses":{"200":{"description":"WCAG 2.1 AA accessibility compliance report"}}}},"/utilities/edgar-intel":{"post":{"tags":["Financial & Web3 Intelligence"],"summary":"SEC EDGAR Public Company & 10-K/10-Q Filing Extractor","description":"Resolves any US stock ticker (e.g., AAPL, NVDA, MSFT) or 10-digit CIK against official SEC EDGAR submissions data and returns company metadata, SIC classification, and recent filing URLs.","operationId":"fetchSecEdgarIntel","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string","example":"AAPL"},"cik":{"type":"string"}}}}}},"responses":{"200":{"description":"SEC EDGAR company intelligence and filings"}}}},"/utilities/token-audit":{"post":{"tags":["Financial & Web3 Intelligence"],"summary":"Base Mainnet Smart Contract & ERC-20 Technical Risk Auditor","description":"Queries Base Mainnet RPC for deployed bytecode size, EIP-1967 proxy implementation slots, and admin selectors (mint, pause, blacklist) to output a 0-100 risk score.","operationId":"auditBaseTokenRisk","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contract_address"],"properties":{"contract_address":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}}}},"responses":{"200":{"description":"Smart contract bytecode risk audit"}}}},"/utilities/base-gas":{"post":{"tags":["Financial & Web3 Intelligence"],"summary":"Live Base L2 Network Congestion & Gas Oracle","description":"Returns latest Base Mainnet block height, gas price in gwei, EIP-1559 base fee, block utilization %, estimated USDC transfer gas cost in USD, and execution recommendation.","operationId":"getBaseGasOracle","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"Live Base L2 gas and congestion metrics"}}}}}}