# Sparks RE API — Property Text Full Analysis

> Sparks RE API — Property Text Full Analysis is a paid API for AI agents from sparks-re-api.sparksdigital-re.workers.dev, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-30).

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.

## Facts

- Endpoint: POST https://sparks-re-api.sparksdigital-re.workers.dev/property/analyze-text?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sparks-re-api-property-text-full-analysis-c47b0d4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3He68Lrkx_QEglKbTGRUT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sparks-re-api-property-text-full-analysis-c47b0d4c -d '<json body>'
```

Example prompt: 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.'

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "description": "Raw listing description copy"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sparks-re-api-property-text-full-analysis-c47b0d4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from sparks-re-api.sparksdigital-re.workers.dev](https://www.zero.xyz/host/sparks-re-api.sparksdigital-re.workers.dev/llms.txt)