Alimentation, Santé & Nature

Nouvelle API Affirmations

Daily affirmations across 19 categories with personalization, thought reframing, breathing bundles, and multi-format responses. Perfect for wellness, fitness, and lifestyle applications.

En-têtes de demande

Name Required Description
X-RapidAPI-Key required Your RapidAPI key. Get one free.
X-RapidAPI-Host required new-affirmations-api.p.rapidapi.com

Points de terminaison

GET /v1/affirmations

Lister les affirmations

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—facultatif
searchstringoptional—facultatif
pagestringoptional—par défaut : 1
limitstringoptional—par défaut : 10
langstringoptional—par défaut : en

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations?category=example&search=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/random

Affirmation aléatoire

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—facultatif
langstringoptional—par défaut : en
formatstringoptional—par défaut : json

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/random?category=example&lang=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/categories/{category}/random

Affirmation aléatoire par catégorie

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—requis

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/categories/{category}/random?category=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/categories

Lister les catégories

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/categories' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/batch

Affirmations par lot

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—facultatif
limitstringoptional—par défaut : 10
langstringoptional—par défaut : en

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/batch?category=example&limit=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/today

L'affirmation du jour

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—facultatif
langstringoptional—par défaut : en

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/today?category=example&lang=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
POST /v1/affirmations/personalize

Personnaliser

Paramètres

NameTypeRequiredDefaultConstraints
moodstringoptional—facultatif
goalstringoptional—facultatif
namestringoptional—facultatif

Exemples de codes

curl --request POST \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/personalize?mood=example&goal=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
POST /v1/affirmations/reframe

Reformuler une pensée négative

Paramètres

NameTypeRequiredDefaultConstraints
negativeThoughtstringoptional—requis

Exemples de codes

curl --request POST \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/reframe?negativeThought=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/bundle

Affirmation + ensemble de respiration

Paramètres

NameTypeRequiredDefaultConstraints
categorystringoptional—facultatif

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/bundle?category=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'
GET /v1/affirmations/schedule

Horaire suggéré

Paramètres

NameTypeRequiredDefaultConstraints
timezonestringoptional—facultatif

Exemples de codes

curl --request GET \
  --url 'https://new-affirmations-api.p.rapidapi.com/v1/affirmations/schedule?timezone=example' \
  --header 'x-rapidapi-key: YOUR_API_KEY' \
  --header 'x-rapidapi-host: new-affirmations-api.p.rapidapi.com'

Exemple interactif

new-affirmations-api
$ GET /v1/affirmations
{
  "id": 1874329517,
  "text": "I am confident, capable, and ready for today.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 42
}

Guide d'intégration et d'utilisation

From infinite loops to instant wellness: the Affirmations API has been rebuilt to deliver personalized, daily positivity with zero friction. Every affirmation now ships with a stable ID, clean trimmed data, and a rich schema — alongside search, pagination, batch and daily endpoints, a full wellness toolkit, and plain-text responses for SMS and voice assistants.

🚀 What’s New

  • Stable IDs – Every affirmation carries a consistent hash-based id, so widgets, notifications, and caches stay in sync.
  • Clean data, automatically – Text and category fields are trimmed of stray whitespace before they reach your app.
  • Smart categories – The 19 categories are derived directly from the dataset and sorted, with no hardcoded drift.
  • Helpful errors – Unknown categories return a clear 404 instead of hanging or looping.
  • Richer schema – Each affirmation returns id, text, category, mood, lang, and length.
  • Find what you need – Search and pagination on the list endpoint, plus a configurable batch endpoint.
  • Deterministic daily picks – /today returns the same affirmation of the day for every user.
  • Wellness toolkit – Personalize by name, reframe negative thoughts, and pair affirmations with breathing exercises.

🛠 API Endpoints

1. List Affirmations

GET /v1/affirmations

Parameters:

  • category (optional): Filter the list by category, such as confidence or self-love.
  • search (optional): Full-text search across affirmation text.
  • page (default: 1): Page number for pagination.
  • limit (default: 10): Results per page, up to a maximum of 50.
  • lang (default: en): Language code. English content is returned in this release.

2. Random Affirmation

GET /v1/affirmations/random

Parameters:

  • category (optional): Return a random affirmation from a specific category.
  • lang (default: en): Language code. English content is returned in this release.
  • format (default: json): Use json for the full object or text for a plain-text response.

3. Random Affirmation by Category

GET /v1/affirmations/categories/{category}/random

Parameters:

  • category (required): The category to pick from, such as sleep. Unknown categories return a clear 404.

4. List Categories

GET /v1/affirmations/categories

Returns the complete, sorted list of categories — from anxiety-relief and calm to confidence, focus, gratitude, parenting, resilience, self-love, sleep, success, and more.

5. Batch Affirmations

GET /v1/affirmations/batch

