POST FAQ Matcher API

[!IMPORTANT]
Prerequisite: Before you can match queries, you must first upload your FAQs and create a collection using the FAQ Collections API to obtain a valid collection_id.

Pipeline & Adaptive Reranking

The FAQ Matcher API runs an advanced semantic pipeline to ensure high precision across multiple languages while maintaining low overhead:

• 🌐 Multilingual & Cross-Language Retrieval: If direct search confidence is low, the pipeline automatically detects the language (supporting Hindi, Hinglish, Gujarati, Bengali, Telugu, Marathi, Spanish, etc.) and normalizes it to a retrieval-oriented English intent query.
• 🤖 Adaptive AI Reranker: If candidates have close vector similarity scores (gap < 0.15) or low overall confidence (< 0.70), the matcher dynamically invokes an AI model reranker to determine the correct target FAQ by context. Clear winners bypass the reranker to optimize API cost.
• 🛡️ Robust Provider Fallback: If the primary AI reranker encounters failures (timeouts/rate-limits), the service catches the exception and falls back safely to vector-similarity ranks without disrupting the client.

Example Request

{
  "collection_id": 12,
  "query": "how to update my passcode?",
  "min_confidence": 0.4,
  "top_n": 1
}

curl -X POST https://rsflowhub.com/api/v1/ai/faq-match \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '\''{
    "collection_id": 12,
    "query": "how to update my passcode?",
    "min_confidence": 0.4,
    "top_n": 1
  }'\''

Example Response

{
  "success": true,
  "request_id": "req_7f3a9c2d1e4b8a6f",
  "data": {
    "result": {
      "matches": [
        {
          "id": "faq_1",
          "question": "How do I reset my password?",
          "answer": "Go to Account Settings > Security and click on 'Change Password'.",
          "confidence": 0.9562,
          "match_reason": "Semantic similarity match."
        }
      ]
    }
  },
  "meta": {
    "version": "v1",
    "timestamp": "2026-09-27T12:34:56+00:00"
  }
}

API Request Example

Use the cURL snippet below to test the endpoint.

curl -X POST 'https://rsflowhub.com/api/v1/ai/faq-match' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "collection_id": 12,
    "query": "how to update my passcode?",
    "min_confidence": 0.4,
    "top_n": 1
}'

Want to try it without code? Test this request in the live Playground.