{"uid":"cap_mNhlUesWysy01tpVvJ3IO","slug":"sparks-re-api-property-factual-extractor-d12d68bc","name":"Sparks RE API – Property Factual Extractor","description":"AI-powered real estate tools for property normalization, FHA compliance scanning, and investor metrics calculation. Powered by x402 micropayments.","url":"https://sparks-re-api.sparksdigital-re.workers.dev/property/factual?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"raw_text":{"type":"string","description":"Free-form property listing text to parse"}}},"responseSchema":{"type":"json","example":{"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,"property_type":"SFR"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Dpi05hDxyxc9yAwc--PrQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses unstructured real estate listing text into structured property fields using regex pattern matching","exampleAgentPrompt":"Can you pull the structured property details out of this MLS listing description — I need the address, bedrooms, bathrooms, square footage, lot size, year built, property type, and asking price as separate fields: '789 Maple Ave, Indianapolis IN 46220 — charming 3BD/2BA SFR built in 1998, 1,850 sqft on a 0.25-acre lot, listed at $295,000.'","exampleUseCases":[{"title":"MLS copy normalization for CRM import","prompt":"I have this raw MLS remark text and I need to load it into our CRM as structured fields — can you parse out the address, city, state, zip, bed count, bath count, square footage, lot size, year built, property type, and price from it: '4BR/3BA Colonial at 112 Birchwood Dr, Columbus OH 43215, built 2004, 2,400 sqft, 0.3-acre lot, asking $425,000.'"},{"title":"Investor deal screening from email blasts","prompt":"I get property deal emails in plain text with no consistent format — can you extract the key specs from this one so I can run my investment calculations: 'Off-market duplex, 2001 vintage, 1,600 sqft each unit, 3 bed 2 bath per side, 0.18 acres, 5522 Elm St Dayton OH 45402, seller wants $310k.'"},{"title":"Listing data pipeline for property aggregator","prompt":"We're ingesting scraped listing descriptions and need them structured — please parse this into property fields: 'Cozy 2-bedroom, 1-bathroom bungalow at 331 Oak Lane, Carmel IN 46032. Built 1965, 980 sq ft, small 0.12-acre lot, priced to sell at $189,900.'"}],"resultDescription":"A JSON object with up to 11 structured property fields: address, city, state, zip, bedrooms (integer), bathrooms (integer), square_feet (integer), lot_size (string), year_built (integer), property_type (string, e.g. 'SFR'), and raw_price (string). Fields not found in the input text may be null or omitted. Values are regex-parsed — agent should validate before downstream transactional use.","failureModes":["Ambiguous or abbreviated text may cause fields to be null or incorrectly parsed — regex cannot handle all formatting variations","Unconventional price formats (e.g. 'two ninety-five') may not be captured in raw_price","property_type may default to null if not explicitly stated or not matching known abbreviations","Heavily abbreviated MLS shorthand may fail to match regex patterns for square footage or lot size","Non-US address formats may parse city/state/zip incorrectly or not at all","Payment failure (insufficient USDC balance) returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you have free-form or MLS listing text and need fast, cheap structured extraction of standard property fields without AI inference overhead. At $0.03/call it is cost-effective for high-volume pipelines. Prefer it over the AI-powered sibling endpoint when speed and cost matter more than handling edge cases, and over manual parsing when you need consistent JSON output. If the text is highly ambiguous or uses non-standard formats, consider the Gemini-powered sibling endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:17.843Z","isFirstParty":false,"canonicalSlug":"sparks-re-api-property-factual-extractor-d12d68bc"}