v1

OpenAPI 3.0.42026-07-14475158859.0 KB
Ganjoor

get a random poem from a poet (c.ganjoor.net replacement), 0 means random poet, حافظ (2)، خیام (3)، ابوسعید ابوالخیر (26)، صائب (22)، سعدی (7)، باباطاهر (28)، مولوی (5)، اوحدی (19)، خواجو (20)، شهریار (35)، عراقی (21)، فروغی بسطامی (32)، سلمان ساوجی (40)، محتشم کاشانی (29)، امیرخسرو دهلوی (34)، سیف فرغانی (31)، عبید زاکانی (33)، هاتف اصفهانی (25) یا رهی معیری (41)

get/api/ganjoor/poem/random

Query parameters

poetIdinteger

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