# Sotheby's International Realty Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/sothebysrealty/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/sothebysrealty-search |

## Description

Search Sotheby's International Realty luxury property listings worldwide and return price, beds, baths, square feet, and agent info as structured JSON in real time.

## 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/sothebysrealty/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search luxury listings in New York, NY

```json
{
  "page": 1,
  "results": [
    {
      "id": "sir-3M7N2H8",
      "url": "https://www.sothebysrealty.com/eng/sales/detail/180-l-1842-3m7n2h/15-cpw-penthouse-15-central-park-west-new-york-ny-10023",
      "agent": {
        "name": "Nikki Field",
        "affiliate": "Sotheby's International Realty - East Side Manhattan Brokerage"
      },
      "price": 49500000,
      "title": "Penthouse at 15 Central Park West",
      "mls_id": "RLS20023184",
      "status": "for_sale",
      "bedrooms": 4,
      "currency": "USD",
      "features": [
        "doorman",
        "gym",
        "city_views",
        "pied_a_terre"
      ],
      "location": {
        "city": "New York",
        "state": "NY",
        "country": "United States",
        "postal_code": "10023"
      },
      "bathrooms": 4.5,
      "listed_at": "2026-04-21T00:00:00.000Z",
      "lot_acres": null,
      "thumbnail": "https://img.sothebysrealty.com/eng/3m7n2h/large/01.jpg",
      "interior_sqft": 4920,
      "property_type": "condo",
      "price_on_request": false
    },
    {
      "id": "sir-4K8L9P2",
      "url": "https://www.sothebysrealty.com/eng/sales/detail/180-l-4k8l9p/villa-le-mas-saint-tropez-83990-france",
      "agent": {
        "name": "Alexander Kraft",
        "affiliate": "Côte d'Azur Sotheby's International Realty"
      },
      "price": 18900000,
      "title": "Villa Le Mas, Saint-Tropez",
      "mls_id": null,
      "status": "for_sale",
      "bedrooms": 7,
      "currency": "EUR",
      "features": [
        "waterfront",
        "pool",
        "vineyard",
        "gated_community"
      ],
      "location": {
        "city": "Saint-Tropez",
        "state": "Provence-Alpes-Côte d'Azur",
        "country": "France",
        "postal_code": "83990"
      },
      "bathrooms": 8,
      "listed_at": "2026-03-09T00:00:00.000Z",
      "lot_acres": 4.2,
      "thumbnail": "https://img.sothebysrealty.com/eng/4k8l9p/large/01.jpg",
      "interior_sqft": 8600,
      "property_type": "villa",
      "price_on_request": false
    },
    {
      "id": "sir-9Q3R7S5",
      "url": "https://www.sothebysrealty.com/eng/sales/detail/180-l-9q3r7s/maroon-creek-estate-aspen-co-81611",
      "agent": {
        "name": "Carrie Wells",
        "affiliate": "Aspen Snowmass Sotheby's International Realty"
      },
      "price": 27500000,
      "title": "Maroon Creek Estate, Aspen",
      "mls_id": "194-12-12345",
      "status": "for_sale",
      "bedrooms": 8,
      "currency": "USD",
      "features": [
        "ski_in_out",
        "mountain_views",
        "pool",
        "wine_cellar"
      ],
      "location": {
        "city": "Aspen",
        "state": "CO",
        "country": "United States",
        "postal_code": "81611"
      },
      "bathrooms": 10.5,
      "listed_at": "2026-02-18T00:00:00.000Z",
      "lot_acres": 6.8,
      "thumbnail": "https://img.sothebysrealty.com/eng/9q3r7s/large/01.jpg",
      "interior_sqft": 12450,
      "property_type": "estate",
      "price_on_request": false
    }
  ],
  "total_results": 1842,
  "results_per_page": 24
}
```

## Documentation

## Overview

Sotheby's International Realty is the global luxury real estate network with affiliated offices in more than 80 countries. The site uses Cloudflare Turnstile and CAPTCHA challenges that block plain HTTP scrapers. Piloterr handles the challenge and parsing and returns each search page as paginated JSON: price (native currency), beds, baths with half-bath precision, interior sqft, lot acres, location, MLS ID, agent name, affiliate office, and feature tags.

## Quickstart

```
GET https://api.piloterr.com/v2/sothebysrealty/search?location=New+York,+NY,+USA&status=for_sale&min_price=5000000
```

## Main use cases

- Track ultra-luxury price movements across New York, London, Paris, Hong Kong, and Aspen with one normalized schema
- Monitor new listings above $10M in target ZIP codes for a private banking team pitching to high-net-worth buyers
- Build a luxury price-per-square-foot index by city for institutional investors and family offices
- Compare listing volume and days on market across Sotheby's affiliate brokerages
- Power a concierge search tool filtered by feature tags (waterfront, ski-in-out, vineyard, equestrian)

See https://www.piloterr.com/pricing for plans and free trial credits.