List Featured Listings

Returns the collections the agent shows on the homepage, each with listing cards, plus the saved searches chosen for the homepage.

GET/v1/featured-listings

Authentication

Public key?key=pk_…

Public key in the `key` query parameter. No OAuth, no secret.

Edge cache: private, no-store

Query Parameters

keystring

required

The site's public key (pk_…). It selects the account. Safe to ship to the browser.

limitnumber

optional

Cards per collection. Values above 24 are capped at 24.

Default:12

Responses

200Success

application/json

collectionsarray

Up to 12 collections. `listings` holds the first `limit` cards in the agent's order, `totalCount` counts all listings still in the feed, `images` is the card photo collage.

savedSearchesarray

Homepage saved searches. Send `query` as the body of `POST /v1/search` to list its results.

Errors

401Missing or invalid public key.

403The account is not active. The body also has `code: "TENANT_INACTIVE"`.

500Internal Server Error.

Notes

The server keeps its own copy for 5 minutes, but the response itself is not edge-cached.
Each card links to `GET /v1/listings/:listingId` with its `OriginatingSystemKey`. Street fields are null when the MLS hides the address.

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/featured-listings?key={{public_key}}&limit=6"

Response200 OK

{
  "collections": [
    {
      "id": "693826b20d1c8d8f41bdf273",
      "name": "Waterfront Picks",
      "slug": "waterfront-picks",
      "path": "/collection/waterfront-picks",
      "totalCount": 6,
      "listings": [
        {
          "_id": "6710a1b2c3d4e5f600000101",
          "ListingId": "A11855701",
          "OriginatingSystemKey": "miamire",
          "ListPrice": 725000,
          "LivingArea": 1180,
          "BedroomsTotal": 2,
          "BathroomsTotalInteger": 2,
          "StreetNumber": "1200",
          "StreetName": "Brickell Bay Dr",
          "UnitNumber": "2504",
          "City": "Miami",
          "StateOrProvince": "FL",
          "PostalCode": "33131",
          "StandardStatus": "Active",
          "PropertyType": "Residential",
          "PropertySubType": "Condominium",
          "image": "https://example.com/photos/A11855701/1.jpg",
          "Location": {
            "coordinates": [
              -80.1892,
              25.7651
            ]
          }
        }
      ],
      "images": [
        "https://example.com/photos/A11855701/3.jpg"
      ]
    }
  ],
  "savedSearches": [
    {
      "id": "66f1a2b3c4d5e6f700000001",
      "title": "Brickell Condos",
      "slug": "brickell-condos",
      "path": "/search/brickell-condos",
      "query": "q=Brickell&qtype=city&minbeds=2&subtypes=Condominium",
      "images": [
        "https://example.com/photos/A11855701/1.jpg"
      ],
      "total": 214
    }
  ]
}