# Realtor Property

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/realtor/property` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/realtor-property |

## Description

Extract full property details from a Realtor.com listing URL, including price, specs, photos, agents, features, and location data.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/realtor/property' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup 1492 E 57th St, Brooklyn

```json
{
  "id": "2994403623",
  "url": "https://www.realtor.com/realestateandhomes-detail/1492-E-57th-St_Brooklyn_NY_11234_M46117-61190",
  "slug": "1492-E-57th-St_Brooklyn_NY_11234_M46117-61190",
  "tags": [
    {
      "id": "hardwood_floors",
      "label": "Hardwood floors"
    },
    {
      "id": "central_air",
      "label": "Central air"
    }
  ],
  "agent": [
    {
      "id": "BONY",
      "type": "seller",
      "agent_id": "YB6416",
      "office_id": "117980",
      "agent_name": null,
      "agent_email": "yan@topnestinc.com",
      "agent_phone": null,
      "office_name": "Remax Top Nest Real Estate",
      "office_phone": null
    }
  ],
  "flags": {
    "is_auction": null,
    "is_pending": true,
    "is_contingent": null,
    "is_non_deeded": null,
    "is_short_sale": null,
    "is_coming_soon": null,
    "is_foreclosure": null,
    "is_new_listing": false,
    "is_subdivision": null,
    "is_price_reduced": null,
    "is_usda_eligible": false,
    "is_new_construction": null,
    "is_fractionally_owned": null,
    "is_price_excludes_land": null
  },
  "local": null,
  "phones": [],
  "photos": [
    {
      "url": "https://ap.rdcpix.com/3ad76fc1d8db6123926f6cce8a7b838bl-m2523758046s.jpg",
      "tags": [
        "road",
        "porch",
        "nice_house",
        "house_view",
        "front_of_house_view",
        "front_door",
        "exterior",
        "brick_building",
        "complete",
        "red",
        "yard",
        "lawn"
      ]
    }
  ],
  "status": "for_sale",
  "details": {
    "beds": 3,
    "logo": null,
    "name": null,
    "pool": null,
    "sqft": null,
    "text": "2 Family, semi-attached home being delivered vacant. Act now.",
    "type": "multi_family",
    "rooms": null,
    "units": null,
    "garage": null,
    "styles": null,
    "zoning": null,
    "cooling": null,
    "heating": null,
    "roofing": null,
    "stories": null,
    "beds_max": null,
    "beds_min": null,
    "exterior": null,
    "lot_sqft": 1800,
    "sqft_max": null,
    "sqft_min": null,
    "sub_type": null,
    "baths_max": null,
    "baths_min": null,
    "fireplace": null,
    "baths_3qtr": 1,
    "baths_full": 1,
    "baths_half": null,
    "garage_max": null,
    "garage_min": null,
    "year_built": null,
    "baths_total": null,
    "garage_type": null,
    "construction": null,
    "year_renovated": null,
    "baths_consolidated": "2"
  },
  "history": null,
  "features": {
    "bedrooms": [
      "Bedrooms: 3"
    ],
    "bathrooms": [
      "Full Bathrooms: 1",
      "3/4 Bathrooms: 1"
    ],
    "land _info": [
      "Lot Size Acres: 0.0413223",
      "Lot Size Square Feet: 1800"
    ],
    "other _rooms": [
      "Basement Features: Finished, Full"
    ],
    "interior _features": [
      "A/C Unit",
      "Flooring: Hardwood"
    ],
    "garage and _parking": [
      "Parking Features: 1 Space, Shared Drive"
    ],
    "heating and _cooling": [
      "Cooling Features: 4, AC Units: 4",
      "Heating Fuel: Gas"
    ],
    "other _property _info": [
      "Source Listing Status: Pending",
      "County: Kings (Brooklyn)",
      "Cross Street: Avenue M",
      "Source Property Type: Residential",
      "Area: Flatlands",
      "Source Neighborhood: Flatlands",
      "Property Subtype: Multi-Family"
    ],
    "building and _construction": [
      "Building Exterior Type: Brick",
      "Construction Materials: Brick",
      "Roof: Shingle",
      "Structure Type: Semi-Detached"
    ],
    "exterior and _lot _features": [
      "Yard: Back"
    ]
  },
  "location": {
    "city": {
      "slug_id": "Brooklyn_NY",
      "county_needed_for_uniq": false
    },
    "county": {
      "name": "Kings",
      "fips_code": "36047",
      "state_code": "NY"
    },
    "address": {
      "city": "Brooklyn",
      "line": "1492 E 57th St",
      "unit": null,
      "state": "New York",
      "country": "USA",
      "coordinate": {
        "lat": 40.617188,
        "lon": -73.920186
      },
      "state_code": "NY",
      "postal_code": "11234",
      "street_name": "57th",
      "street_number": "1492",
      "street_suffix": "St",
      "validation_code": "121",
      "street_direction": "E",
      "street_post_direction": null
    },
    "postal_code": {
      "geo_statistics": {
        "housing_market": {
          "hot_market_badge": "Other"
        }
      }
    },
    "search_areas": [
      {
        "city": "brooklyn",
        "state_code": "ny"
      },
      {
        "city": "new york",
        "state_code": "ny"
      },
      {
        "city": "new york city",
        "state_code": "ny"
      }
    ],
    "neighborhoods": [
      {
        "name": "Flatlands"
      },
      {
        "name": "Southeastern Brooklyn"
      }
    ],
    "street_view_url": "https://maps.googleapis.com/maps/api/streetview?channel=rdc-streetview&key=AIzaSyAP_xs30yS0J4xp8O1ZKUrUttIXKklrwaM&location=1492%20E%2057th%20St%2C%20Brooklyn%2C%20NY%2011234&size=950x428&source=outdoor&signature=r_CkqfMsaJMfaF_JBhICUY9jzX8=",
    "street_view_metadata_url": "https://maps.googleapis.com/maps/api/streetview/metadata?channel=rdc-streetview&key=AIzaSyAP_xs30yS0J4xp8O1ZKUrUttIXKklrwaM&location=1492%20E%2057th%20St%2C%20Brooklyn%2C%20NY%2011234&size=640x480&source=outdoor&signature=Id5j65U6SnYs6YaBLxxB6RZsUvw="
  },
  "list_date": "2026-04-22T21:24:51Z",
  "sold_date": "1998-03-11",
  "list_price": 500000,
  "sold_price": 175000,
  "advertisers": [
    {
      "href": null,
      "name": "Yan Byshevsky",
      "team": null,
      "type": "seller",
      "email": "ybyshesky8087@gmail.com",
      "photo": null,
      "broker": {
        "logo": null,
        "name": null,
        "accent_color": null,
        "designations": [],
        "fulfillment_id": "0"
      },
      "office": {
        "href": null,
        "name": "Top Nest Inc",
        "email": "jerryt@topnestinc.com",
        "hours": null,
        "photo": null,
        "phones": null,
        "slogan": null,
        "address": {
          "city": null,
          "line": null,
          "state": null,
          "country": null,
          "coordinate": null,
          "state_code": null,
          "postal_code": null
        },
        "mls_set": "O-BONY-117980",
        "lead_email": null,
        "fulfillment_id": "0",
        "application_url": null,
        "out_of_community": null
      },
      "phones": [
        {
          "ext": null,
          "type": "BUSINESS_MOBILE",
          "number": "3475432791",
          "primary": true,
          "trackable": null
        }
      ],
      "slogan": null,
      "address": {
        "city": null,
        "line": null,
        "state": null,
        "country": null,
        "state_code": null,
        "postal_code": null
      },
      "builder": null,
      "mls_set": "A-BONY-YB6416",
      "nrds_id": null,
      "state_license": null,
      "fulfillment_id": "100086239"
    }
  ],
  "tax_history": null,
  "list_price_last_change": null
}
```

## Documentation

## Overview
Extract comprehensive property details from a Realtor.com listing page. Returns pricing, specs, photos, location, agents, advertisers, features, flags, and listing metadata in structured JSON.

## Quickstart
```
GET https://api.piloterr.com/v2/realtor/property?query=https://www.realtor.com/realestateandhomes-detail/1492-E-57th-St_Brooklyn_NY_11234_M46117-61190
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Realtor.com property detail URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | string | Realtor.com property ID |
| `url` | string | Canonical listing URL |
| `slug` | string | Listing slug |
| `status` | string | Listing status (e.g. `for_sale`) |
| `list_price` | integer | Current list price |
| `list_date` | string | Listing date (ISO 8601) |
| `sold_price` | integer \| null | Last sold price |
| `sold_date` | string \| null | Last sold date |
| `tags` | array | Property tags (`id`, `label`) |
| `photos` | array | Listing photos with optional tags |
| `details` | object | Beds, baths, sqft, lot size, type, description text |
| `features` | object | Grouped feature strings (bedrooms, bathrooms, etc.) |
| `flags` | object | Listing flags (`is_pending`, `is_new_listing`, etc.) |
| `location` | object | Address, county, neighborhoods, coordinates |
| `agent` | array | MLS agent attribution |
| `advertisers` | array | Listing advertisers with contact info |
| `history` | array \| null | Property history events |
| `tax_history` | array \| null | Tax history records |

## Notes
- Only full Realtor.com property detail URLs are accepted as `query`.
- Some fields may be `null` depending on listing type and data availability.
- `dontChargeNotFound` is enabled: you are not charged if the property is not found.

## Main use cases
- Enrich CRM records with full property specs and agent data
- Analyze listing status, price, and property features
- Extract agent and brokerage attribution for lead routing
- Power comp tools with beds, baths, lot size, and location data