# Realtor Property Listings Scraper

> Realtor Property Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Scrapes structured real estate listing data from Realtor.com by city, ZIP code, or search URL with filtering by price, beds, baths, and property type

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/realtor?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/realtor-property-listings-scraper-bbabe34d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i54WhKnW-_DJcx5d3bk-q

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 realtor-property-listings-scraper-bbabe34d -d '<json body>'
```

Example prompt: Search Realtor.com for single-family homes for sale in Austin, TX with at least 3 bedrooms, 2 bathrooms, priced between $300,000 and $600,000 — pull up to 50 listings.

## When to prefer this

Use this endpoint when you need structured property listing data from Realtor.com for one or more cities or ZIP codes with flexible filtering on price, beds, baths, and property type. Prefer this over generic web scraping when you need clean, normalized listing records. Pay-per-call pricing with no charge for failed runs makes it low-risk for exploratory queries.

## Known failure modes

- No listings found for the given location or filters — returns empty items array (not charged)
- Invalid city/state format or unrecognized ZIP code causes no results
- maxPages limit reached before all matching listings are retrieved
- Rate limits or anti-scraping measures on source site cause partial results
- priceMin/priceMax filters may not match source-side filtering, applied post-retrieval only

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched listings and an array of items, each containing the listing URL, status, list date, list price, listing ID, property ID, price per sqft, and last sold price. Failed or empty result sets are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bedsMin": {
   "type": "number",
   "minimum": 0,
   "description": "Only output listings with at least this many bedrooms."
  },
  "bathsMin": {
   "type": "number",
   "minimum": 0,
   "description": "Only output listings with at least this many bathrooms."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum output rows across every location. Set 0 for no output cap; the page limit still applies."
  },
  "maxPages": {
   "type": "integer",
   "default": 20,
   "maximum": 300,
   "minimum": 1,
   "description": "Stop after this many 30-listing pages per location, including pages examined while applying filters."
  },
  "priceMax": {
   "type": "integer",
   "minimum": 0,
   "description": "Only output listings at or below this price in USD. Applied after each search page is retrieved."
  },
  "priceMin": {
   "type": "integer",
   "minimum": 0,
   "description": "Only output listings at or above this price in USD. Applied after each search page is retrieved."
  },
  "statuses": {
   "type": "array",
   "default": [],
   "description": "Optional status values such as for_sale. Empty includes every status returned by the search source. Applied after retrieval."
  },
  "startUrls": {
   "type": "array",
   "description": "Property search URLs use their city and state or ZIP location. Additional filters encoded in a search URL are not applied; use the fields below. Property detail URLs return one listing."
  },
  "propertyTypes": {
   "type": "array",
   "default": [],
   "description": "Optional source type values such as single_family, condo, townhomes, or multi_family. Empty includes every type. Applied after retrieval."
  },
  "includeDetails": {
   "type": "boolean",
   "default": false,
   "description": "Request each property's detail record to add more photo URLs and reported days on market. This adds one request per accepted listing."
  },
  "searchLocations": {
   "type": "array",
   "description": "Cities in City, ST format or five-digit ZIP codes. Each location is searched for property listings."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "status": null,
    "listDate": null,
    "listPrice": null,
    "listingId": null,
    "propertyId": null,
    "pricePerSqft": null,
    "lastSoldPrice": null
   }
  ],
  "product": "realtor"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/realtor-property-listings-scraper-bbabe34d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)