Random Facts

Get random interesting facts from a curated database covering science, history, technology, nature, space, and food.

Get API Key

Descripción general

Casos de uso

Daily fact widgets and educational sidebars
Trivia games and quiz apps
Loading screen content and onboarding copy
Educational platforms and learning apps

Funcionalidades

Curated facts across 6 categories

Optional category filtering

Includes source attribution for each fact

Puntos finales de la API

Get Random Fact

Returns a randomly selected fact, optionally filtered by category.

GET

https://requiems.xyz/v1/entertainment/facts

Parámetros

Nombre	Tipo	Obligatorio	Descripción
category	`string`	Opcional	Filter by category. Valid values: science, history, technology, nature, space, food

Pruébalo

Demostración en vivo

Solicitud

category (string)

Filter by category. Valid values: science, history, technology, nature, space, food

Campos de respuesta

Campo	Tipo	Descripción
fact	`string`	The fact text
category	`string`	The category the fact belongs to
source	`string`	The source or publication the fact is attributed to

Ejemplos de código

# Random fact from any category
curl https://requiems.xyz/v1/entertainment/facts \
  -H "requiems-api-key: YOUR_API_KEY"

# Random science fact
curl "https://requiems.xyz/v1/entertainment/facts?category=science" \
  -H "requiems-api-key: YOUR_API_KEY"

import requests

url = "https://requiems.xyz/v1/entertainment/facts"
headers = {"requiems-api-key": "YOUR_API_KEY"}

# Optional: filter by category
params = {"category": "space"}

response = requests.get(url, headers=headers, params=params)
data = response.json()['data']
print(f"[{data['category']}] {data['fact']} — {data['source']}")

const response = await fetch(
  'https://requiems.xyz/v1/entertainment/facts?category=history',
  { headers: { 'requiems-api-key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();
console.log(`[${data.category}] ${data.fact} — ${data.source}`);

require 'net/http'
require 'json'

uri = URI('https://requiems.xyz/v1/entertainment/facts')
uri.query = URI.encode_www_form(category: 'nature')
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['category']}] #{data['fact']} — #{data['source']}"

Respuestas de error

400

bad_request

Sin resultados