Get Saved Search

Returns a saved search by slug or ID: the stored query and the clean search path. The owner's saved searches come first, then visitors' shared ones.

GET/v1/saved-searches/:slug

Authentication

Public key?key=pk_…

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

Edge cache: public, max-age=0, s-maxage=5

Path Parameters

slugstring

required

The saved search slug or ID, from `/v1/featured-listings` or a shared `/search/<slug>` link.

Query Parameters

keystring

required

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

Responses

200Success

application/json

savedSearchobject

`slug` is what you requested. `title` is null for a visitor's saved search. `query` is the stored search. `searchPath` is the clean `/search?…` path.

Errors

401Missing or invalid public key.

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

404No saved search matches, or the slug is malformed.

500Internal Server Error.

Notes

Redirect `/search/<slug>` on your site to `savedSearch.searchPath` with a 307, as Panda websites do.
Send `query` as the body of `POST /v1/search` to list the results.
A visitor's saved search never exposes its name or its owner.

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/saved-searches/brickell-condos?key={{public_key}}"

Response200 OK

{
  "savedSearch": {
    "slug": "brickell-condos",
    "title": "Brickell Condos",
    "query": "q=Brickell&qtype=city&minbeds=2&subtypes=Condominium",
    "searchPath": "/search?q=Brickell&qtype=city&minbeds=2&subtypes=Condominium"
  }
}