# Sotheby's International Realty Ad

## Overview

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

## Description

Get full Sotheby's International Realty property details by URL: marketing description, full photo gallery, price, agent contact, MLS data, and amenities as structured JSON.

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

## Example Response

### Lookup by Sotheby's property URL

```json
{
  "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",
    "email": "nikki.field@sothebys.realty",
    "phone": "+1 212-606-7669",
    "title": "Senior Global Real Estate Advisor",
    "affiliate": "Sotheby's International Realty - East Side Manhattan Brokerage",
    "profile_url": "https://www.sothebysrealty.com/eng/associate/180-a-7821/nikki-field",
    "affiliate_url": "https://www.sothebysrealty.com/eng/associate-office/180-co-1382/east-side-manhattan-brokerage"
  },
  "media": {
    "images": [
      "https://img.sothebysrealty.com/eng/3m7n2h/full/01.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/02.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/03.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/04.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/05.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/06.jpg",
      "https://img.sothebysrealty.com/eng/3m7n2h/full/07.jpg"
    ],
    "video_url": "https://vimeo.com/sothebys/15cpw-penthouse",
    "floorplan_urls": [
      "https://img.sothebysrealty.com/eng/3m7n2h/floorplan/main.jpg"
    ],
    "virtual_tour_url": "https://my.matterport.com/show/?m=3m7n2h-cpw41a"
  },
  "price": 49500000,
  "title": "Penthouse at 15 Central Park West",
  "mls_id": "RLS20023184",
  "status": "for_sale",
  "lot_sqm": null,
  "bedrooms": 4,
  "currency": "USD",
  "location": {
    "city": "New York",
    "state": "NY",
    "address": "15 Central Park West, Apt 41A",
    "country": "United States",
    "latitude": 40.7705,
    "longitude": -73.9817,
    "postal_code": "10023"
  },
  "amenities": {
    "exterior": [
      "private_terrace",
      "city_views",
      "park_views"
    ],
    "interior": [
      "herringbone_floors",
      "chef_kitchen",
      "wine_storage",
      "home_office",
      "walk_in_closet"
    ],
    "community": [
      "doorman_24h",
      "lap_pool",
      "gym",
      "screening_room",
      "valet_parking"
    ]
  },
  "bathrooms": 4.5,
  "listed_at": "2026-04-21T00:00:00.000Z",
  "lot_acres": null,
  "updated_at": "2026-05-12T00:00:00.000Z",
  "year_built": 2008,
  "description": "Perched on the 41st floor of 15 Central Park West, this four-bedroom penthouse offers panoramic views of Central Park, the Manhattan skyline, and the Hudson River. The 4,920-square-foot residence features a 35-foot great room with herringbone hardwood floors, a chef's kitchen by Bulthaup, a primary suite with two dressing rooms, and a private 600-square-foot terrace.\n\nResidents of 15 Central Park West enjoy the building's full-service amenities, including a 75-foot lap pool, a fitness center, a private screening room, and 24-hour doorman service.",
  "interior_sqm": 457,
  "interior_sqft": 4920,
  "property_type": "condo",
  "price_on_request": false
}
```

## Documentation

## Overview

Sotheby's International Realty is the global luxury real estate network with affiliated offices in more than 80 countries. The ad endpoint returns the full property detail page parsed as JSON: marketing description, every photo, the Matterport tour when available, floorplans, agent contact (name, email, phone), affiliate office, MLS ID, coordinates, and amenities split into interior, exterior, and community. The site uses Cloudflare Turnstile and a CAPTCHA challenge. Piloterr handles them.

## Quickstart

```
GET https://api.piloterr.com/v2/sothebysrealty/ad?query=https://www.sothebysrealty.com/eng/sales/detail/180-l-1842-3m7n2h/15-cpw-penthouse-15-central-park-west-new-york-ny-10023
```

## Main use cases

- Enrich a private banking CRM with full listing context (price, beds, sqft, agent contact) when a relationship manager pastes a property URL
- Build a comparables database for luxury appraisers joining MLS ID, interior sqft, lot acres, year built, and listed price
- Train a luxury feature extraction model on marketing descriptions and amenity tags to surface wine cellars, helipads, and equestrian facilities
- Pull full-resolution images and Matterport tour URLs into a concierge presentation tool for relocation services
- Track price and status changes over time to feed a luxury days-on-market dashboard

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