Does Ganjoor offer a free trial or free tier?

Yes, Ganjoor provides a free tier for initial exploration. While it starts at 0 requests per month, it allows developers to set up, authenticate, and test API integration before committing to a paid plan for data retrieval.

How much does the Ganjoor API cost for basic use?

The Starter paid plan for Ganjoor costs $5 per month and includes a quota of 5,000 API requests, suitable for small personal projects or educational applications.

What happens if I exceed my monthly request limit?

The official documentation indicates a tiered pricing model. Typically, exceeding limits in such models might lead to either requests being throttled, additional charges per overage request, or requiring an upgrade to the next tier for continued service. Users should consult Ganjoor's specific terms for their overage policy.

Are there different pricing models for commercial versus academic use?

Ganjoor's primary pricing model is based on monthly request quotas across standard tiers (Starter, Developer, Professional). For high-volume academic or commercial use, an Enterprise plan with custom pricing and scalable limits is available, suggesting flexibility for larger organizations.

How does Ganjoor's pricing compare to general poetry APIs?

Ganjoor specializes in Persian poetry, offering a curated dataset. While general poetry APIs (often free or low-cost) exist for Western poetry, they don't provide Ganjoor's specific cultural content. Ganjoor's request-based pricing is competitive for its niche, saving development time compared to manual data extraction from free literary archives like Project Gutenberg.

Can I upgrade or downgrade my Ganjoor API plan?

Yes, tiered API pricing models generally allow users to upgrade or downgrade their plans as their usage needs change. This flexibility helps in managing costs effectively, ensuring you only pay for the resources you consume.

Ganjoor API Pricing: Plans, Tiers, & Cost Analysis (2026)

Pricing overview

The Ganjoor API provides programmatic access to a comprehensive database of classical Persian poetry. Its pricing structure is designed to accommodate various user needs, from individual developers and researchers to larger educational institutions and commercial applications. The core model is based on monthly subscription tiers, each offering a specific quota of API requests. This allows users to budget predictably for their usage by selecting a plan that aligns with their anticipated request volume.

A notable feature of Ganjoor's pricing is its commitment to accessibility, evidenced by a free tier that permits initial exploration without financial commitment. For more extensive use, paid plans begin at an accessible entry point of $5 per month, scaling up with increased request allowances. This approach aims to make Persian literary data available while sustaining the development and maintenance of the API services, as described in the official Ganjoor API documentation.

Understanding the request-based pricing model is crucial for cost management. Unlike some APIs that charge per data transfer or per processing unit, Ganjoor focuses on the number of calls made to its endpoints. Developers should monitor their API usage, often provided through a dashboard or usage statistics, to ensure they remain within their chosen plan's limits or to anticipate the need for an upgrade. This model is common among content-serving APIs, such as those found for Google Books data, where the primary cost driver is the access to information.

Plans and tiers

Ganjoor offers a structured set of plans and tiers, each tailored to different levels of API consumption. These plans are primarily differentiated by the number of API requests included per month and their corresponding monthly subscription fee. The goal is to provide flexibility, allowing users to select a plan that best fits their project's scale and budget.

Ganjoor API Plan Comparison
Plan Name	Monthly Price	Monthly Request Limit	Best For
Free Tier	$0	0 (initial exploration)	Initial testing, personal learning, very low-volume projects
Starter	$5	5,000	Small personal projects, educational applications, hobbyist development
Developer	$20	20,000	Growing applications, academic research, moderate traffic websites
Professional	$50	75,000	Small-to-medium commercial applications, larger educational platforms
Enterprise	Custom	Custom (scalable)	High-volume commercial projects, large-scale data analysis, extensive integrations

Each tier provides access to the full range of Ganjoor's API functionalities, including endpoints for poets, poems, verses, and search capabilities. The primary distinction lies solely in the volume of allowed requests. Users can typically upgrade or downgrade their plans as their needs evolve, ensuring cost-effectiveness. Specific details regarding overage policies, such as whether additional requests beyond a plan's limit incur a per-request fee or necessitate an immediate upgrade, are typically outlined in the service's terms or more detailed pricing pages on the Ganjoor homepage, which users should consult for the most current information.

Free tier and limits

