# Sparks RE API — Analyze Listing URL

> Sparks RE API — Analyze Listing URL 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).

Scrapes a real estate listing webpage URL to extract property specs, run FHA compliance checks, and compute investor financial metrics in a single report.

## Facts

- Endpoint: POST https://sparks-re-api.sparksdigital-re.workers.dev/property/analyze-url?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-analyze-listing-url-889027bc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O6Q0nMIgtkSRdaAVvi_5d

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-analyze-listing-url-889027bc -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Real estate listing webpage URL"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sparks-re-api-analyze-listing-url-889027bc/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)