Parameters:

  • category (optional): Filter the batch by category.
  • limit (default: 10): Number of affirmations to return, up to a maximum of 50.
  • lang (default: en): Language code. English content is returned in this release.

6. Today’s Affirmation

GET /v1/affirmations/today

Parameters:

  • category (optional): Return the deterministic daily pick within a category.
  • lang (default: en): Language code. English content is returned in this release.

The /daily alias returns the same affirmation of the day.

7. Personalize

POST /v1/affirmations/personalize

Body:

  • mood (optional): Mood or category to draw from, such as confidence. Defaults to happiness.
  • goal (optional): The intention behind the affirmation.
  • name (optional): A name to weave into the affirmation, for example “I am confident, Ava.”

8. Reframe a Negative Thought

POST /v1/affirmations/reframe

Body:

  • negativeThought (required): The thought to reframe, for example “I always fail”.

Returns a reframed statement alongside a matching resilience affirmation.

9. Affirmation + Breathing Bundle

GET /v1/affirmations/bundle

Parameters:

  • category (optional): The category to draw from. The sleep category returns the 4-7-8 breathing exercise; all other categories return box breathing.

10. Suggested Schedule

GET /v1/affirmations/schedule

Parameters:

  • timezone (optional): Timezone label for the suggested slots, for example Europe/Berlin. Defaults to UTC.

📦 Response Examples

Random affirmation:

{
  "id": 1874329517,
  "text": "I am confident, capable, and ready for today.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 42
}

Personalized affirmation:

{
  "id": 55123874,
  "text": "I am confident, Ava.",
  "category": "confidence",
  "mood": "confidence",
  "lang": "en",
  "length": 20
}

Reframed thought:

{
  "reframe": "Even though \"I always fail\", I choose to believe: I am learning and growing every day.",
  "affirmation": {
    "id": 912345678,
    "text": "I am learning and growing every day.",
    "category": "resilience",
    "mood": "resilience",
    "lang": "en",
    "length": 36
  }
}

Wellness bundle:

{
  "affirmation": {
    "id": 44556677,
    "text": "I release the day and welcome rest.",
    "category": "sleep",
    "mood": "sleep",
    "lang": "en",
    "length": 36
  },
  "breathing": {
    "name": "4-7-8",
    "steps": ["Inhale 4s", "Hold 7s", "Exhale 8s"]
  }
}

Suggested schedule:

{
  "morning": "08:00 Europe/Berlin",
  "evening": "21:00 Europe/Berlin",
  "timezone": "Europe/Berlin"
}

✨ Multi-Format Responses

The random endpoint speaks both JSON and plain text. Use ?format=json (the default) for the full structured object in web and mobile apps, or ?format=text for a ready-to-send string in SMS flows, voice assistants, and widgets.

🎯 Built For

  • Developers building wellness apps, chatbots, and motivation features who want a stable, well-documented API.
  • Product managers raising engagement with daily notifications, streaks, and deterministic daily content.
  • Wellness app creators who need reliable, categorized affirmation content at scale.
  • Enterprise teams that expect scalable, SDK-style endpoints with Postman-ready onboarding.

🌟 Why Choose the Affirmations API?

  • Reliable by design: Stable IDs, trimmed data, and clear 404s mean fewer surprises in production.
  • Depth when you need it: 19 categories spanning everything from anxiety relief to self-love.
  • More than one call: Personalization, reframing, breathing bundles, and scheduling in a single API.
  • Developer friendly: Search, pagination, batching, multi-format responses, and ready-to-use snippets.
  • Wellness ready: 99.99% uptime with low-latency responses for everyday positive moments.

🚀 Get Started

  • Postman collection: Import docs/affirmations-postman.json to explore every endpoint in one click.
  • Code snippets: Copy ready-to-run examples for cURL, JavaScript, and Python from docs/affirmations-snippets.md.
  • LLM-ready: docs/llms.txt gives AI agents a structured summary of the API.

Start building positive moments today — call the today endpoint for a deterministic daily affirmation, then add personalization and breathing bundles to complete the wellness experience.

Abonnez-vous et licence

Accédez à cette API avec des niveaux prêts à être commercialisés sur RapidAPI. Plans flexibles conçus pour les projets parallèles, les startups et les architectures de production à haut volume.

Voir les tarifs et s'abonner

Assistance aux développeurs

Besoin d'aide pour l'intégration ou avez-vous une demande de point de terminaison personnalisé ? Notre équipe d'ingénieurs est là pour vous aider avec l'authentification, les schémas de charge utile et les augmentations des limites de débit haute fréquence.

Contacter l'ingénierie API

Performances du système

Surveillé 24h/24 et 7j/7 avec un SLA de disponibilité de 99,9 %. Construit sur des microservices cloud natifs avec une mise en cache périphérique distribuée à l’échelle mondiale pour garantir des temps de réponse à latence ultra-faible.

Tous les systèmes opérationnels