Bettertori LogoBettertori Docs
Features

Advanced AI Search

Discover BetterTori's intelligent search powered by AI. Learn how to use natural language queries, smart filters, and AI-assisted matching to find exactly what you're looking for on Tori.fi.

Advanced AI Search

BetterTori's intelligent search uses AI to understand your natural language queries and find the best matches across all your tracked Tori.fi items.

How AI Search Works

┌─────────────────────────────────────────────────────────────────────────────┐
│                         AI SEARCH FLOW                                       │
└─────────────────────────────────────────────────────────────────────────────┘

   YOU TYPE                           AI PROCESSING                     RESULTS
     │                                      │                              │
     ▼                                      ▼                              ▼
┌──────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────────────┐
│ Natural  │      │  GPT-4o-mini │      │  Meilisearch │      │   Best Match     │
│ Language │─────▶│   Parser     │─────▶│    Query     │─────▶│   Displayed      │
│  Query   │      │              │      │              │      │                  │
└──────────┘      └──────────────┘      └──────────────┘      └──────────────────┘
       │                 │                     │                      │
       │                 │                     │                      │
       ▼                 ▼                     ▼                      ▼
 "iPhone 14        Intent: BUY          Filters Applied:         Top Match
  Pro Max          Product: iPhone      • Condition: new         Selected by AI
  Helsinki         Location: Helsinki   • Price: < 900€          + All Results
  under 900€"      Price: max 900€      • Area: Helsinki         in Results Table
                   Condition: new       • is_sold: false
                                        • is_reserved: false

┌─────────────────────────────────────────────────────────────────────────────┐
│                         SMART PARSING EXAMPLES                               │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  INPUT                    │  AI UNDERSTANDS           │  FILTERS APPLIED     │
│  ──────────────────────── │  ───────────────────────  │  ─────────────────── │
│  "cheap PS5 games"        │  • PS5 = PlayStation 5    │  • product_id: 109   │
│                           │  • cheap = budget price   │  • price < 100€      │
│  ──────────────────────── │  ───────────────────────  │  ─────────────────── │
│  "bike today Helsinki"    │  • bike = bicycle         │  • area: Helsinki    │
│                           │  • today = last 24 hours  │  • created_at: 1d    │
│  ──────────────────────── │  ───────────────────────  │  ─────────────────── │
│  "käytetty läppäri"       │  • käytetty = used        │  • condition: good   │
│                           │  • läppäri = laptop       │  • category: laptops │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                      SEARCH CACHE LAYER                                      │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│   First Search            Subsequent Searches                                │
│   ────────────            ─────────────────                                  │
│                                                                              │
│   Query ──▶ AI Parser ──▶ DB Search ──▶ Results                              │
│     │           │             │                                                  │
│     │           │             ▼                                                  │
│     │           │        [CACHE 5 min] ◀── Same query within 5 min             │
│     │           │             │                                                  │
│     │           └─────────────┘              Instant Results (no AI call)      │
│     │                                                                          │
│   ~1-2 seconds        ~50-100ms                                               │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Instead of searching for exact keywords, you can type what you're looking for in plain English (or Finnish), and the AI will understand your query.

Natural Language Understanding

The AI understands context and intent:

  • "iPhone 14 Pro Max in Helsinki under 800€" → Finds iPhones matching these criteria
  • "cheap PlayStation 5 games" → Interprets "cheap" as a price range
  • "bicycle good condition Tampere" → Filters by location and condition
  • "gaming laptop today" → Prioritizes items listed today

Smart Query Interpretation

The AI automatically handles:

  • Abbreviations: "PS5" → "PlayStation 5"
  • Price terms: "cheap", "expensive", "budget" → Automatic price ranges
  • Time frames: "today", "this week", "last month" → Date filters
  • Locations: City and region names → Geographic filtering
  • Condition: "new", "good", "used" → Item condition filters

Search Interface

Located at the top of the Search page, the search bar accepts natural language queries:

  1. Type your search query naturally
  2. Press Enter or click the Search button
  3. View AI-interpreted results

alt

AI Best Match

When you search, BetterTori uses AI to identify the single best matching item and displays it prominently:

The Best Match section shows:

  • Item Preview: Image, name, price, and location
  • AI Reasoning: Why this item was selected as the best match
  • Quick Actions: Go to item or open on Tori.fi

alt

The Best Match is calculated using multiple factors including price, location relevance, condition, and listing freshness.

Search Results

Results Overview

After searching, you'll see:

  1. Search Term: Displays what you searched for
  2. Total Results: Number of matching items found
  3. Price Chart: Visual chart showing price distribution of results
  4. Item List: All matching items in a sortable table

alt

Price Visualization

The interactive price chart helps you understand the market:

  • X-axis: Date posted (last 7 days by default)
  • Y-axis: Price in EUR
  • Data points: Individual items positioned by date and price
  • Tooltips: Hover over points to see item details

