Ganjoor

API

Free API for classic Persian poetry, manuscripts, recitations & music tracks

Overview

The Ganjoor API offers RESTful access to an extensive library of classic Persian poetry from renowned poets like Hafez, Rumi, and Saadi. Key endpoints enable retrieval of poet profiles, their divans (collections), individual verses, manuscript metadata/links, audio recitations, and music tracks paired with poems. Responses are in JSON format, facilitating seamless integration into educational apps, cultural platforms, or personal projects focused on Persian literary heritage. It requires no authentication, making it accessible for developers of all levels to explore and showcase Persian poetic works.

Example Integration (JavaScript)

script.js JS


fetch('https://api.ganjoor.net')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful architecture
JSON response format
No authentication required
Access to classic Persian poets & works
Manuscript metadata & links
Audio recitations and music tracks

Frequently Asked Questions

? Is the Ganjoor API free to use?

Yes, the Ganjoor API is completely free for public use with no paid tiers or hidden costs.

? Does it require an API Key?

No, the Ganjoor API does not require any authentication or API key to access its endpoints.

? What is the response format?

All responses from the Ganjoor API are in JSON format, making it easy to integrate with various applications.

Top Alternatives

Unofficial Hafez Poetry API Search Google

Persian Literary Heritage APIs (limited options) Search Google

Tool Info

Pricing Free

Category Books

Platform Public API

Pros

⊕ Free and open access
⊕ Extensive collection of classic Persian poetry
⊕ Included multimedia (manuscripts, recitations, music)
⊕ Easy integration with JSON responses
⊕ No API key needed

Cons

⊖ Potential rate limits for high-volume requests
⊖ Content limited to Persian language
⊖ No official service level agreement (SLA)