AddictionTube FAQ API

Semantic search and grounded answers for addiction recovery FAQs.

Endpoints

POST /search_faq

Semantic vector search over FAQs.

{
  "query": "how to handle cravings",
  "top_k": 8,
  "category": "Relapse Prevention",
  "subcategory": null,
  "tags": ["mindfulness"]
}

GET /rag_faq

LLM answer grounded on top matching FAQs (citations like [FAQ:123]).

/rag_faq?q=how%20to%20handle%20cravings&k=8

GET /export_faqs

Lightweight JSON export for crawlers/devs.

/export_faqs?size=200
/export_faqs?q=cravings&category=Relapse%20Prevention&tag=mindfulness&size=100

Machine-readable

• /faq/faqs.json (index)
• /openapi.json (OpenAPI)
• /export_faqs (export)

© AddictionTube. Review policy: content is reviewed for clarity and safety. Last updated: 2025-10-07.