Random Quotes
Get random inspirational quotes from famous people, thinkers, and leaders. Perfect for daily motivation, content generation, or adding wisdom to your applications.
Overview
Use Cases
- Daily motivation apps and widgets
- Social media content generation
- Quote of the day features
- Inspirational dashboards
- Content placeholders for design
Features
Curated collection of inspirational quotes
Includes author attribution
Fast response times
No parameters required
API Endpoints
Get Random Quote
Returns a random inspirational quote with author attribution
GET
https://requiems.xyz/v1/entertainment/quotes/random
Try it out
Live DemoRequest
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| id | integer |
Unique identifier for the quote |
| text | string |
The quote text |
| author | string |
Name of the person who said or wrote the quote |
Code Examples
curl https://requiems.xyz/v1/entertainment/quotes/random \
-H "requiems-api-key: YOUR_API_KEY"import requests
url = "https://requiems.xyz/v1/entertainment/quotes/random"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
quote = response.json()['data']
print(f"{quote['text']} - {quote['author']}")const response = await fetch('https://requiems.xyz/v1/entertainment/quotes/random', {
headers: {
'requiems-api-key': 'YOUR_API_KEY'
}
});
const { data } = await response.json();
console.log(`${data.text} - ${data.author}`);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/entertainment/quotes/random')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
data = JSON.parse(response.body)['data']
puts "#{data['text']} - #{data['author']}"Error Responses
503
service_unavailable
No quotes available in the database
Get Random Quotes (Batch)
Returns up to 50 random quotes in a single request. Each quote counts as one unit of usage.
POST
https://requiems.xyz/v1/entertainment/quotes/random/batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| count | integer |
Required | Number of random quotes to return. Between 1 and 50. |
Try it out
Live DemoRequest
Number of random quotes to return. Between 1 and 50.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array<object> |
Array of random quotes, one per requested count. |
| results[].id | integer |
Unique identifier for the quote. |
| results[].text | string |
The quote text. |
| results[].author | string |
Name of the person who said or wrote the quote. May be empty. |
| total | integer |
Total number of quotes returned. Always equals the requested count. |
Code Examples
curl -X POST https://requiems.xyz/v1/entertainment/quotes/random/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"count": 5}'import requests
url = "https://requiems.xyz/v1/entertainment/quotes/random/batch"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {"count": 5}
response = requests.post(url, json=payload, headers=headers)
for quote in response.json()['data']['results']:
print(f"{quote['text']} - {quote['author']}")const response = await fetch(
'https://requiems.xyz/v1/entertainment/quotes/random/batch',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ count: 5 })
}
);
const { data } = await response.json();
data.results.forEach(q => console.log(`${q.text} - ${q.author}`));require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/entertainment/quotes/random/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { count: 5 }.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
JSON.parse(response.body)['data']['results'].each do |q|
puts "#{q['text']} - #{q['author']}"
endError Responses
400
bad_request
Request body is missing or not valid JSON.
422
unprocessable_entity
count is missing, less than 1, or greater than 50.
Frequently Asked Questions
Currently, the API returns random quotes from our entire collection. Author filtering is planned for a future update.
Our collection contains hundreds of curated inspirational quotes from famous thinkers, leaders, and innovators, and we're constantly adding more.
No, quotes are selected randomly on each request, so consecutive calls will typically return different quotes.
Yes. Use the batch endpoint (POST /v1/entertainment/quotes/random/batch) to request up to 50 random quotes in a single call. Each quote counts as one unit of usage.