Neither endpoint needs a CAPTCHA token. Both take a client key.

Suggested questions

The starter questions to show before the user has typed anything.
GET https://app.kelu.dev/api/v1/public/knowledge-bases/:knowledgeBaseId/suggested-questions
curl https://app.kelu.dev/api/v1/public/knowledge-bases/KB_ID/suggested-questions \
  -H "X-Client-Key: kl_pk_..."
{
  "questions": [
    "How do I authenticate API requests?",
    "What are the rate limits?",
    "How do I set up webhooks?"
  ]
}
What comes back depends on the knowledge base’s Settings → Starter Questions → Shown questions:
SettingResponse
Generated from your content (default)Up to 4 questions written from the titles of your public documents. Restricted documents are never used. Refreshed after any sync that adds, changes or removes a document, and otherwise every 24 hours. Empty until a public document is indexed
My own questionsYour questions, in your order. Up to 8, each up to 200 characters
None{"questions": []}
An empty list is normal. Show nothing. Pages related to a query or to the page the reader is on. Good for “read next” lists.
POST https://app.kelu.dev/api/v1/public/knowledge-bases/:knowledgeBaseId/related
FieldTypeRequiredDescription
querystringYesA topic, question or page title
curl https://app.kelu.dev/api/v1/public/knowledge-bases/KB_ID/related \
  -H "X-Client-Key: kl_pk_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "webhook signatures"}'
{
  "articles": [
    {
      "url": "https://docs.example.com/webhooks/security",
      "title": "Verifying Webhook Signatures",
      "snippet": "Every webhook delivery is signed with an HMAC ..."
    }
  ],
  "count": 1,
  "powered_by": "Powered by Kelu",
  "powered_by_url": "https://kelu.dev"
}
  • Up to 5 pages, one entry per page, best match first.
  • snippet is the matching passage, cut at 200 characters.
  • The list is called articles, not results as in search.
  • Searches the knowledge base within the client key’s allowed source groups, if the key has any. It takes no group_ids. Restricted documents are never returned.