Hole of Glory API
Access the sacred scriptures of C.U.N.T. programmatically. The Hole of Glory API provides verse lookup, making it easy to embed scripture in your applications or create verse cards for social sharing.
Quickstart
Fetch a verse with a simple REST request.
Fetch a Verse
# Get verse by book:chapter:verse (10:3:7 = Book 10, Chapter 3, Verse 7)
curl "https://api.vagibond.com/holeofglory/verse?ref=10_3_7"
Response
{
"book": "THE FURGE OF THE ELMOS",
"bookId": "furge-of-the-elmos",
"bookNumber": 10,
"chapter": 3,
"verse": 7,
"ref": "3:7",
"fullRef": "10_3_7",
"text": "The authentic stench of the wanderer cannot be faked...",
"url": "https://cunt.vagibond.com/holeofglory/?book=furge-of-the-elmos&verse=3:7"
}
Get Verse Endpoint
Fetch a specific verse from the sacred scriptures.
/api/holeofglory/verse
Query Parameters
| Parameter | Type | Description |
|---|---|---|
ref |
string | Required. Verse reference. Supports two formats:
10_3_7 or 10:3:7).
|
book |
string | Optional. Filter by book ID (e.g., furge-of-the-elmos). |
Response Fields
| Field | Type | Description |
|---|---|---|
book | string | Full book name |
bookId | string | Book slug identifier |
bookNumber | number | Book number (1-10) |
chapter | number | Chapter number |
verse | number | Verse number |
ref | string | Chapter:verse reference (e.g., "3:7") |
fullRef | string | Full reference with underscores (e.g., "10_3_7") |
text | string | The verse text |
url | string | Direct URL to view verse in Hole of Glory |
Reference Format
The Hole of Glory uses a hierarchical reference system:
Format: BOOK_CHAPTER_VERSE Examples: 10_3_7 → Book 10 (The Furge of the Elmos), Chapter 3, Verse 7 1_1_1 → Book 1 (Cuntemplations), Chapter 1, Verse 1 5_2_3 → Book 5 (The Morning Golden Blessing), Chapter 2, Verse 3
The 10 Sacred Books
| # | Book Name | Book ID |
|---|---|---|
| 1 | Cuntemplations | cuntemplations |
| 2 | The Book of Bindle | book-of-bindle |
| 3 | Epistles to the Indigent | epistles-to-the-indigent |
| 4 | The Sacred Spit | sacred-spit |
| 5 | The Morning Golden Blessing | morning-golden-blessing |
| 6 | Trampsalms | trampsalms |
| 7 | The Hobo Proverbs | hobo-proverbs |
| 8 | The Acts of the Apostates | acts-of-the-apostates |
| 9 | The Revelation of Dusty | revelation-of-dusty |
| 10 | The Furge of the Elmos | furge-of-the-elmos |
Gutter Embeds
When you post to Gutter with a #HoleOfGlory hashtag, verse cards are automatically embedded.
Hashtag Format
#HoleOfGlory10_3_7
Format: #HoleOfGlory{BOOK}_{CHAPTER}_{VERSE}
Examples:
#HoleOfGlory10_3_7 → The Furge of the Elmos 3:7
#HoleOfGlory1_1_1 → Cuntemplations 1:1
#HoleOfGlory6_2_5 → Trampsalms 2:5
When a grunt contains this hashtag, Gutter automatically:
- Fetches the verse from the API
- Renders a styled verse card below the grunt
- Links to the full verse in Hole of Glory
Examples
JavaScript
// Fetch a verse const response = await fetch('https://api.vagibond.com/holeofglory/verse?ref=10_3_7'); const verse = await response.json(); console.log(`"${verse.text}"`); console.log(`— ${verse.book} ${verse.ref}`); // Output: // "The authentic stench of the wanderer cannot be faked..." // — THE FURGE OF THE ELMOS 3:7
Python
import requests # Fetch verse of the day response = requests.get('https://api.vagibond.com/holeofglory/verse', params={ 'ref': '10_3_7' }) verse = response.json() print(f'"{verse["text"]}"') print(f'— {verse["book"]} {verse["ref"]}')
Display a Random Verse
// Popular verse references to randomly select from const POPULAR_VERSES = [ '1_1_1', '1_2_3', '2_1_1', '3_1_1', '6_1_1', '7_1_1', '10_3_7', '10_3_14' ]; async function getRandomVerse() { const ref = POPULAR_VERSES[Math.floor(Math.random() * POPULAR_VERSES.length)]; const response = await fetch(`https://api.vagibond.com/holeofglory/verse?ref=${ref}`); return response.json(); }
Changelog
- Initial release
- Get verse endpoint with 3-part reference format
- CORS support for cross-origin requests
- Gutter hashtag embed integration