QANATIX
API ReferenceInteractive ReferenceSearch

Hybrid search (POST)

Search entities within a vertical using hybrid search (dense + sparse vectors + DBSF fusion). Supports natural language queries, keyword search, and identifier exact match (EAN, part numbers, DIN/ISO codes). **Search modes** (auto-detected from query): - **Identifier**: Exact payload match for EAN/GTIN, DIN/ISO codes, part numbers, SKUs. Score = 1.0. - **Hybrid**: Dense (semantic) + sparse (BM25/keyword) vector search with DBSF score fusion. BGE-M3 provider adds ColBERT late-interaction rescoring. - **Degraded**: Postgres full-text search fallback when Qdrant is unavailable. **Zero-result fallback chain**: If hybrid search returns no results, the system automatically (1) relaxes user filters, (2) falls back to dense-only search, (3) returns empty with metadata flag. **Filters**: Key-value params applied as Qdrant payload conditions. Conventions: `field=val` (exact), `field_min` (>=), `field_max` (<=), `field_gt` (>), `field_lt` (<). Tenant isolation and archived-entity exclusion are always enforced.

POST
/api/v1/search/{vertical}

Path Parameters

vertical*string

Vertical to search (e.g., 'manufacturing', 'healthcare'). Must match the vertical used during ingestion.

Header Parameters

x-tenant-id?|
authorization?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://loading/api/v1/search/manufacturing" \  -H "Content-Type: application/json" \  -d '{    "filters": {      "entity_type": "product"    },    "limit": 10,    "offset": 0,    "query": "deep groove ball bearing 25mm"  }'
{
  "metadata": {
    "processing_time_ms": 42.5,
    "query_type": "keyword",
    "search_mode": "hybrid",
    "total_estimate": 1,
    "zero_result_fallback_used": false
  },
  "pagination": {
    "has_more": false,
    "limit": 10,
    "offset": 0
  },
  "results": [
    {
      "description_llm": "SKF. Deep Groove Ball Bearing 6205. Bore diameter: 25mm.",
      "entity_id": "550e8400-e29b-41d4-a716-446655440000",
      "entity_type": "product",
      "name": "Deep Groove Ball Bearing 6205",
      "score": 0.87,
      "source_type": "file_upload",
      "updated_at": "2026-03-06T12:00:00Z",
      "vertical": "manufacturing",
      "vertical_data": {
        "manufacturer": {
          "country": "SE",
          "name": "SKF"
        },
        "pricing": {
          "currency": "EUR",
          "max": 12.5,
          "min": 8.5
        }
      }
    }
  ]
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}