DEV Community

Alex Spinov
Alex Spinov

Posted on

Manticore Search Has a Free API: Run Elasticsearch-Grade Full-Text Search Without the Complexity

#webdev #api #opensource #database

You just inherited a legacy app with 50 million records and zero search functionality. Your boss wants Google-quality search by Friday. You look at Elasticsearch — and the infrastructure bill alone makes you want to cry.

There is a better way. Manticore Search gives you full-text search that is 4x faster than Elasticsearch on many workloads, runs on a single server with 512MB RAM, and has a completely free HTTP API that feels like talking to a database you actually understand.

What Manticore Search Actually Does

Manticore Search is an open-source full-text search engine written in C++ — built as a fork of Sphinx Search, but modernized with a MySQL-compatible protocol and a REST HTTP API. It stores your data in optimized indexes, handles complex queries with ranking, facets, and fuzzy matching, and responds in milliseconds even at scale.

Unlike Elasticsearch (which is a distributed JVM beast requiring 4GB+ RAM minimum), Manticore runs comfortably on a $5 VPS. It speaks both MySQL protocol (so any MySQL client works) and a clean JSON-over-HTTP API. You get column-oriented storage, real-time indexes, and percolation queries out of the box — no cluster required for most use cases.

The free tier is not a watered-down demo. It IS the product. Every feature is available with zero license cost.

Quick Start: Up and Running in 60 Seconds

Spin up Manticore with Docker:

docker run -e EXTRA=1 --name manticore -p 9308:9308 -p 9306:9306 -d manticoresearch/manticore
Enter fullscreen mode Exit fullscreen mode

Create a table and insert some data:

# Create a table via HTTP API
curl -X POST http://localhost:9308/cli \
  -d 'CREATE TABLE products(title TEXT, description TEXT, price FLOAT, category STRING)'

# Insert a document
curl -X POST http://localhost:9308/insert \
  -H "Content-Type: application/json" \
  -d '{
    "index": "products",
    "doc": {
      "title": "Wireless Bluetooth Headphones",
      "description": "Premium sound quality with 30-hour battery life",
      "price": 79.99,
      "category": "electronics"
    }
  }'
Enter fullscreen mode Exit fullscreen mode

Now search with real full-text ranking:

curl -X POST http://localhost:9308/search \
  -H "Content-Type: application/json" \
  -d '{
    "index": "products",
    "query": {
      "match": { "*": "wireless headphones" }
    },
    "limit": 10,
    "sort": [{"_score": "desc"}]
  }'
Enter fullscreen mode Exit fullscreen mode

Response comes back in under 10ms for millions of records.

3 Practical Use Cases

1. E-commerce Product Search with Facets

Build Amazon-style filtered search in minutes:

curl -X POST http://localhost:9308/search \
  -H "Content-Type: application/json" \
  -d '{
    "index": "products",
    "query": {
      "bool": {
        "must": [{"match": {"title": "headphones"}}],
        "filter": [{"range": {"price": {"lte": 100}}}]
      }
    },
    "aggs": {
      "category_count": {"terms": {"field": "category"}}
    }
  }'
Enter fullscreen mode Exit fullscreen mode

This returns matching products AND a facet count by category — the kind of sidebar filter every e-commerce site needs. One query, one round-trip.

2. Autocomplete with Fuzzy Matching

Users make typos. Handle them gracefully:

curl -X POST http://localhost:9308/search \
  -H "Content-Type: application/json" \
  -d '{
    "index": "products",
    "query": {
      "match": {
        "title": {
          "query": "headphnes",
          "fuzziness": 2
        }
      }
    },
    "highlight": {
      "fields": {"title": {}}
    }
  }'
Enter fullscreen mode Exit fullscreen mode

fuzziness: 2 means up to 2 character edits so "headphnes" matches "headphones". The highlight field wraps matching terms in bold tags automatically.

3. Real-time Log Analysis with Columnar Storage

Manticore supports columnar storage perfect for structured logs:

# Create a logs table with columnar engine
curl -X POST http://localhost:9308/cli \
  -d "CREATE TABLE logs(message TEXT, level STRING, service STRING, ts TIMESTAMP) engine='columnar'"

# Search for errors
curl -X POST http://localhost:9308/search \
  -H "Content-Type: application/json" \
  -d '{
    "index": "logs",
    "query": {
      "bool": {
        "must": [{"match": {"message": "timeout"}}],
        "filter": [{"equals": {"level": "error"}}]
      }
    }
  }'
Enter fullscreen mode Exit fullscreen mode

Columnar engine stores data in columns rather than rows — perfect for analytics queries scanning millions of log entries.

Why This Matters

Elasticsearch has a well-deserved reputation as the industry standard for search — but it comes with massive operational overhead. Most applications do not need a distributed cluster. They need fast, reliable full-text search on a single server that a solo developer can maintain.

Manticore Search fills exactly that gap. The HTTP API is clean and documented at manual.manticoresearch.com. The project is actively maintained with regular releases. And since it speaks MySQL protocol natively, you can query it with your existing ORM while migrating.

If you are running PostgreSQL with ILIKE queries that are bringing your database to its knees — Manticore Search is the upgrade you have been looking for.

Need custom data extraction or web scraping solutions? I build production-grade scrapers and data pipelines. Check out my Apify actors or email me at spinov001@gmail.com for custom projects.

Follow me for more free API discoveries every week!

Top comments (0)