Quotes API

The Quotes API provides a nearly endless amount of quotes from famous people throughout history.

/v1/quotes

HTTP GET

Returns one (or more) random quotes.

Parameters

category (optional) - category to limit results to. Possible values are:

  • age
  • alone
  • amazing
  • anger
  • architecture
  • art
  • attitude
  • beauty
  • best
  • birthday
  • business
  • car
  • change
  • communication
  • computers
  • cool
  • courage
  • dad
  • dating
  • death
  • design
  • dreams
  • education
  • environmental
  • equality
  • experience
  • failure
  • faith
  • family
  • famous
  • fear
  • fitness
  • food
  • forgiveness
  • freedom
  • friendship
  • funny
  • future
  • god
  • good
  • government
  • graduation
  • great
  • happiness
  • health
  • history
  • home
  • hope
  • humor
  • imagination
  • inspirational
  • intelligence
  • jealousy
  • knowledge
  • leadership
  • learning
  • legal
  • life
  • love
  • marriage
  • medical
  • men
  • mom
  • money
  • morning
  • movies
  • success

limit premium only - How many results to return. Must be between 1 and 100. By default 1 result is returned.

Headers

X-Api-Key (required) - API Key associated with your account.

Sample Request URL

Live Demo!

https://api.api-ninjas.com/v1/quotes?category=

Sample Response

[
  {
    "quote": "The will of man is his happiness.",
    "author": "Friedrich Schiller",
    "category": "happiness"
  }
]

import requests
category = 'happiness'
api_url = 'https://api.api-ninjas.com/v1/quotes?category={}'.format(category)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
    print(response.text)
else:
    print("Error:", response.status_code, response.text)
var category = 'happiness'
$.ajax({
    method: 'GET',
    url: 'https://api.api-ninjas.com/v1/quotes?category=' + category,
    headers: { 'X-Api-Key': 'YOUR_API_KEY'},
    contentType: 'application/json',
    success: function(result) {
        console.log(result);
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});
const request = require('request');
var category = 'happiness';
request.get({
  url: 'https://api.api-ninjas.com/v1/quotes?category=' + category,
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  else if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  else console.log(body)
});
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import com.fasterxml.jackson.databind.ObjectMapper;

URL url = new URL("https://api.api-ninjas.com/v1/quotes?category=happiness");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestProperty("accept", "application/json");
InputStream responseStream = connection.getInputStream();
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(responseStream);
System.out.println(root.path("fact").asText());
let category = "happiness".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
let url = URL(string: "https://api.api-ninjas.com/v1/quotes?category="+category!)!
var request = URLRequest(url: url)
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
    guard let data = data else { return }
    print(String(data: data, encoding: .utf8)!)
}
task.resume()
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.