Ganjoor offers a free tier that serves as an entry point for developers and researchers interested in its Persian poetry database. This free tier is designed for initial exploration, proof-of-concept development, and very low-volume personal use cases. According to the provided information, the free tier starts at 0 requests per month. While this might seem counterintuitive, it usually implies that access is granted, but practical usage for data retrieval requires upgrading to a paid plan or that there's a very minimal, effectively zero-cost allowance for basic authentication and initial setup calls before data retrieval begins to count against a quota.

The primary benefit of the free tier is to allow users to:

Access the API documentation and understand its structure.
Integrate the API into their development environment.
Test authentication mechanisms.
Develop and debug code without immediate financial commitment.

For any significant data retrieval or application functionality, users will need to subscribe to one of the paid plans. This model is common among API providers, balancing the need for developer onboarding with sustainable service provision. It ensures that resources are allocated effectively to paying customers while still fostering community engagement. For example, many cloud providers like AWS offer extensive free tiers but require upgrades for production workloads.

Real-world cost examples

To illustrate Ganjoor's pricing, consider several common scenarios:

Scenario 1: Educational Project (Student)

Use Case: A student developing a mobile app that displays random verses from a specific poet daily. They anticipate making approximately 100 requests per day to fetch a verse and poet details.
Monthly Requests: 100 requests/day * 30 days = 3,000 requests/month.
Recommended Plan: Starter tier (5,000 requests/month for $5).
Monthly Cost: $5.
Analysis: This plan provides ample headroom for the student's project, ensuring they stay well within their limits without incurring additional costs.

Scenario 2: Small Independent Developer (Web Application)

Use Case: An independent developer building a web application that allows users to search the Ganjoor database, generating around 500 search queries and poem lookups daily.
Monthly Requests: 500 requests/day * 30 days = 15,000 requests/month.
Recommended Plan: Developer tier (20,000 requests/month for $20).
Monthly Cost: $20.
Analysis: The Developer plan supports the moderate traffic of a small web application, providing a cost-effective solution for serving a user base without frequent plan adjustments.

Scenario 3: Academic Research Platform

Use Case: A university department creating a platform for textual analysis of Persian poetry, involving batch processing of poems and frequent data retrieval for research tools. They estimate 2,000-2,500 requests daily.
Monthly Requests: 2,500 requests/day * 30 days = 75,000 requests/month.
Recommended Plan: Professional tier (75,000 requests/month for $50).
Monthly Cost: $50.
Analysis: This tier is suitable for higher-volume academic usage, offering a balanced price point for significant data access. Careful monitoring of usage is crucial to avoid exceeding the limit, which might necessitate contact for an Enterprise plan.

How the pricing compares

When evaluating Ganjoor's pricing, it's useful to compare it against alternative sources for literary or poetry data, although direct, feature-for-feature API comparisons can be challenging due to Ganjoor's specialized focus on Persian poetry. Alternatives typically fall into broader categories:

General Poetry Databases (e.g., PoetryDB): APIs like PoetryDB often focus on English poetry and may offer different pricing models, sometimes based on open-source contributions or community-driven access. While they might be free, they lack Ganjoor's specific cultural and linguistic focus. If a project requires only Western poetry, PoetryDB could be a free alternative, but it wouldn't fulfill the need for Persian texts.
Large Digital Libraries (e.g., Project Gutenberg): Project Gutenberg provides a vast collection of public domain e-books, many of which are literary works. Access is generally free, but it requires parsing and processing raw text files to extract structured data, which incurs significant development overhead. There isn't a direct API for structured access to specific verses or poets, making the effort involved much higher than using a purpose-built API like Ganjoor.
Commercial Text Analysis APIs: Broader text analysis or NLP APIs (e.g., from Google Cloud Natural Language or AWS Comprehend) can process text, but they don't provide the curated database of poetry itself. They would be used in conjunction with a data source, adding to the overall cost rather than replacing Ganjoor. Their pricing is typically based on text units processed or features used, which is distinct from Ganjoor's request-based model for content delivery.

Ganjoor's pricing proposition is distinct because it offers a highly specialized, structured dataset for Persian poetry. The cost structure of $5 for 5,000 requests is competitive for a niche content API. For developers whose primary requirement is specific access to Persian literary works, Ganjoor's direct API and curated data set, despite its cost, may represent a more efficient and less labor-intensive solution than attempting to extract and structure data from free, unstructured sources. The value addition lies in the pre-processed, easily accessible nature of the data, which reduces development time and complexity. While some general-purpose APIs might offer a free tier with higher request limits, they would not provide the specialized content Ganjoor delivers.