150,000 quotes.
5-dimensional filtering.

Quick Start

Get your first quote in under 60 seconds.

Step 1 — Request a trial key

Fill out the form below. You'll receive a key by email within a few hours. 1,000 free calls, 30 days, no credit card.

Step 2 — Make your first request

Copy# Swap in your key
curl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-random"

Step 3 — See the response

{
  "id":                 "q_3949ef4a",
  "text":               "It does not matter how slowly you go as long as you do not stop.",
  "author":             "Confucius",
  "category":           "Motivation & Success",
  "secondary_category": "Wisdom & Philosophy",
  "mood":               "inspirational,uplifting",
  "era":                "Ancient",
  "length":             "Short",
  "faith_tradition":    "Confucian"
}

Authentication

Pass your API key on every request using either method:

Option A — Header (recommended)

X-API-Key: YOUR_KEY

Option B — Bearer token

Authorization: Bearer YOUR_KEY

GET /quotes-random

Returns one random quote. All parameters are optional — a bare call returns any quality quote from the full database.

Parameters

Example — random short grief quote

Copycurl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-random?category=grief&length=short"

Example — random Christian quote

Copycurl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-random?faith=christian&mood=inspirational"

GET /quotes-filter

Returns multiple quotes matching your filters, sorted by curation score. Supports pagination. Number of simultaneous filters and results per call are gated by plan.

Parameters

Example — 10 short recovery quotes

Copycurl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-filter?category=recovery&length=short&limit=10"

Response

{
  "quotes": [
    {
      "id":     "q_3e7ce7e8",
      "text":   "If you look for perfection, you'll never be content.",
      "author": "Leo Tolstoy",
      "category": "Mental Health & Recovery",
      "mood":   "reflective,uplifting",
      "era":    "Modern",
      "length": "Short"
    }
    // ... more quotes
  ],
  "total":    2847,
  "limit":    10,
  "offset":   0,
  "has_more": true
}

Pagination example

Copy# Page 1
curl -H "X-API-Key: YOUR_KEY" "...?category=grief&limit=25&offset=0"
# Page 2
curl -H "X-API-Key: YOUR_KEY" "...?category=grief&limit=25&offset=25"

GET /quotes-categories

Returns all available filter values — categories with quote counts, plus the full list of moods, lengths, and eras. Use this endpoint to build filter UIs or discover what's available.

No parameters. Example:

Copycurl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-categories"

Response (abbreviated)

{
  "categories": [
    { "name": "Wisdom & Philosophy", "count": 29243 },
    { "name": "Life & Human Nature",  "count": 17645 },
    { "name": "Grief & Loss",          "count": 932   }
    // ... 40 more
  ],
  "total_categories": 43,
  "moods":   ["challenging", "dark", "humorous", "inspirational", "poignant", "reflective", "serious", "uplifting"],
  "lengths": ["Short", "Medium", "Long"],
  "eras":    ["Ancient", "Medieval", "Early Modern", "Modern", "Contemporary", "Present"]
}

GET /quotes-usage

Check your call count and remaining budget for the current month. Resets on the 1st of each month.

Copycurl -H "X-API-Key: YOUR_KEY" \
  "https://ptzxcvrqqmztehcducxq.supabase.co/functions/v1/quotes-usage"

{
  "client":           "Sober Time",
  "tier":             "professional",
  "calls_this_month": 4821,
  "call_limit":       50000,
  "calls_remaining":  45179,
  "usage_pct":        10,
  "resets":           "1st of each month"
}

Filter Reference

Categories (43 total)

Faith Traditions

Moods

Lengths

Short = under 100 chars  ·  Medium = 100–200 chars  ·  Long = 200+ chars

Eras

Use Case Examples

GET /quotes-filter?category=mental+health&mood=inspirational&length=short&limit=7

GET /quotes-random?faith=christian&mood=reflective

GET /quotes-filter?category=grief&mood=uplifting&length=short&faith=christian

GET /quotes-filter?faith=jewish&mood=reflective&limit=7

Pricing

Start free. Upgrade when your app grows. No contracts.

Need a white-label or dedicated endpoint? Contact us for Enterprise pricing.

Get a Free Trial Key

1,000 calls, 30 days, no credit card. You'll receive a key by email within a few hours.

Integration typically takes 20–30 minutes. The Quick Start above walks through the first API call step by step.

Terms of Use

By using the Quotable Wisdom API you agree to the following terms. These exist to protect the integrity of the data and ensure fair use for all clients.

License

Quotable Wisdom grants you a limited, non-exclusive, non-transferable license to access the API and display quotes within your application. This license does not transfer ownership of any data, tags, categorizations, or metadata.

Permitted Use

You may use API responses to display quotes within your application, product, or service — including commercial products. Attribution to Quotable Wisdom is appreciated but not required on paid plans.

Prohibited Use

The following are expressly prohibited:

What You Own

Individual quote texts by historical figures are generally in the public domain. The Quotable Wisdom database — including its selection, curation, grading system, mood tags, faith tradition classifications, era assignments, and all other metadata — is original creative and intellectual work protected under U.S. copyright law as a compiled work.

Rate Limits & Fair Use

Call limits are enforced per API key per calendar month. Attempts to circumvent limits through multiple trial accounts or automated key rotation are a violation of these terms and will result in immediate revocation of all associated keys.

Termination

We reserve the right to revoke any API key at any time for violation of these terms. Paid clients will receive a prorated refund for any unused portion of the current billing period.

Changes to Terms

We may update these terms with reasonable notice by email to the address on your account. Continued use of the API after notice constitutes acceptance.

Questions about these terms: quotable2026@gmail.com  ·  Jireh Holdings LLC  ·  North Platte, Nebraska