Piloterr

Realtor Property

GET
/v2/realtor/property

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

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full Realtor.com property detail URL.

Example:

https://www.realtor.com/realestateandhomes-detail/1492-E-57th-St_Brooklyn_NY_11234_M46117-61190

Notes:

  • Only Realtor.com /realestateandhomes-detail/ URLs are accepted.
  • Copy the listing URL from search results or from realtor.com.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/realtor/property?query=string"
{  "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}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}