v1
latestOpenAPI 3.0.42026-07-14475158859.0 KBGanjoor
get a random poem from hafez
get/api/ganjoor/hafez/faal
Response
OK
idinteger
Id
titlestring nullable
title
fullTitlestring nullable
cat + parent cats title + title
urlSlugstring nullable
url => slug
fullUrlstring nullable
sample: /hafez/ghazal/sh1
plainTextstring nullable
verses text
htmlTextstring nullable
verses text as html (ganjoor.net format)
sourceNamestring nullable
source name
sourceUrlSlugstring nullable
source url slug
oldTagstring nullable
old collection or book name for Saadi's ghazalyiat (طیبات، خواتیم و ....)
oldTagPageUrlstring nullable
old collection page url e.g /saadi/tayyebat
mixedModeOrderinteger
order when mixed with categories
publishedboolean
published
languagestring nullable
language
poemSummarystring nullable
poem summary
sectionIndexinteger nullable
section index
claimedByMultiplePoetsboolean
poem is claimed by multiple poets
coupletsCountinteger nullable
couplets count