API Documentation
Access Advent Hymnals data programmatically for your applications
Getting Started
The Advent Hymnals API provides RESTful access to our complete database of hymnal collections, individual hymns, and associated metadata.
Base URL
https://adventhymnals.com/api🚧 API Under Development
Our public API is currently under development. Documentation and endpoints will be available soon for developers who want to integrate hymnal data into their applications.
Planned Endpoints
/api/hymnalsGet all hymnal collections
Returns: Array of hymnal metadata objects
/api/hymnals/{id}Get specific hymnal collection
Returns: Hymnal object with metadata and hymn list
/api/hymns/{id}Get specific hymn data
Returns: Complete hymn object with verses, metadata, and musical information
/api/searchSearch hymns across collections
Returns: Array of matching hymns with relevance scores
Use Cases
Worship Planning Apps
Integrate hymnal data into church management software for service planning and hymn selection.
Academic Research
Access structured data for musicological research and historical analysis of hymn collections.
Mobile Applications
Build mobile apps with offline hymnal access and synchronization capabilities.
Educational Tools
Create learning platforms for music education and hymn study resources.
API Access
API access will be free for educational and non-commercial use.
Commercial usage will require API keys and may have rate limiting.
Interested in early access? Contact us at developer@adventhymnals.com