A REST API for famous quotes
I originally built this for a freeCodeCamp project, and decided to publish for others to use as well. The database currently includes over 1500 quotes by 800 authors.
Returns a single random quote from the database
https://api.quotable.io/random{
_id: string,
content: string,
author: string
}Get quotes from the database using various filter and sorting options. All parameters are optional.
| param | type | Description |
|---|---|---|
| author | String |
Filter quotes by author name. Supports fuzzy search. |
| authorId | String |
Filter quotes by author ID |
| limit | Int |
The number of quotes to return per request. (for pagination) |
| skip | Int |
The number of items to skip (for pagination) |
https://api.quotable.io/quotes{
// The number of quotes returned by this request
count: number,
// The total number or quotes matching this request
totalCount: 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: {_id: string, content: string, author: string}[]
}Get a quote by its ID
https://api.quotable.io/quotes/:id{
_id: string,
content: string,
author: string
}Search the database for authors using various filter/sorting options. All parameters are optional. By default, it returns all authors in alphabetical order.
| param | type | Description |
|---|---|---|
| name | String |
Search for authors by name. Supports fuzzy search. |
| sortBy | enum: ['name', 'quoteCount'] |
The field used to sort authors. Default is 'name' |
| sortOrder | enum: ['asc', 'desc'] |
The order results are sorted in. Default is 'asc' |
| limit | Int |
The number of authors to return per request. (for pagination) |
| skip | Int |
The number of items to skip (for pagination) |
https://api.quotable.io/authors{
// The number of authors return by this request.
count: number,
// The total number or authors matching this request.
totalCount: 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.
lastItemIndex: number
// The array of authors
results: {_id: string, name: string, quoteCount: string}[]
}Get all quotes a specific author
https://api.quotable.io/author/:id{
_id: string,
// The author name
name: number,
// The total number of quotes by this author
quoteCount: number
// The array of quotes by this author
quotes: {_id: string, content: string, author: 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 feedback and contributions are welcome!