Endpoint

GET /api/v1/quotes/random

Parameters

Parameter	Type	Default	Description
language	string	-	Language filter (ko, en)
count	number	1	Number of quotes to return (1~10)

Example: Single Quote

curl -H "Authorization: Bearer im_live_xxxx..." \
  "https://inspireme.advenoh.pe.kr/api/v1/quotes/random?language=ko"

Response

{
  "data": {
    "id": "q-abc123",
    "content": "Know thyself",
    "author": "Socrates",
    "language": "en",
    "tags": ["philosophy", "wisdom"]
  }
}

Example: Multiple Quotes

curl -H "Authorization: Bearer im_live_xxxx..." \
  "https://inspireme.advenoh.pe.kr/api/v1/quotes/random?language=en&count=3"

Response

{
  "data": [
    {
      "id": "q-abc123",
      "content": "Know thyself",
      "author": "Socrates",
      "language": "en",
      "tags": ["philosophy"]
    }
  ]
}

Parameter Details

• language — When not specified, quotes are randomly selected from all languages (ko, en). If the requested language translation is not available, the quote is returned in its original language (language fallback).
• count — Only values from 1 to 10 are valid. Values exceeding 10 are automatically capped at 10. Multiple quotes are returned without duplicates.

Response Field Descriptions

Field	Type	Description
id	string	Unique quote ID (UUID)
content	string	Quote text in the requested language
author	string	Author name
language	string	Original language of the quote (ko or en)
tags	string[]	Tag list (e.g., ["philosophy", "wisdom"])