Skip to main content
Get a random quote from the database. You can optionally filter by TV show and/or request only short (one-line) quotes.

​
Endpoint

GET /quotes

​
Query parameters

​
show
string
Filter quotes by TV show name (case insensitive). If not specified, a random quote from any show is returned.
​
short
boolean
default:"false"
If set to true, returns only one-line quotes. Defaults to false.

​
Response

Returns a single quote object.
​
show
string
required
The name of the TV show
​
character
string
required
The character who said the quote
​
text
string
required
The quote text

​
Example requests

​
Get any random quote

curl
curl https://quotes.jepcd.com/quotes

​
Get a random quote from Breaking Bad

curl
curl https://quotes.jepcd.com/quotes?show=breaking%20bad

​
Get a random short quote from The Office

curl
curl https://quotes.jepcd.com/quotes?show=the%20office&short=true

​
Example response

{
  "show": "Breaking Bad",
  "character": "Water White",
  "text": "We tried to poison you. We tried to poison you because you are an insane, degenerate piece of filth and you deserve to die."
}

​
Error responses

If no quotes are found matching your filters, the API returns a 404 status code: 
No quotes found for show {show}

Build docs developers (and LLMs) love

Get started for freeTalk to us