TL;DR
What it does: Returns a random positive affirmation as JSON. Use it in morning routine apps, meditation timers, notification systems, or anywhere you need a quick dose of positivity.
Quick start: https://www.affirmations.dev/
No API key needed - just call the URL
Overview
Affirmations.dev is a dead-simple free API that returns a random uplifting affirmation as JSON. No authentication, no rate limits, no configuration - just call the URL and get a positive message back. Built by Ann Thurium, it's perfect for developers who want to add a splash of positivity to their apps without any setup hassle.
Live Example
Here's the exact URL to call and the real response you'll get:
The actual response you get:
{
"affirmation": "Your mind is full of brilliant ideas"
}
What does this data mean?
You get back: "Your mind is full of brilliant ideas" — a random positive affirmation to brighten your day.
- affirmation
- A random positive affirmation string. This is the only field in the response. Every call returns a different message from a curated collection of uplifting statements.
How to use this API
JavaScript Example
// Fetch a random affirmation
fetch('https://www.affirmations.dev/')
.then(res => res.json())
.then(data => {
console.log(data.affirmation);
// Example: "Your mind is full of brilliant ideas"
})
.catch(err => console.error('Error:', err));
Python Example
import requests
response = requests.get('https://www.affirmations.dev/')
data = response.json()
print(data['affirmation'])
# Example: "Your mind is full of brilliant ideas"
Frequently Asked Questions
- Do I need an API key?
- No! Affirmations.dev is completely free with no authentication required. Just call the URL and get an affirmation back.
- Is there a rate limit?
- No, there is no rate limit. You can call the API as often as you like with no restrictions.
- Can I get a specific affirmation?
- No, the endpoint always returns a random affirmation from the collection. There is no way to request a specific message.
- Can I use this commercially?
- Yes! This API is free for both personal and commercial use. Check the GitHub repository for any specific licensing details.
- How do I build a morning routine app with this?
- Call the API on app launch to display a daily affirmation. You can cache it in localStorage to show the same one all day, or call it fresh each time for variety. Combine with notification APIs to send affirmations as push alerts.
- What if the API is down?
- Since there's no rate limit, you can simply retry after a short delay. Consider fetching and caching several affirmations ahead of time as a fallback.
API Details
- Base URL
https://www.affirmations.dev/- Documentation
- https://github.com/annthurium/affirmations
- Category
- Entertainment
- Authentication
- None required - completely free
- Rate Limit
- None
- Geographic Coverage
- Global