# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/realtor/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/realtor/get-location-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/realtor/get-market-analytics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/realtor/get-property-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/realtor/search-agents \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/realtor/search-properties \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.