One random quote per call. English serves 2,132 classic quotes with authors; the Chinese corpus holds 11,267 one-liners in 12 categories, also available in Traditional Chinese (Taiwan / Hong Kong variants).
| Method & path | Description |
|---|---|
GET /v1/hitokoto | Returns one random quote |
GET /v1/hitokoto/categories | Category list with per-category counts (Chinese corpus; names follow lang) |
| Parameter | Values | Description |
|---|---|---|
lang | en / zh (default) / hant / tw / hk | This page uses en. hant and tw return the Taiwan traditional variant, hk the Hong Kong variant |
c | a–l, multiple allowed | Restrict to categories (comma-separated, e.g. c=d,i). Chinese corpus only |
min_length | integer ≥ 0 | Minimum quote length in characters |
max_length | integer | Maximum quote length; returns 404 when nothing matches |
Categories: a Anime · b Comics · c Games · d Literature · e Original · f Internet · g Other · h Film & TV · i Poetry · j NetEase Music · k Philosophy · l Humor.
{"code":0,"message":"ok","data":{"id":42,"hitokoto":"The Superior Man is aware of Righteousness, the inferior man is aware of advantage.","type":null,"type_name":null,"from":null,"from_who":"Confucius","tags":["famous-quotes"],"length":83,"lang":"en"}}
| Field | Description |
|---|---|
hitokoto | The quote text |
from_who | Author / speaker (null when unknown). For Chinese quotes, from carries the source work |
tags | Topic tags (English quotes) |
type / type_name | Category key and name (Chinese corpus); null for English |
length | Length of the quote in characters |
The raw JSON response will appear here
Chinese sentences come from the official sentence bundle of the Hitokoto open-source community, hitokoto-osc/sentences-bundle, under AGPL-3.0. This site syncs with upstream regularly, and sentences removed upstream are taken down here as well; every sentence keeps its original source and author attribution. Traditional Chinese variants are converted from the Simplified originals with OpenCC (Taiwan and Hong Kong rule sets) and stored alongside.
English quotes (2,132 in total) are mainly compiled from the dataset of the open-source quotable project (MIT License), merged with the public DummyJSON quotes collection, which is re-synced monthly (additions picked up, removals followed).
This endpoint group has been called 44 times in total · 0 today · All endpoints
| Endpoint | Path | Today | Total |
|---|---|---|---|
| Hitokoto | /v1/hitokoto | 0 | 43 |
| Categories | /v1/hitokoto/categories | 0 | 1 |