Famous Quotes API
About 20,000 famous quotes from nearly 8,000 authors across 117 topics. Get a random quote, browse by author or topic, or search the text.
Quick start
curl "https://quotes.quiply.net/v1/random?tag=courage" \
-H "X-API-Key: YOUR_KEY"
Authentication
Every request must include your key in the X-API-Key header. You get your key instantly on the pricing section. Keep it secret — don't put it in public front-end code.
Base URL: https://quotes.quiply.net
GET/v1/random
One or more random quotes, optionally filtered.
| Parameter | Type | Description |
|---|---|---|
author | string | Author name (partial match), e.g. twain |
tag | string | Topic, e.g. love, courage (see /v1/tags) |
count | integer | 1–20 (default 1) |
{ "count": 1, "quotes": [ { "id": 3, "quote": "…", "author": "Mark Twain", "tag": "humor" } ] }
GET/v1/quotes
Browse quotes by author and/or tag.
| Parameter | Type | Description |
|---|---|---|
author | string | Author name (partial match), e.g. twain |
tag | string | Topic, e.g. love, courage (see /v1/tags) |
limit | integer | 1–100 (default 25) |
offset | integer | Skip this many results |
GET/v1/search
Search quote text and author names (q required, minimum 2 characters).
| Parameter | Type | Description |
|---|---|---|
limit | integer | 1–100 (default 25) |
offset | integer | Skip this many results |
GET/v1/authors
Authors with their number of quotes (optional search, limit 1–500, offset).
GET/v1/tags
All topics with their number of quotes.
GET/v1/health
Service status and dataset size. No key needed.
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid X-API-Key |
| 403 | Subscription inactive (cancelled or payment failed) |
| 404 | No quotes match |
| 422 | Bad or missing parameter |
| 429 | Quota reached for your plan |
Pricing
Free trial: 5 requests/day. All APIs plan: $9.95/month gives you every Quiply API, 250,000 requests a month.
Get your API key