HOSTED SEARCHBETA

Rules and analytics

Pin and boost listings for a search, and see what visitors search for and open.

Hosted search and WordPress are in private beta. Your account needs the beta enabled to use these APIs.

Rules

A rule applies when a search matches its conditions (for example location = dubai_marina). It can pin listings to positions and boost listings that match filters. You edit rules in the dashboard's visual editor, with the results beside you, and publish them; plans set how many rules an index can publish.

Tracking searches

Add track to the search a visitor settles on (results shown and no new input for about a second, Enter, a page change or a click):

JSON
{
  "track": {
    "query": "2 bed marina under 2m",
    "clicks": true
  }
}

The answer carries a search_id. Words are stored with email addresses and phone numbers removed.

Clicks

curl -X POST https://nabdaq.dev/api/v1/indexes/main-listings/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "events": [
    {
      "type": "click",
      "search_id": "srch_…",
      "listing_id": "MH-12",
      "position": 3
    }
  ]
}'

The dashboard shows searches, the no-result rate, the click-through rate, recent searches by outcome and clicks per listing.