Sayyarat Documentation

Public Docs

Client-safe integration guidance for API usage, auth, listing lifecycle, media, and search.

Public surfacesearch-spec.md

Search Specification

Principle

Structured-first, AI-assisted

---

Flow

  1. normalize query
  2. parse intent
  3. build structured query
  4. query DB
  5. rank results

---

Example

Input: BMW 320i

Parsed:

  • make: BMW
  • series: 3 Series
  • variant: 320i

---

Matching Tiers

  1. exact match
  2. same series
  3. same make
  4. fallback text

---

Ranking

exact > close > family > make > fallback

---

AI Role

Use for:

  • parsing
  • normalization

Avoid:

  • filtering
  • DB querying