Ищется красивый визуализатор API

http://sphinx-doc.org/

гляди, в нашем апи около 20 функций.

поэтому тулзы для организации сложной документации - не нужны.

нужен именно красивый, чистый, понятный дизайн.

особенно интересно, как аннотировать результирующий json, с точки зрения хорошего дизайна (и, возможно, иметь такую фичу в том самом движке-визуализаторе)

Гляди, идет время и ваши 20 начнут меняться, добавляться, убавляться и т.д.

Когда их будет много - сделаем что-то другое. А пока нужен хороший дизайн.

Вот пример как люди аналогичную задачу решают с помощью плохого дизайна: http://docs.basho.com/riak/latest/dev/using/search/#Query-Syntax

Всё намешано в кашу, ничего не понятно, в экран не вмещается.

Ну так Sphinx это вполне годно, в конце концов никто ж не требует, чтобы он стоял на вашем боевом сервере

plantuml, graphviz.

Вроде есть такой сайт — аггрегатор документации по апи для различных сервисов, достататочно красивый + есть всякий функционал типо выполнения тестовых запросов.

Ну или просто спереть CSS у twitter/reddit/...

https://www.mashape.com/howitworks

Да, вот это круто.