# Real Estate Listing Search

> Real Estate Listing Search is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Searches Zillow-backed real estate listings using price, bed/bath, square footage, location, and home type filters, returning structured results with prices, addresses, photos, and agent details.

## Facts

- Endpoint: POST https://agentbodega.store/api/real-estate/listings/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/real-estate-listing-search-c4786f17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ybwx3T2RG16ycwYfxeoZg

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 real-estate-listing-search-c4786f17 -d '<json body>'
```

Example prompt: Can you search for 3-bedroom, 2-bathroom single-family homes for sale in Austin, TX between $400k and $650k and at least 1,500 square feet? I'd like to see prices, addresses, and agent info.

## When to prefer this

Use this endpoint when an agent needs to search active real estate listings with structured filter criteria (price, beds, baths, square footage, home type, location) and requires structured output including photos and agent details, particularly when Zillow data coverage is acceptable. Prefer over manual web scraping or general web search when structured, filterable listing data is needed programmatically.

## Known failure modes

- Invalid or unrecognized location returns empty results or an error
- Price range with min greater than max causes a validation error
- Overly restrictive filters (e.g. very high sqft in a small market) return zero results
- Malformed request body (missing required fields) returns a 400 error
- Zillow backend unavailability may cause upstream errors or timeouts

## How this service works

Search public home and rental listings by market, listing type, price, beds, amenities, URL, address, or property id. Uses managed fulfillment for Zillow, Apartments, and realtor-compatible requests.

## Output

A structured list of matching real estate listings including property address, listing price, number of bedrooms and bathrooms, square footage, home type, listing photos, and agent contact details sourced via Zillow.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "source",
       "type": "string",
       "required": false
      },
      {
       "name": "mode",
       "type": "string",
       "required": false
      },
      {
       "name": "market",
       "type": "string",
       "required": false
      },
      {
       "name": "listingType",
       "type": "string",
       "required": false
      },
      {
       "name": "priceMin",
       "type": "integer",
       "required": false
      },
      {
       "name": "priceMax",
       "type": "integer",
       "required": false
      },
      {
       "name": "bedsMin",
       "type": "integer",
       "required": false
      },
      {
       "name": "bedsMax",
       "type": "integer",
       "required": false
      },
      {
       "name": "bathsMin",
       "type": "number",
       "required": false
      },
      {
       "name": "bathsMax",
       "type": "number",
       "required": false
      },
      {
       "name": "homeTypes",
       "type": "array",
       "required": false
      },
      {
       "name": "propertyType",
       "type": "string",
       "required": false
      }
     ],
     "required": [],
     "fieldCount": 38,
     "contentType": "application/json",
     "requirements": "Choose one mode and provide its required selector: search requires market or zipCode; url requires searchUrls; lookup requires addresses, zpids, or propertyIds. Search filters are rechecked against normalized rows before results are returned.",
     "optionalPreview": [
      "source",
      "mode",
      "market",
      "listingType",
      "priceMin",
      "priceMax",
      "bedsMin",
      "bedsMax",
      "bathsMin",
      "bathsMax",
      "homeTypes",
      "propertyType"
     ],
     "omittedFieldCount": 26
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/real-estate-listing-search-c4786f17/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)