Piloterr

Realtor Search

Search Realtor.com listings from a search URL and retrieve prices, beds, baths, sqft, photos, and property metadata.

Credit cost: 2 credits per call

GET
/v2/realtor/search

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 search results URL.

Example 1 (state search):

https://www.realtor.com/realestateandhomes-search/New-York_NY

Example 2 (city search):

https://www.realtor.com/realestateandhomes-search/Brooklyn_NY

Notes:

  • Only Realtor.com search URLs are accepted.
  • Filters and pagination parameters in the URL are respected.
  • Use each result's permalink or property detail URL with the Realtor Property endpoint.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/realtor/search?query=string"
{
  "results": [
    {
      "photos": [
        {
          "href": "https://ap.rdcpix.com/67dd84d210896e04e1252c2c8bc52c57l-m3226683124s.jpg"
        }
      ],
      "location": {
        "address": {
          "city": "Brooklyn",
          "line": "299 Troutman St",
          "state": "NY",
          "postal_code": "11237"
        }
      },
      "permalink": "299-Troutman-St_Brooklyn_NY_11237_M99576-61733",
      "list_price": 500000,
      "description": {
        "beds": 16,
        "sqft": 6500,
        "type": "SingleFamilyResidence",
        "baths": 8,
        "lot_size": 2500
      },
      "property_id": "9957661733"
    },
    {
      "photos": [
        {
          "href": "https://ap.rdcpix.com/eac307cc2348e0014f42e489f57f5d02l-m3092249856s.jpg"
        }
      ],
      "location": {
        "address": {
          "city": "Bronx",
          "line": "D132 Edgewater Unit D",
          "state": "NY",
          "postal_code": "10465"
        }
      },
      "permalink": "D132-Edgewater-Unit-D_Bronx_NY_10465_M94332-74355",
      "list_price": 255000,
      "description": {
        "beds": 4,
        "sqft": 1200,
        "type": "SingleFamilyResidence",
        "baths": 1,
        "lot_size": null
      },
      "property_id": "9433274355"
    },
    {
      "photos": [
        {
          "href": "https://ap.rdcpix.com/77415ad2b4919799a0cb455c54eab3fcl-m2351895655s.jpg"
        }
      ],
      "location": {
        "address": {
          "city": "New York",
          "line": "2573 Frederick Douglass Blvd Apt A",
          "state": "NY",
          "postal_code": "10030"
        }
      },
      "permalink": "2573-Frederick-Douglass-Blvd-Apt-A_New-York_NY_10030_M92978-65175",
      "list_price": 275000,
      "description": {
        "beds": 2,
        "sqft": 1175,
        "type": "Apartment",
        "baths": 2.5,
        "lot_size": null
      },
      "property_id": "9297865175"
    },
    {
      "photos": [
        {
          "href": "https://ap.rdcpix.com/e5f2913192e3c223cc21e05ea213844el-m1072321830s.jpg"
        }
      ],
      "location": {
        "address": {
          "city": "Woodhaven",
          "line": "86-34 77th St",
          "state": "NY",
          "postal_code": "11421"
        }
      },
      "permalink": "8634-77th-St_Woodhaven_NY_11421_M46500-03200",
      "list_price": 603200,
      "description": {
        "beds": 6,
        "sqft": null,
        "type": "SingleFamilyResidence",
        "baths": 2,
        "lot_size": 2614
      },
      "property_id": "4650003200"
    }
  ]
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}