Need a warm line for your app, chatbot, or personal homepage? Whether it is a morning greeting, a late-night note, or a fixed daily quote for check-ins, this single endpoint covers the main saying use cases.

Overview

This is the unified corpus saying endpoint. Use the mode parameter to switch between multiple copywriting scenarios, and optionally filter by source, category, or tag.

Four modes (mode)

- Random (random or omitted): returns a fresh random saying from the selected pool.

- Daily (daily): returns the same saying for the same day within the selected pool. Useful for daily check-ins, morning pushes, or sign-in backgrounds.

- Scene recommendation (recommend): use scene to get a saying for a specific scene, such as morning or night.

- Moment (moment): automatically detects the server-side time segment and recommends a saying that fits the current moment.

Notes

[!NOTE]

- Filters: source, category, and tag accept multiple values separated by commas , or semicolons ;.

- Scene binding: scene is required only when mode=recommend; it is ignored by other modes.

- Recommended requests:

- Random: GET /api/v1/saying/random

- Daily: GET /api/v1/saying/random?mode=daily

- Scene: GET /api/v1/saying/random?mode=recommend&scene=night

- Moment: GET /api/v1/saying/random?mode=moment