alt

This helps you identify:

  • Price trends over time
  • Whether an item is priced fairly
  • Best times to buy

Results Table

All matching items are displayed in a comprehensive table with:

  • Image: Product photo
  • Product Name: Full item title
  • Price: Current listing price
  • Area: Seller's location
  • Date: When the item was listed
  • Condition: New, good, fair, or poor (when available)
  • Actions: Quick links to view item

alt

Smart Filters

The AI automatically applies filters based on your query, but you can also refine results manually:

Automatic Filters

Based on your search query, the AI may apply:

  • Location filters: "in Helsinki" → Only Helsinki items
  • Price ranges: "under 500€" → Max price 500€
  • Date filters: "posted today" → Today's listings only
  • Condition filters: "like new" → New or good condition items

Manual Refinement

Use the dashboard filters to further narrow results:

  • Sort by price (high/low) or date
  • Filter by date range
  • Exclude reserved or sold items
  • Filter by specific product categories

You can read more about the sorting and filtering features here.

Search Tips & Tricks

Effective Query Patterns

Be Specific

Good: "iPhone 14 Pro 256GB Helsinki"
Less effective: "iPhone"

Include Price Intent

Good: "budget laptop under 400€"
Good: "gaming PC expensive"

Add Location

Good: "mountain bike Tampere"
Good: "furniture pickup Espoo"

Specify Condition

Good: "used bicycle good condition"
Good: "brand new sealed PS5"

Time-Based Searches

Find fresh listings:

  • "today" or "posted today" → Last 24 hours
  • "this week" → Last 7 days
  • "recent" → Prioritizes newest items

Understanding Search Results

Why is the Best Match not what I expected?

The AI considers multiple factors:

  • Price relative to market average
  • Location proximity (if specified)
  • Listing freshness
  • Item condition
  • Title and description relevance

AI-Powered Features

Synonym Recognition

The search understands Finnish and English synonyms:

  • "puhelin" ↔ "phone"
  • "käytetty" ↔ "used"
  • "uusi" ↔ "new"
  • "halpa" ↔ "cheap"

Typo Tolerance

Minor spelling mistakes are automatically corrected:

  • "iphnoe" → "iphone"
  • "plyastation" → "playstation"
  • "helsnki" → "helsinki"

Intelligent Matching

The AI understands that:

  • "gaming laptop" should match gaming-capable laptops
  • "kids bike" should match children's bicycles
  • "work monitor" should match office-appropriate displays

Performance & Caching

Search Speed

  • First search: 1-2 seconds (AI processing + database query)
  • Repeat searches: Near-instant (cached results)
  • Cached for: 5 minutes

Cache Indicator

When viewing cached results, you'll see a small indicator showing the search was served from cache for faster loading.

Privacy & Data

Search queries are processed by OpenAI's GPT-4o-mini model to understand intent. No personal data is shared, only your search terms.

What the AI Sees

  • Your search query text
  • General context (shopping terms, locations)

What the AI Doesn't See

  • Your personal information
  • Your tracked items or history
  • Your account details

Limitations

Current Constraints

  • Language: Works best in English and Finnish
  • Complex Queries: Very complex multi-part queries may not work perfectly
  • Marketplace Data: Results limited to items already tracked in BetterTori
  • Real-time: New items appear after email processing (not instant)

Troubleshooting

Search Returns No Results

  1. Check your product categories: Ensure you're tracking the right category
  2. Broaden your search: Try fewer or more general terms
  3. Remove location filters: Search nationwide
  4. Check date range: Items older than your retention period won't appear

Best Match Seems Wrong

  • The AI prioritizes recent, well-priced items
  • Check if your location filter is too restrictive
  • Try rephrasing your query with different terms

Slow Search Results

  • First searches take longer (AI processing)
  • Subsequent searches of the same query are cached

Electronics

"iPhone 15 Pro Max 256GB Helsinki under 1100€"
"MacBook Pro M3 used good condition"
"Samsung Galaxy budget phone"
"Sony WH-1000XM5 headphones"

Gaming

"PlayStation 5 console with games"
"Nintendo Switch OLED new"
"gaming PC RTX 4070"
"Xbox Series X cheap"

Sports & Outdoors

"mountain bike full suspension Tampere"
"golf clubs set beginner"
"kayak inflatable sea"
"ski equipment downhill"

Home & Furniture

"sofa 3-seater fabric"
"dining table 6 persons"
"IKEA bookshelf"
"washing machine energy efficient"

Next Steps

Tori Item Map

Discover the interactive map feature on BetterTori that helps you visualize the exact location of individual items listed on Tori.fi.

Command Palette

Master BetterTori's command palettes for lightning-fast navigation and item management. Learn how to use keyboard shortcuts to search, navigate, and manage items without touching your mouse.