Random Facts

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

Get API Key

Vue d'ensemble

Cas d'utilisation

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

Fonctionnalités

Curated facts across 6 categories

Optional category filtering

Includes source attribution for each fact

Points de terminaison de l'API

Get Random Fact

Returns a randomly selected fact, optionally filtered by category.

GET

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

Paramètres

Nom	Type	Requis	Description
category	`string`	Facultatif	Filter by category. Valid values: science, history, technology, nature, space, food

Essayez-le

Démo en direct

Requête

category (string)

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

Champs de réponse

Champ	Type	Description
fact	`string`	The fact text
category	`string`	The category the fact belongs to
source	`string`	The source or publication the fact is attributed to

Exemples de code

# 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']}"

Réponses d'erreur

400

bad_request

Aucun résultat