API documentation

Kundo's API makes it possible to fetch all the data in your forum, and integrate it into your application or website.

Table of contents

If everything went well a 201 CREATED response will be returned:

HTTP/1.1 201 CREATED
Content-Type: text/plain
...

CREATED
The dialog or comment was created without problems.

Fetching data

https://kundo.se/api/kundo.json
All dialogs in your forum. Limited to 50 dialogs per request - see pagination.
https://kundo.se/api/kundo/questions.json
All dialogs with topic "questions". Available topics: questions, problems, suggestions, and praises, or in their abbreviated forms: Q, P, S, and B (Why B for praise? Because "P" was taken :).
You may also have custom categories set up for your account. Use the category slug as the topic for this call.
https://kundo.se/api/kundo/questions,problems.json
It's also possible to select dialogs from multiple topics. Just send in a comma separated lists of the topics you want.

You can also fetch just the most popular dialogs, including just the most popular dialogs in a specific category. Popularity is also available as a sorting parameter to all dialog queries.

Each element in an API response contains a property called "uri", with an URL that can be used to access details about that object. NOTE: We've tried hard to include as much data as possible in the listing calls, so you might not need to use the details view.

https://kundo.se/api/dialog/kundo/1.json
All information we have on the dialog with id=1. Take statistics into concern - see register page views.

Using the "comments_uri" property you can fetch comments for a given dialog.

https://kundo.se/api/comment/kundo/1.json
All comments for the dialog with id=1. Limited to 50 comments per request - see pagination.
https://kundo.se/api/search/kundo/test.json
Search through all the dialogs that contain "test". Limited to 10 dialogs per query. Make sure you clean your users search input from newlines and other invalid URL formating. Only the first 50 terms and a total query length of 500 will be considered in the search.
https://kundo.se/api/search/kundo/test.json?livesearch=1
If you are building an autocomplete-style search you might want to add livesearch=1 parameter to your searches. This ignores "quoted phrases" and returns a shorter text snippet length for use in a dropdown. We use this for Kundo's own autocomplete feature on our site.
https://kundo.se/api/search/kundo/test.json?snippetlength=200
You can control the length of the text snippet returned from the API. The maximum length is 300.
https://kundo.se/api/search/kundo/test.json?category_slug=questions
Search through all the dialogs that contain "test" in the category "questions". Limited to 10 dialogs per query.
https://kundo.se/api/search/kundo/test.json?category_slug=questions
Search through all the dialogs that contain "test" in the category "questions". Limited to 10 dialogs per query.
https://kundo.se/api/search/kundo/test.json?category_slug=questions,problems
Search through all the dialogs that contain "test" in the categories "questions" or "problems". Limited to 10 dialogs per query.

When building a customized forum start page, it can be helpful to be able the fetch the customizable settings for a forum instead of hardcoding them.

https://kundo.se/api/properties/kundo.json
Configurable properties of the forum.

Properties returned:

nameThe forum name
formal_nameFormal company name. May be different from the forum name
intro_messageA short description of the forum
status_messageTemporary message displayed above the feedback form
status_urlURL where user can read more about the status message.
popup_headerHeader text for the popup window
default_topicThe topic that should be selected by default
enabled_topicList of all available topics
languageThe language setting of the forum
https://kundo.se/api/editorlist/kundo.json
List of all public editors in the forum with name, title and picture.