Hekimet API

Free, CORS-enabled JSON for Uyghur proverbs, Kutadgu Bilig and folk fables — every text in Arabic, Latin (ULY) and Cyrillic script. Built for language apps, research and sister projects like Tilim and UyghurAI.

ئۇيغۇر ماقال-تەمسىللىرى ئۈچۈن ھەقسىز API — ئۆز ئەپلىرىڭىزدە ئىشلىتىڭ.

120 req/min per IP

X-RateLimit-* headers on every response; 429 with Retry-After.

Stable ids

Ids hash the normalized text, so they survive corpus re-ordering.

Attribution

Credit “Hekimet” with a link back. Never attribute folk proverbs to individuals.

Endpoints

GETParametersDescription
/api/v1/proverbsletter, theme, q, page, limit (≤100)Paginated proverbs; q searches all three scripts and meaning themes.
/api/v1/proverbs/{id}—One proverb with transliterations, themes, share image and related ids.
/api/v1/proverbs/random—A random proverb (never cached).
/api/v1/proverbs/daily—Proverb of the day — identical for everyone on a UTC day.
/api/v1/themes—Theme taxonomy with Uyghur and English labels and counts.
/api/v1/letters—Alphabet index (URL keys, glyphs, counts).
/api/v1/kutadgu-bilig—Kutadgu Bilig excerpts: sections, couplets, Latin transliteration.
/api/v1/stories—Fables with moral, characters and optional narration URL.
/api/v1/dataset—Everything above in one JSON document.
/api/og/proverb/{id}format=square|story|og, script=latin|cyrillicPNG share card with correct Uyghur text shaping.

Quick start

curl "https://hekimet.idirak.com/api/v1/proverbs/daily"
const res = await fetch("https://hekimet.idirak.com/api/v1/proverbs?theme=friendship&limit=5");
const { data } = await res.json();
data.forEach((p) => console.log(p.text, "—", p.latin));

Response shape

{
  "data": [
    {
      "id": "12y9i6g",
      "text": "ئابدالدا ئۇيات يوق، كېپەكتە قۇۋۋەت يوق.",
      "latin": "Abdalda uyat yoq, képekte quwwet yoq.",
      "cyrillic": "Абдалда уят йоқ, кепәктә қуввәт йоқ.",
      "letter": "a",
      "themes": ["honor"],
      "url": "https://hekimet.idirak.com/proverbs/abdalda-uyat-yoq-kepekte-quwwet-yoq-12y9i6g",
      "image": "https://hekimet.idirak.com/api/og/proverb/12y9i6g?format=square"
    }
  ],
  "meta": { "total": 2501, "page": 1, "limit": 1, "pages": 2501 },
  "attribution": { "source": "Hekimet — ئۇيغۇر ھېكمەتلىرى", "url": "https://hekimet.idirak.com", "note": "…" }
}