# Realtor — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search millions of real estate listings on Realtor.com, view detailed property information, find qualified agents in your area, and access market analytics to understand pricing trends. Get location suggestions and property insights all in one place to help you make informed decisions about buying, selling, or investing in real estate.

**Category:** Real Estate | **Website:** [realtor.com/](https://realtor.com/) | **Docs:** [parse.bot/marketplace/d987ac66-ed1f-4f18-a3fe-ca86ad03e099/realtor-com-api](https://parse.bot/marketplace/d987ac66-ed1f-4f18-a3fe-ca86ad03e099/realtor-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_location_suggestions

Get location autocomplete suggestions for a partial search input. Returns matching cities, postal codes, counties, and states with geographic coordinates and identifiers. Useful for validating or discovering location inputs for other endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `input` | string | Yes | Partial location string to autocomplete (e.g. 'Aus'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/get_location_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"<string>"}'
```

### get_market_analytics

Retrieve market analytics including median listing price for a given location. Provides a high-level snapshot of the local housing market for investment analysis or comparison.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | Location to get analytics for. Accepts 'City, ST' format (e.g. 'Austin, TX') or a 5-digit ZIP code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/get_market_analytics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>"}'
```

### get_property_details

Retrieve comprehensive details for a specific property including full description text, photos, price history, tax history, and nearby schools. Requires a property_id obtained from search_properties results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `property_id` | string | Yes | Unique property ID from search_properties results (e.g. '7893842560'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/get_property_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"property_id":"<string>"}'
```

### search_agents

Search for real estate agents matched to a specific postal code. Returns agent profiles with experience, brokerage, and transaction history. Results include qualification status and a list of matched realtors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `postal_code` | string | Yes | 5-digit US postal code to search for agents (e.g. '10001'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/search_agents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"postal_code":"<string>"}'
```

### search_properties

Search for real estate properties by location (city/state or ZIP code) with support for status, price, beds, baths, and property type filters. Returns paginated results sorted by the specified field. Pagination is offset-based with limit and offset parameters. Each property summary includes basic details; use get_property_details for full information including history and schools.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `baths_min` | number | No | Minimum number of bathrooms filter. |
| `beds_min` | integer | No | Minimum number of bedrooms filter. |
| `limit` | integer | No | Number of results to return per page. |
| `location` | string | Yes | Location to search. Accepts 'City, ST' format (e.g. 'Austin, TX') or a 5-digit ZIP code (e.g. '78701'). |
| `max_price` | integer | No | Maximum listing price filter. |
| `min_price` | integer | No | Minimum listing price filter. |
| `offset` | integer | No | Pagination offset (number of results to skip). |
| `property_type` | string | No | JSON array of property types to filter by. Accepted values include 'single_family', 'condos', 'multi_family', 'mobile', 'land', 'farm', 'townhomes'. Example: '["single_family", "condos"]'. |
| `sort_direction` | string | No | Sort direction. |
| `sort_field` | string | No | Field to sort results by. |
| `status` | string | No | JSON array of listing statuses to filter by. Accepted values include 'for_sale' and 'for_rent'. Example: '["for_sale"]'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-realtor-com-api-d987ac66/search_properties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"baths_min":"<number>","beds_min":"<integer>","limit":"<integer>","location":"<string>","max_price":"<integer>","min_price":"<integer>","offset":"<integer>","property_type":"<string>","sort_direction":"<string>","sort_field":"<string>","status":"<string>"}'
```