# Agent Data APIs – Rental Search

> Agent Data APIs – Rental Search is a paid API for AI agents from 192.3.171.233, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Search, normalize, deduplicate, and rank rental listings from caller-supplied observations, enriched with public rent benchmarks (Zillow ZORI, HUD FMR) for a given ZIP code and bedroom count

## Facts

- Endpoint: POST https://192.3.171.233/v1/rentals/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-apis-rental-search-d2d24ee8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TsUjDa6qDzxsw1Dpw5mtk

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 agent-data-apis-rental-search-d2d24ee8 -d '<json body>'
```

Example prompt: Search for available 2-bedroom long-term rentals in ZIP code 78701 with a budget under $2,300 per month, pets allowed, in-unit laundry required, and return up to 10 results ranked by match score — I also want the Zillow and HUD market benchmarks for that area.

## When to prefer this

Use this endpoint when you need to search and rank rental observations that have already been gathered (from property-manager feeds or similar sources) against public rent benchmarks, or when you need a self-contained market snapshot (ZORI + HUD FMR) for a specific ZIP and bedroom count. Prefer this over raw Zillow or HUD APIs when you need deduplicated, normalized, scored results with provenance in a single x402-paid call at $0.02 USDC. Not suitable for executing leases, accessing unit-level MLS data, or retrieving commercial property data.

## Known failure modes

- Unsigned or missing x402 credential returns an HTTP 402 challenge before any validation
- Invalid credentials or insufficient balance rejected before payment settlement — no charge
- No listings match the filter criteria — empty matches array returned with market block still populated
- ZIP code not found in ZCTA or ZORI coverage — warnings array populated, benchmark fields may be null
- Candidate observations fail normalization due to missing required fields — rejected with validation error
- Rate limiting or server error returns 5xx with no charge applied

## How this service works

An x402-paid API suite for autonomous agents. The freight operation preserves deterministic U.S. DOT/FMCSA carrier checks. A self-contained rental market snapshot returns available public rent benchmarks, trends, provenance, and optional budget fit from a ZIP code and bedroom count. Other rental operations normalize, deduplicate, search, compare, and analyze rental observations supplied by a caller who is authorized to process them. Zillow Research ZORI, U.S. Census ZCTA geography, and HUD Fair Market Rent data are not represented as unit-level listings or executed lease rents. Unsigned requests receive the x402 challenge before validation. Credential-bearing retries that are invalid or cannot produce the advertised minimum result are rejected before payment verification and settlement and are not charged.

## Output

A JSON response containing: (1) matched rental listings with normalized address, rent in cents, bedrooms, bathrooms, square feet, pet policy, amenities, match score, data quality score, market difference percent, mandatory fees, and evidence references; (2) a market context block with Zillow ZORI typical rent, HUD Fair Market Rents by bedroom count, 1/3/12-month change percentages, geographic coordinates, HUD area name, dataset version, and provenance evidence records including content hashes and attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "bedrooms": {
   "type": "object"
  },
  "location": {
   "type": "object"
  },
  "petPolicy": {
   "type": "string"
  },
  "candidates": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "propertyTypes": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "monthlyCostCents": {
   "type": "object"
  },
  "maxListingAgeDays": {
   "type": "integer"
  },
  "requiredAmenities": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "market": {
   "evidence": [
    {
     "id": "ev_zori",
     "dataset": "Zillow Observed Rent Index (ZORI)",
     "sourceId": "zillow-research",
     "sourceUrl": "https://rentals.example/listings/AUS-1200-12A",
     "fieldPaths": [
      "/typicalRentCents"
     ],
     "observedAt": "2026-08-23T16:00:00Z",
     "attribution": "Caller-authorized property manager feed",
     "contentHash": "sha256:ccdbf127d9e36d25f3c0e535a3cb4280c7b67117399e6fe42a41a914f1c9087a",
     "retrievedAt": "2026-08-24T12:05:00Z"
    }
   ],
   "latitude": 30.2713,
   "warnings": [
    "Market benchmarks are area-level context and are not substitutes for property-level comparables."
   ],
   "longitude": -97.7426,
   "postalCode": "78701",
   "generatedAt": "2026-08-24T12:00:00Z",
   "hudAreaCode": "METRO12420M12420",
   "hudAreaName": "Austin-Round Rock-Georgetown, TX HUD Metro FMR Area",
   "sourceCount": 2,
   "datasetVersion": "rental-ds-2026-08-24-6af7130e",
   "change1MonthPct": 0.3,
   "change3MonthPct": 1.1,
   "typicalRentAsOf": "2026-07",
   "change12MonthPct": -0.8,
   "typicalRentCents": 229400,
   "hudFairMarketRentsCents": {
    "0": 143000,
    "1": 160000,
    "2": 195000,
    "3": 254000
   }
  },
  "matches": [
   {
    "address": {
     "city": "AUSTIN",
     "unit": "12A",
     "line1": "1200 CONGRESS AVE",
     "state": "TX",
     "postalCode": "78701"
    },
    "sources": [
     "property-manager-feed"
    ],
    "bedrooms": 2,
    "latitude": 30.2752,
    "amenities": [
     "IN_UNIT_LAUNDRY",
     "PARKING"
    ],
    "bathrooms": 2,
    "furnished": false,
    "listingId": "lst_8c896d29ce93b5f421f4",
    "longitude": -97.7426,
    "petPolicy": "PETS_ALLOWED",
    "matchScore": 98,
    "observedAt": "2026-08-23T16:00:00Z",
    "propertyId": "prp_79dd77a282d20d5f2860",
    "squareFeet": 1040,
    "listingKind": "LONG_TERM",
    "reasonCodes": [
     "NORMALIZED_AND_DEDUPLICATED"
    ],
    "evidenceRefs": [
     "ev_listing_1"
    ],
    "propertyType": "MULTIFAMILY",
    "baseRentCents": 210000,
    "duplicateCount": 2,
    "dataQualityFlags": [],
    "dataQualityScore": 94,
    "totalMonthlyCostCents": 222500,
    "marketDifferencePercent": -3.4,
    "pricePerSquareFootCents": 214,
    "effectiveMonthlyRentCents": 206390,
    "mandatoryMonthlyFeesCents": 12500
   },
   {
    "address": {
     "city": "AUSTIN",
     "unit": "804",
     "line1": "501 BRAZOS ST",
     "state": "TX",
     "postalCode": "78701"
    },
    "s
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-apis-rental-search-d2d24ee8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 192.3.171.233](https://www.zero.xyz/host/192.3.171.233/llms.txt)