Get Poem Recitations
ganjoor_get_poem_recitationsRetrieve all audio recitations for a specific poem using its numeric ID, with pagination and Markdown or JSON output.
Instructions
List every audio recitation published for one poem.
Args:
poem_id (number): Numeric poem id
page (number): Page number, starting from 1 (default: 1)
page_size (number): Items per page, 1-100 (default: 20)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON: { poem_id, count, page, page_size, has_more, next_page, recitations: [{ id, artist, title, publish_date, duration_seconds }] }
Examples:
"How has poem 2623 been recited?" -> poem_id=2623
Notes:
Text fields are intentionally blank upstream; fetch the poem itself for its text.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"poem_id": "<poem_id>"
},
"name": "ganjoor_get_poem_recitations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting from 1. | |
| poem_id | Yes | Numeric poem id. | |
| page_size | No | Maximum items to return per page (1-100, default 20). | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |