Search Requires WooCommerce

Headless Fuzzy Find

Fast WooCommerce product search powered by FULLTEXT indexes and Levenshtein fuzzy matching. Supports weighted relevance scoring across title, SKU, description, attributes, categories, and tags. Built-in autocomplete, synonym expansion, and search analytics.

View Source

Features

FULLTEXT index with weighted relevance scoring

Fuzzy correction via Levenshtein distance (handles typos like "shrt" → "shirt")

Search-as-you-type autocomplete endpoint

Synonym expansion support

"Did you mean" suggestions for zero-result queries

Search analytics tracking (popular searches, zero-result queries)

API Endpoints

Method	Path	Description
GET	/headless-fuzzy-find/v1/search	Paginated search with weighted scoring
GET	/headless-fuzzy-find/v1/autocomplete	Search-as-you-type suggestions

API Example

# Fuzzy search (handles typos)
curl "https://store.example.com/wp-json/headless-fuzzy-find/v1/search?q=shrt&per_page=3"

{
  "results": [
    {
      "id": 156,
      "title": "Classic Cotton Shirt",
      "slug": "classic-cotton-shirt",
      "price": "29.99",
      "image": "https://store.example.com/wp-content/uploads/shirt.jpg",
      "score": 8.42
    },
    {
      "id": 203,
      "title": "Slim Fit Polo Shirt",
      "slug": "slim-fit-polo-shirt",
      "price": "34.99",
      "image": "https://store.example.com/wp-content/uploads/polo.jpg",
      "score": 7.18
    }
  ],
  "total": 12,
  "pages": 4,
  "suggestion": "shirt"
}

FAQ

How does the relevance scoring work?

Title matches are weighted highest, followed by SKU, then short description, attributes, categories/tags, and finally full description. Exact matches rank above fuzzy matches.

Does it replace the default WooCommerce search?

It provides a separate REST API endpoint. Your headless frontend calls this instead of the default WP search. The default search remains available for the WordPress admin.