# Realtor Property search API (realtor.property_search)

- Canonical page: [https://everyinfra.com/en/realtor-api/property_search](https://everyinfra.com/en/realtor-api/property_search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "realtor", "action": "property_search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=realtor&action=property_search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the search location for Realtor requests. For `search`, enter a city and state (e.g., `Austin, TX`) to find agents. For `property_search`, enter a 5-digit US ZIP code or a `City, ST` abbreviation. Arbitrary property descriptions are not accepted. |
| baths_min | integer | no | not declared | Sets the minimum number of bathrooms. The value is used as an integer, so it cannot preserve a half-bath value such as 1.5. |
| beds_min | integer | no | not declared | Sets the minimum number of bedrooms as an integer. It is not the total number of rooms in the property. |
| city | not declared | no | not declared | Overrides the city name for `property_search`. Do not pass a conflicting city when searching by ZIP code to avoid generating contradictory location conditions. |
| max_price | not declared | no | not declared | Specifies the maximum listing price for the standard input and takes precedence over `price_max` in the same request. Interpret prices separately for sale and rental listings. Filtering uses whole numbers: decimals round up (145.98 becomes 146). |
| min_price | not declared | no | not declared | Specifies the minimum listing price for the standard input and takes precedence over `price_min` in the same request. This parameter filters property prices, not agent service fees. Filtering uses whole numbers: decimals round down (39.81 becomes 39). |
| sort | enum: bedrooms_desc / lot_size_desc / newest / photo_count_desc / price_desc / recently_sold / recently_updated / sold_price_desc | no | not declared | Listing order for `property_search`, always descending: `newest` (latest listings first, the default), `price_desc` (list price), `sold_price_desc` (sold price), `recently_sold`, `bedrooms_desc`, `lot_size_desc`, `photo_count_desc`, or `recently_updated`. There is no ascending option, so listings cannot be sorted from the lowest price up. |
| status | not declared | no | not declared | One listing status for `property_search`, sent as a string; defaults to `for_sale`. Known values are `sold`, `for_rent`, `ready_to_build`, `off_market`, `other`, and `new_community`. The value is not checked against a fixed list, so other strings are not rejected. Send a single status, not an array. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| status | platform-native meaning |
| price | Price as a number without a currency symbol; see currency. |
| sold_price | platform-native meaning |
| sold_at | platform-native meaning |
| listed_at | platform-native meaning |
| property_type | platform-native meaning |
| beds | platform-native meaning |
| baths | platform-native meaning |
| area_sqft | platform-native meaning |
| lot_sqft | platform-native meaning |
| year_built | platform-native meaning |
| address | Full address, passed through as is. |
| city | City name in the platform's language, not normalized. |
| state | platform-native meaning |
| postal_code | platform-native meaning |
| county | platform-native meaning |
| lat | platform-native meaning |
| lng | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| photo_count | platform-native meaning |
| is_new_listing | platform-native meaning |
| is_price_reduced | platform-native meaning |
| is_foreclosure | platform-native meaning |
| advertiser_emails | platform-native meaning |
| advertiser_phones | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "realtor",
  "action": "property_search",
  "params": {
    "keyword": "10022"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "realtor",
        "action": "property_search",
        "params": {
            "keyword": "10022",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "realtor",
  "action": "property_search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.realtor.com/realestateandhomes-detail/200-E-58th-St-Apt-6D_New-York_NY_10022_M34658-52869",
      "title": "200 E 58th St Apt 6D",
      "status": "for_sale",
      "price": 850000,
      "sold_price": 182000,
      "sold_at": "1992-01-31T00:00:00+00:00",
      "listed_at": "2026-09-26T09:23:16+00:00",
      "property_type": "condos",
      "beds": 1,
      "area_sqft": 0,
      "year_built": 1963,
      "address": "200 E 58th St Apt 6D",
      "city": "New York",
      "state": "NY",
      "postal_code": "10022",
      "county": "New York",
      "lat": 40.760578,
      "lng": -73.966903,
      "image_url": "https://ap.rdcpix.com/c66ce90814bb5fd99a1e190f0148454dl-m1477315349s.jpg",
      "photo_count": 15,
      "is_new_listing": true,
      "platform": "realtor"
    },
    {
      "id": "•••",
      "url": "https://www.realtor.com/realestateandhomes-detail/303-Park-Ave-3304_New-York_NY_10022_M91518-56430",
      "title": "303 Park Ave Unit 3304",
      "status": "for_sale",
      "price": 5350000,
      "listed_at": "2026-09-25T20:01:34+00:00",
      "property_type": "condos",
      "beds": 2,
      "area_sqft": 1461,
      "year_built": 1931,
      "address": "303 Park Ave Unit 3304",
      "city": "New York",
      "state": "NY",
      "postal_code": "10022",
      "county": "New York",
      "lat": 40.756886,
      "lng": -73.973892,
      "image_url": "https://ap.rdcpix.com/f53f80b6ec7b0511ff9a94352cfa0222l-m3708302104s.jpg",
      "photo_count": 30,
      "is_new_listing": true,
      "platform": "realtor"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=realtor
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
