```
```javascript theme={null}
// Format for Twitter (280 char limit)
function formatForTwitter(quote) {
const maxLength = 240; // Leave room for reference
let text = quote.text;
if (text.length > maxLength) {
text = text.substring(0, maxLength - 3) + '...';
}
return `${text}\n\nā ${quote.reference}\n${quote.url}`;
}
```
```
š Daily Urantia Quote
"${quote.text}"
ā Paper ${quote.reference}
${quote.paperTitle}
Read more: ${quote.url}
```
## Schedule It to Run Daily
Create `.github/workflows/daily-quote.yml`:
```yaml theme={null}
name: Daily Quote Bot
on:
schedule:
- cron: '0 12 * * *' # Daily at noon UTC
workflow_dispatch: # Manual trigger
jobs:
post-quote:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- run: node fetch-quote.js
env:
DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
```
Add your webhook URL to repository secrets.
Deploy as a scheduled Worker:
```javascript theme={null}
export default {
async scheduled(event, env, ctx) {
const quote = await getDailyQuote();
await postToDiscord(env.DISCORD_WEBHOOK, quote);
}
};
async function getDailyQuote() {
const response = await fetch('https://api.urantia.dev/paragraphs/random');
return response.json();
}
async function postToDiscord(webhookUrl, data) {
const message = {
embeds: [{
title: "Daily Urantia Quote",
description: `"${data.text}"`,
fields: [
{ name: "Reference", value: data.standardReferenceId, inline: true },
{ name: "Paper", value: data.paperTitle, inline: true }
]
}]
};
await fetch(webhookUrl, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(message)
});
}
```
Add trigger in `wrangler.toml`:
```toml theme={null}
[triggers]
crons = ["0 12 * * *"]
```
```bash theme={null}
# Edit crontab
crontab -e
# Add this line (runs daily at noon)
0 12 * * * cd /path/to/quote-bot && node fetch-quote.js
```
## Enhance Your Bot
### 1. Filter by Topic
Search for quotes about specific topics instead of random:
```javascript theme={null}
async function getTopicQuote(topic) {
const response = await fetch('https://api.urantia.dev/search', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ q: topic, type: 'and', limit: 10 })
});
const data = await response.json();
// Pick a random result from the top 10
const randomIndex = Math.floor(Math.random() * data.results.length);
return data.results[randomIndex];
}
// Usage
const quote = await getTopicQuote('love');
```
### 2. Add Audio
Every paragraph has audio narration:
```javascript theme={null}
async function getQuoteWithAudio(ref) {
const response = await fetch(`https://api.urantia.dev/paragraphs/${ref}`);
const data = await response.json();
// Get audio URL (tts-1-hd/nova covers every paragraph)
const audioUrl = data.audio?.['tts-1-hd']?.nova?.url;
return { ...data, audioUrl };
}
```
### 3. Track Quote History
Store sent quotes to avoid duplicates:
```javascript theme={null}
const sentQuotes = new Set();
async function getUniqueQuote() {
let attempts = 0;
let quote;
do {
const response = await fetch('https://api.urantia.dev/paragraphs/random');
quote = await response.json();
attempts++;
} while (sentQuotes.has(quote.standardReferenceId) && attempts < 10);
sentQuotes.add(quote.standardReferenceId);
return quote;
}
```
### 4. Theme Days
Rotate topics by day of week:
```javascript theme={null}
const themes = {
0: 'love', // Sunday
1: 'faith', // Monday
2: 'service', // Tuesday
3: 'truth', // Wednesday
4: 'wisdom', // Thursday
5: 'prayer', // Friday
6: 'worship' // Saturday
};
async function getThemedQuote() {
const dayOfWeek = new Date().getDay();
const topic = themes[dayOfWeek];
return getTopicQuote(topic);
}
```
## Next Steps
More ideas for what you can build with the API
Full documentation for the search endpoint
Try the API features live
Next-level tutorial: RAG-powered Urantia chatbot
## Troubleshooting
**Rate limits:** The API allows 100 requests/minute per IP. For a daily bot, this is more than enough. If you hit limits, add retry logic with exponential backoff.
**Quote is too long:** Some paragraphs are lengthy. Truncate with `text.substring(0, 300) + '...'` or filter by character count before posting.
**Want specific topics?** Use the [curated quote collections](/quotes/love) as inspiration ā each has 20 hand-picked quotes organized by theme.
## Source Code
Full working example with tests and multiple platforms:
* [GitHub repository](https://github.com/urantia-hub/urantia-dev-demo) ā See the quote bot implementation in the demo app
* Live demo at [demo.urantia.dev](https://demo.urantia.dev)
***
**Questions?** The API is fully documented at [urantia.dev](/) and the source code is MIT-licensed at [github.com/urantia-hub](https://github.com/urantia-hub).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.