# Agent Active Listings

> Agent Active Listings is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Retrieves a paginated list of a real estate agent's current active for-sale property listings from Zillow using their encodedZuid identifier.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-zillow-data/agent-properties-for-sale?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-agent-active-listings-d19d374e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yI_wIkrIxTBy2ul6EWFpf

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 agents-openwebninja-com-agent-active-listings-d19d374e
```

Example prompt: Can you pull up all the active for-sale listings for the Zillow agent with ID X1-ZUxs6j84n4ak95_3mmvm, including their team's listings, starting on page 1?

## When to prefer this

Use this endpoint when you have a known Zillow agent identifier (encodedZuid) and need to enumerate their current active for-sale property portfolio. It is ideal for agent research, competitive market analysis, or building a real estate agent profile. Prefer this over a general property search when the specific agent relationship matters, and use the Agent Search endpoint first if you only have the agent's name or location.

## Known failure modes

- Invalid or missing encodedZuid returns an error — must be obtained from Agent Search endpoint first
- Agent has zero active listings — returns empty listings array with listing_count of 0
- Page number beyond available pages returns empty results
- Rate limiting or payment/credit exhaustion returns 402 or quota error
- Zillow data temporarily unavailable may cause upstream timeout or error response

## How this service works

Get an agent's current active for-sale listings. Requires the `encodedZuid` identifier from the Agent Search endpoint.

## Output

Returns a structured object containing an array of active listing records, each with Zillow property ID, price, address (city, street, postal code, state), bedrooms, bathrooms, home type, latitude/longitude, listing URL, open house status, VR model availability, brokerage name, price currency, and primary photo URL. Also includes a total listing_count and the pagination parameters used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "encodedZuid"
 ],
 "properties": {
  "page": {
   "type": "number",
   "default": 1,
   "minimum": 1,
   "description": "Page number for paginated results. Each page returns up to 5 listings."
  },
  "encodedZuid": {
   "type": "string",
   "example": "X1-ZUxs6j84n4ak95_3mmvm",
   "description": "The agent's unique identifier (obtained from the Agent Search endpoint)."
  },
  "include_team": {
   "type": "boolean",
   "default": true,
   "description": "Include listings from the agent's team members."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "listings": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "zpid": {
        "type": "integer",
        "description": "Zillow property ID"
       },
       "price": {
        "type": "integer"
       },
       "status": {
        "type": "string"
       },
       "address": {
        "type": "object",
        "properties": {
         "city": {
          "type": "string"
         },
         "line1": {
          "type": "string"
         },
         "line2": {
          "type": "string"
         },
         "postalCode": {
          "type": "string"
         },
         "stateOrProvince": {
          "type": "string"
         }
        }
       },
       "bedrooms": {
        "type": "integer"
       },
       "latitude": {
        "type": "number"
       },
       "bathrooms": {
        "type": "integer"
       },
       "home_type": {
        "type": "string",
        "description": "Property type"
       },
       "longitude": {
        "type": "number"
       },
       "listing_url": {
        "type": "string"
       },
       "hasOpenHouse": {
        "type": "boolean"
       },
       "has_vr_model": {
        "type": "boolean"
       },
       "brokerage_name": {
        "type": "string"
       },
       "price_currency": {
        "type": "string"
       },
       "primary_photo_url": {
        "type": "string"
       }
      }
     },
     "description": "Array of active listing objects"
    },
    "listing_count": {
     "type": "integer",
     "description": "Total number of active listings"
    }
   }
  },
  "status": {
   "type": "string"
  },
  "parameters": {
   "type": "object",
   "properties": {
    "page": {
     "type": "integer"
    },
    "encodedZuid": {
     "type": "string"
    },
    "include_team": {
     "type": "boolean"
    }
   }
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-agent-active-listings-d19d374e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)