Quotable is a free, open source quotations API. It was originally built as part of a FreeCodeCamp project. The database includes over 2000 quotes by 900 authors.
| Name | URL | Description |
|---|---|---|
| Staging | staging.quotable.io | Synced with the master branch of this repository |
| Production | api.quotable.io | The primary API server |
Returns a single random quote from the database
GET /random| param | type | Description |
|---|---|---|
| maxLength | Int |
The maximum Length in characters ( can be combined with minLength ) |
| minLength | Int |
The minimum Length in characters ( can be combined with maxLength ) |
| tags | String |
Filter random quote by tag(s). Takes a list of one or more tag names, separated by a comma (meaning AND) or a pipe (meaning OR). A comma separated list will match quotes that have all of the given tags. While a pipe (|) separated list will match quotes that have either of the provided tags. |
| author | String |
Get random quote by a specific author(s). The value can be an author name or slug. To include quotes by multiple authors, provide a pipe-separated list of author names/slugs. |
| authorId | String |
deprecated Same as author param, except it uses author _id instead of slug |
{
_id: string
// The quotation text
content: string
// The full name of the author
author: string
// The `slug` of the quote author
authorSlug: string
// The length of quote (number of characters)
length: number
// An array of tag names for this quote
tags: string[]
}Random Quote try in browser
GET /randomRandom Quote with tags "technology" AND "famous-quotes" try in browser
GET /random?tags=technology,famous-quotesRandom Quote with tags "History" OR "Civil Rights" try in browser
GET /random?tags=history|civil-rightsRandom Quote with a maximum length of 50 characters try in browser
GET /random?maxLength=50Random Quote with a length between 100 and 140 characters try in browser
GET /random?minLength=100&maxLength=140Get a paginated list of all quotes. This method supports several filter and sorting options.
GET /quotes| param | type | Description |
|---|---|---|
| limit | Int |
Min: 1 Max: 100 Default: 20 The number of quotes to return per request. (for pagination). |
| skip | Int |
Min: 0 Default: 0 The number of items to skip (for pagination). |
| page | Int |
Min: 0 Default: 0 The page of results to return. |
| maxLength | Int |
The maximum Length in characters ( can be combined with minLength ) |
| minLength | Int |
The minimum Length in characters ( can be combined with maxLength ) |
| tags | String |
Filter quotes by tag(s). Takes a list of one or more tag names, separated by a comma (meaning AND) or a pipe (meaning OR). A comma separated list will match quotes that have all of the given tags. While a pipe (|) separated list will match quotes that have either of the provided tags. |
| author | String |
Get quotes by a specific author. The value can be an author name or slug. To get quotes by multiple authors, provide a pipe separated list of author names/slugs. |
| authorId | String |
deprecated Same as author param, except it uses author _id instead of slug |
{
// The number of quotes returned by this request
count: number
// The total number of quotes matching this request
totalCount: number
// The total number of pages matching this request with the specified limit per page
totalPages: number
// The current page number
page: number
// The index of the last quote returned. When paginating through results,
// this value would be used as the `skip` parameter when requesting the next
// "page" of results.
lastItemIndex: number
// The array of quotes
results: Array<{
_id: string
// The quotation text
content: string
// The full name of the author
author: string
// The `slug` of the quote author
authorSlug: string
// The length of quote (number of characters)
length: number
// An array of tag names for this quote
tags: string[]
}>
}Get a quote by its ID
GET /quotes/:id{
_id: string
// The quotation text
content: string
// The full name of the author
author: string
// The length of quote (number of characters)
length: number
// An array of tag names for this quote
tags: string[]
}Get a paginated list of all authors. By default, authors will be returned in alphabetical order (ascending).
GET /authors| param | type | Description |
|---|---|---|
| sortBy | enum: ['name', 'quoteCount'] |
Default: "name" The field used to sort authors. |
| sortOrder | enum: ['asc', 'desc'] |
Default: "asc" The order results are sorted in. |
| limit | Int |
Min: 1 Max: 100 Default: 20 The number of authors to return per request. (for pagination) |
| skip | Int |
Min: 0 Default: 0 The number of items to skip (for pagination) |
| page | Int |
Min: 0 Default: 0 The page of results to return. |
{
// The number of authors return by this request.
count: number
// The total number of authors matching this request.
totalCount: number
// The total number of pages matching this request with the specified limit per page
totalPages: number
// The current page number
page: number
// The index of the last item returned. When paginating through results,
// this value would be used as the `skip` parameter when requesting the next
// "page" of results. It will be set to `null` if there are no additional results.
lastItemIndex: number | null
// The array of authors
results: Array<{
// A unique id for this author
_id: string
// A brief, one paragraph bio of the author. Source: wiki API
bio: string
// A one-line description of the author. Typically it is the person's primary
// occupation or what they are know for.
description: string
// The link to the author's wikipedia page or official website
link: string
// The authors full name
name: string
// A slug is a URL-friendly ID derived from the authors name. It can be used as
slug: string
// The number of quotes by this author
quoteCount: string
}>
}Get details about a specific author by _id.
GET /authors/:id{
// A unique id for this author
_id: string
// A brief, one paragraph bio of the author. Source wiki API.
bio: string
// A one-line description of the author.
description: string
// The link to the author's wikipedia page or official website
link: string
// The authors full name
name: string
// A slug is a URL-friendly ID derived from the authors name. It can be used as
slug: string
// The number of quotes by this author
quoteCount: string
// The array of quotes by this author (not paginated)
// @deprecated
quotes: Array<{
_id: string
// The quotation text
content: string
// The full name of the author
author: string
// The `slug` of the quote author
authorSlug: string
// An array of tag names for this quote
tags: string[]
// The length of quote (number of characters)
length: number
}>
}GET /tagsGet a list of all tags
| param | type | Description |
|---|---|---|
| sortBy | enum: ['name', 'quoteCount'] |
Default: "name" The field used to sort tags. |
| sortOrder | enum: ['asc', 'desc'] |
Default: depends on sortBy The order in which results are sorted. |
{
// The number of all tags by this request
count: number
// The array of tags
results: Array<{
_id: string
name: string
}>
}Get a random quote (fetch)
fetch('https://api.quotable.io/random')
.then(response => response.json())
.then(data => {
console.log(`${data.content} —${data.author}`)
})Get a random quote (async/await)
async function randomQuote() {
const response = await fetch('https://api.quotable.io/random')
const data = await response.json()
console.log(`${data.content} —${data.author}`)
}
randomQuote()Get a random quote (JQuery)
$.getJSON('https://api.quotable.io/random', function (data) {
console.log(`${data.content} —${data.author}`)
})React Random Quote (CodeSandbox)
All contributions are welcome! For more info on how to contribute, check out the Contributors Guide