RMuseum API

Name: RMuseum API API
Brand: RMuseum API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaContent DeliveryapiKey471 EndpointsREST

For Agents

Read classical Persian poems, poets, categories, and recitations from Ganjoor; submit corrections, manage bookmarks, and access museum artifact metadata.

Connect the RMuseum API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the RMuseum API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with RMuseum API API.

Retrieve a specific poem by id with /api/ganjoor/poem/{id}, including its couplets and metadata

Pull a random Persian poem from the archive via /api/ganjoor/poem/random for daily-poem features

Browse poet categories and tables of contents through /api/ganjoor/cat/{id}

Bookmark specific poems or individual couplets per authenticated user via /api/ganjoor/bookmark

GET STARTED

Start building with RMuseum API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for RMuseum API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for RMuseum API, keeping it validated and agent-ready. The RMuseum API powers Ganjoor.net, the largest open archive of classical Persian poetry, and exposes 470+ endpoints for browsing poets, books, categories, individual poems and couplets, audio recitations, artifact images, comments, bookmarks, and AI-generated summaries. The same backend supports museum-style cultural artifact metadata (the 'RMuseum' name) alongside the poetry archive. Auth uses a bearer token in the Authorization header for write and user-scoped operations; many read endpoints are public.

Use Cases

Patterns agents use RMuseum API API for, with concrete tasks.

★ Daily Persian Poem Channel

Send a daily Persian poem with translation context to users via email, RSS, or a chat bot. The agent calls /api/ganjoor/poem/random, formats the couplets, and posts to the destination. Avoids hand-curating a daily classical-poetry digest.

Call GET /api/ganjoor/poem/random, take the title and first 4 couplets, and post them to the configured channel each morning

Poet Anthology Browser

Build a reading app or research tool that lets users navigate a poet's full corpus by book and category. The agent uses /api/ganjoor/cat/{id} to walk the table of contents and /api/ganjoor/poem/{id} to load each poem. Supports literature classrooms and Persian-language learning apps.

GET /api/ganjoor/cat/{id} to list a poet's books, then for each child id call GET /api/ganjoor/poem/{id} and assemble a paginated reader view

Crowdsourced Correction Workflow

Let community editors propose fixes to misprinted couplets and have moderators review them. The agent submits to /api/ganjoor/poem/correction on behalf of a signed-in user and pulls /api/ganjoor/poem/correction/next for moderators. Keeps the canonical archive accurate while distributing review work.

POST /api/ganjoor/poem/correction with the poem id and corrected couplet text, then have a moderator agent fetch GET /api/ganjoor/poem/correction/next and call moderate on it

Agent-Led Research Assistant Through Jentic

Connect an AI agent to the Ganjoor archive so it can answer cultural-literature queries with citations to specific poems and couplets. The agent discovers the API via Jentic, loads the relevant operation, and returns the source poem id and couplet index in its answer. Brings classical Persian poetry into general-purpose research agents that previously could only quote from training data.

Use Jentic search query 'retrieve a Persian poem' to load the ganjoor_get_poem tool, execute with the poem id, and return the title, poet, and couplets

Key Endpoints

471 endpoints — jentic publishes the only available openapi specification for rmuseum api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/api/ganjoor/poem/{id}

Retrieve a specific poem with its couplets

GET

/api/ganjoor/poem/random

Return a random poem from the archive

GET

/api/ganjoor/cat/{id}

Retrieve a category or poet table of contents

GET

/api/ganjoor/poets

List poets in the archive

POST

/api/ganjoor/poem/correction

Submit a correction for a poem

POST

/api/users/login

GET

/api/ganjoor/poem/{id}

Retrieve a specific poem with its couplets

GET

/api/ganjoor/poem/random

Return a random poem from the archive

GET

/api/ganjoor/cat/{id}

Retrieve a category or poet table of contents

GET

/api/ganjoor/poets

List poets in the archive

POST

/api/ganjoor/poem/correction

Submit a correction for a poem

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

RMuseum bearer tokens are stored encrypted in the Jentic vault. Agents call operations with a scoped execution token; the raw bearer never appears in the agent context.

Intent-based discovery

Agents search by intent (e.g. 'retrieve a Persian poem') and Jentic returns the matching RMuseum operation with its input schema, so the agent can call the right endpoint among 470+ without reading the full path list.

Time to first call

Direct Ganjoor integration: 3-5 days to map the 471 endpoints, wire bearer auth, and pick the right routes per use case. Through Jentic: under 1 hour — search, load schema, execute the right operation.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Poemist API

Poemist offers a smaller English-language poetry feed; Ganjoor is a deep archive of classical Persian poetry with poet, book, and couplet structure.

Choose Poemist for English-language daily poems; choose Ganjoor when the use case specifically needs Persian classical literature.

Complementary

OpenAI API

Use OpenAI to translate or analyse the Persian text returned by Ganjoor before presenting it.

Pair OpenAI with Ganjoor when the consumer is an English-language audience that needs translation, transliteration, or commentary.

Complementary

Slack API

Distribute a daily Ganjoor poem to a Slack channel for cultural or learning communities.

Use Slack alongside Ganjoor when the audience already collaborates in Slack and you want a daily poem broadcast.

FAQs

Specific to using RMuseum API API through Jentic.

Why is there no official OpenAPI spec for RMuseum API?

Ganjoor.net does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call RMuseum API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the RMuseum API use?

User-scoped endpoints require a bearer token in the Authorization header in the format 'bearer {token}', obtained via POST /api/users/login. Many read endpoints (random poem, public categories) work without auth. Through Jentic the token is stored encrypted in the vault.

Can I retrieve a random Persian poem with the RMuseum API?

Yes. GET /api/ganjoor/poem/random returns a randomly selected poem from the entire Ganjoor archive, including its title, poet reference, and full set of couplets, with no query parameters required.

How do I submit a correction for a misprinted poem?

Authenticate first, then POST /api/ganjoor/poem/correction with the poem id and the proposed couplet text. Submissions enter a moderation queue accessible at /api/ganjoor/poem/correction/next for editors with the moderator role.

What are the rate limits for the RMuseum API?

The OpenAPI does not declare formal rate-limit headers. Treat HTTP 429 as a back-off signal and avoid tight loops over the 471 endpoints, especially the correction queue and bookmark mutation routes.

How do I read Persian poems through Jentic?

Install with pip install jentic, search 'retrieve a Persian poem', load the schema for the ganjoor_get_poem operation, and execute with a poem id. Jentic handles bearer-token injection if your call hits an authenticated route.