API Reference
Hadiths
Semantic Search

Semantic Search Hadiths

Perform a powerful semantic search using Pinecone vector embeddings to find hadiths by meaning instead of exact keywords. This is ideal for natural language questions.

GEThttps://api.mumin.ink/hadiths/semantic-search
🔐Auth Required

Query Parameters

ParameterTypeRequiredDescription
qstringYesThe semantic query or question
languagestringNoThe language code for translations (default: ru)
limitintegerNoMaximum number of results to return (default: 10)

Response

Returns an array of hadiths sorted by their vector similarity score.

{
  "data": [
    {
      "id": 1,
      "collection": "Sahih al-Bukhari",
      "bookNumber": 1,
      "hadithNumber": 1,
      "arabicText": "إنما الأعمال بالنيات...",
      "translation": {
        "languageCode": "en",
        "text": "The reward of deeds depends upon the intentions..."
      },
      "similarity": 0.9234
    }
  ],
  "total": 1
}

Try It Live! 🤖

GET/hadiths/semantic-search
🔥 Try it live!

Get your API key from dashboard.mumin.ink

q
limit