Use Cases - What You Can Build with the Urantia Papers API

# Get a random paragraph
curl https://api.urantia.dev/paragraphs/random

// Daily quote in JavaScript
async function getDailyQuote() {
  const res = await fetch('https://api.urantia.dev/paragraphs/random');
  const data = await res.json();
  return {
    text: data.text,
    reference: data.standardReferenceId,
    paper: data.paperTitle
  };
}

import requests

def search_urantia(query, limit=5):
    """Search the Urantia Papers and return relevant passages."""
    response = requests.post(
        "https://api.urantia.dev/search",
        json={"q": query, "type": "and", "limit": limit}
    )
    return response.json()["results"]

def get_context(ref, window=3):
    """Get surrounding context for a passage."""
    response = requests.get(
        f"https://api.urantia.dev/paragraphs/{ref}/context?window={window}"
    )
    return response.json()

# Example: Build context for an LLM prompt
results = search_urantia("What happens after death?")
context_passages = []
for result in results:
    ctx = get_context(result["standardReferenceId"])
    context_passages.append(ctx)

# Get the table of contents for navigation
curl https://api.urantia.dev/toc

# Read a specific paper
curl https://api.urantia.dev/papers/1

# Get a section's paragraphs
curl https://api.urantia.dev/papers/1/sections

# Get audio URLs for a paragraph
curl https://api.urantia.dev/audio/1:0.1

# Full paper with audio included
curl https://api.urantia.dev/papers/1
# (audio field included in each paragraph)

// Build an audio player playlist for a paper
async function getPaperAudio(paperId) {
  const res = await fetch(`https://api.urantia.dev/papers/${paperId}`);
  const data = await res.json();
  return data.paragraphs
    .filter(p => p.audio?.['tts-1-hd']?.nova)
    .map(p => ({
      url: p.audio['tts-1-hd'].nova.url,
      ref: p.standardReferenceId,
      text: p.text.substring(0, 100)
    }));
}

# Search for a specific concept
curl -X POST https://api.urantia.dev/search \
  -H "Content-Type: application/json" \
  -d '{"q": "Thought Adjuster", "type": "and", "limit": 50}'

# Exact phrase search
curl -X POST https://api.urantia.dev/search \
  -H "Content-Type: application/json" \
  -d '{"q": "spirit of truth", "type": "phrase", "limit": 20}'

# Search within a specific paper
curl -X POST https://api.urantia.dev/search \
  -H "Content-Type: application/json" \
  -d '{"q": "love", "paperId": 56, "limit": 20}'

# Download the OpenAPI specification
curl https://api.urantia.dev/openapi.json -o openapi.json

# Generate a TypeScript client (using openapi-generator)
npx @openapitools/openapi-generator-cli generate \
  -i openapi.json -g typescript-fetch -o ./urantia-client