API Documentation

Access quotes programmatically with our simple REST API. All requests require an API key.

If this API helps you build something, consider supporting the project — it helps keep the API free and running.

Base URL

https://www.quoterism.com

API Key

Limits: 30 req / min · 150 req / day

Keys that exceed the daily limit 100 times within a 24-hour window are automatically suspended for 7 days. Implement exponential back-off and respect Retry-After response headers to avoid suspension.

GET

/api/quotes/[id]

Retrieve a quote using a special identifier. Use "random" for a randomly selected quote, "quote-of-the-day" (or the short alias "qotd") for today's daily quote.

Parameters

Name	Type	Required	Description
`id`	string	Required	"random" — a randomly selected quote. "quote-of-the-day" or "qotd" — today's daily quote.

Responses

{
  "id": "abc123",
  "text": "The only way to do great work is to love what you do.",
  "author": {
    "id": "xyz789",
    "name": "Steve Jobs",
    "slug": "steve-jobs",
    "imageUrl": "https://images.quoterism.com/authors/xyz789.jpg"
  }
}

Examples

Get random quote

curl -H "X-API-Key: YOUR_API_KEY" "https://www.quoterism.com/api/quotes/random"

Get quote of the day

curl -H "X-API-Key: YOUR_API_KEY" "https://www.quoterism.com/api/quotes/quote-of-the-day"

Get quote of the day (short)

curl -H "X-API-Key: YOUR_API_KEY" "https://www.quoterism.com/api/quotes/qotd"