Skip to main content
GET
/
{apiVersion}
/
{apiProvince}
/
trending_listings
Get Trending Listings
curl --request GET \
  --url https://api.getbuildify.com/{apiVersion}/{apiProvince}/trending_listings \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "_geoloc": {
        "lat": 43.7718016253332,
        "lng": -79.34465277322927
      },
      "_score": 100,
      "amenities": [
        "Landscaped Outdoor Terrace"
      ],
      "architects": [
        "Architects/nBLI3pvltLfrmxrFfJcF"
      ],
      "assignmentFee": 0,
      "assignmentFeeFree": false,
      "averagePricePerSqFeet": 953,
      "brokerLink": "",
      "builders": [
        "Builders/ernCXB3iyrtBvpf8XZX6"
      ],
      "ccOrMaintFee": 0.52,
      "ccOrMaintFeeIncluded": false,
      "ceilingHeights": "9'0''",
      "cityOrDistrict": "Toronto",
      "completionDate": "Sept 2021",
      "completionDateTBD": false,
      "completionYear": 2021,
      "constructionStarted": "2018",
      "constructionStartedTBD": false,
      "constructionStartedYear": 2018,
      "constructionStatus": "Complete",
      "contactForPricing": true,
      "country": "Canada",
      "coverPhoto": {
        "name": "cover",
        "url": "https://storage.googleapis.com/precon-app.appspot.com/bd5beb96-ba76-4762-bbb7-b935e605cf9c.png"
      },
      "createdAt": "2022-12-01T19:34:27.605Z",
      "createdBy": "bernard@getbuildify.com",
      "developmentLevies": "",
      "developmentLeviesIncluded": false,
      "documents": [
        "<string>"
      ],
      "endPrice": "<unknown>",
      "endPricePerSqFeet": 574900,
      "estimatedCompletionDate": "Dec 2021",
      "estimatedCompletionDateTBD": false,
      "estimatedCompletionYear": 2021,
      "exposures": [
        "<string>"
      ],
      "finishes": "",
      "firstOccupancyDate": "Sept 2021",
      "firstOccupancyDateTBD": false,
      "firstOccupancyYear": 2021,
      "floorPlans": [
        {
          "contactForPricing": false,
          "createdAt": "2022-12-08T19:28:19.104Z",
          "exposure": [
            "<string>"
          ],
          "floorPlanType": [
            "Condo"
          ],
          "image": {
            "name": "Photo",
            "url": "https://d2kcmk0r62r1qk.cloudfront.net/imageFloorPlans/2019_04_05_11_44_57_1.jpg"
          },
          "lastUpdated": "2022-12-08T19:28:19.104Z",
          "name": "Sangay",
          "numberOfBathrooms": 1,
          "numberOfBedrooms": 1,
          "planCategory": "floorPlan",
          "squareFeet": "581",
          "startPrice": "574900",
          "status": "Sold Out"
        }
      ],
      "fullAddress": "32 Forest Manor Rd, Toronto",
      "geographicAddress": "32 Forest Manor Rd, Toronto",
      "hasLocker": true,
      "hasParking": true,
      "incentives": [
        "<string>"
      ],
      "interiorDesigners": [
        "InteriorDesigners/aIy93KrY8PdbjlTTzAEV"
      ],
      "lat": "43.771801625333204",
      "listingId": "SUSLKY",
      "lockerMaintainance": 19.95,
      "lockerMaintainanceIncluded": false,
      "logo": {
        "name": "logo",
        "url": "https://storage.googleapis.com/precon-app.appspot.com/06752231-f530-4590-915b-0f8fc9889114.png"
      },
      "long": "-79.34465277322927",
      "marketingCompanies": [
        "Marketers/58bBz696X7ry4FnN9VHX"
      ],
      "maxBaths": 2.5,
      "maxBeds": 3.5,
      "maxSize": 1699,
      "metering": "Hydro, Water, and Heating/Cooling are metered separately ( Maintenance for Townhouses: $0.30/sq ft)",
      "meteringIncluded": false,
      "minBaths": 1,
      "minBeds": 1,
      "minSize": 524,
      "mode": "live",
      "municipalities": [
        "C15"
      ],
      "name": "The Peak at Emerald City",
      "neighbourhood": [
        "Henry Farm"
      ],
      "numberOfFloorPlans": 18,
      "numberOfFloors": "33",
      "numberOfIncentives": 0,
      "numberOfUnits": "374",
      "objectID": "SUSLKY",
      "owners": [
        "<string>"
      ],
      "parkingCost": 60000,
      "parkingCostIncluded": false,
      "parkingMaintainance": 49.95,
      "parkingMaintainanceIncluded": false,
      "parkingRestriction": "",
      "path": "Listings/SUSLKY",
      "paymentStructures": [
        {
          "milestones": [
            {
              "amount": 5000,
              "prefix": "",
              "suffix": "with signing of Agreement",
              "text": "$5000 with signing of Agreement",
              "type": "fixed"
            }
          ],
          "totalDeposit": 20,
          "type": "Standard"
        }
      ],
      "photos": [
        {
          "createdAt": "2022-12-01T19:48:37.848Z",
          "name": "2017_04_19_10_18_28_elad_32072_the_peak_disclaimers_on_renderings_4.jpg",
          "tags": [
            "Interior"
          ],
          "type": "image/jpeg",
          "url": "https://storage.googleapis.com/precon-app.appspot.com/bd94877f-9e38-416f-a5f5-98b0d8189c3d"
        }
      ],
      "postalCode": "M2J 0H2",
      "primaryCollection": "Listings",
      "primaryField": "listings",
      "realtorCommission": 5,
      "realtorPayouts": {
        "commission": 5,
        "contactDeveloper": false,
        "details": ""
      },
      "refLink1": "https://agent.condonow.com/The-Peak-Condos-at-Emerald-City",
      "refLink2": "https://www.buzzbuzzhome.com/toronto-on/the-peak-at-emerald-city",
      "region": "Toronto",
      "salesCompanies": [
        "SalesCompanies/2LaAbcrrhlDDs4dhuO8p"
      ],
      "salesStarted": "",
      "salesStartedYear": "<unknown>",
      "sellingStatus": "Sold Out",
      "startPrice": "<unknown>",
      "startPricePerSqFeet": 859,
      "state": "Ontario",
      "storageCost": 6000,
      "storageCostIncluded": false,
      "storageRestriction": "",
      "streetName": "Forest Manor Rd",
      "streetNumber": 32,
      "summary": "Experience elevated living at The Peak, a striking 33-storey gem. The Peak offers outstanding amenities for your recreational and entertainment pursuits. From the grand lobby to party room, to the pool and sauna, it’s an oasis of convenience and comfort.",
      "tags": [
        "<string>"
      ],
      "type": [
        "Condo"
      ],
      "updatedAt": "2022-12-08T19:28:22.232Z",
      "updatedBy": "bernard@getbuildify.com",
      "videos": [
        "<string>"
      ],
      "virtualShowing": "",
      "website": "https://almadev.ca/past-projects",
      "worksheet": "",
      "worksheetType": "Url"
    }
  ],
  "perPage": 5,
  "total": 5,
  "pages": 1,
  "page": 0
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
apiVersion
enum<string>
required
Available options:
v1-sandbox,
v1
​
apiProvince
enum<string>
default:on
required
Available options:
all,
on,
bc,
ab,
mb,
nb,
nl,
ns,
pe,
qc,
sk

Query Parameters

​
retrieveAttributes
string

Attributes to retrieve. For example: name, summary, builders, etc. It should be comma separated. See more info.

​
referrences
string

Fields to attach referrences. For example: builders, marketers, etc. It should be comma separated. See more info.

​
minScore
integer<int32>

Listings minimum score (from 0 to 100), 100 being most trending.

​
maxRecommendations
integer<int32>

Maximum number of recommendations/results. The maximum value is 30.

Response

200

​
results
object[]
​
perPage
integer
default:0
Example:

5

​
total
integer
default:0
Example:

5

​
pages
integer
default:0
Example:

1

​
page
integer
default:0
Example:

0