Ir al contenido
GET /v1/random

A random hadith

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/hadith-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/hadith-api/v1/random" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/hadith-api/v1/random", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/hadith-api/v1/random");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/hadith-api/v1/random",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "hadith": {
            "text": "Narrated Ibn `Abbas:A man came to the Prophet (ﷺ) and said to him, \"My sister vowed to perform the Hajj, but she died (before fulfilling it).\" The Prophet (ﷺ) said, \"Would you not have paid her debts if she had any?\" The man said, \"Yes.\" The Prophet (ﷺ) said, \"So pay Allah's Rights, as He is more entitled to receive His rights",
            "grades": [],
            "number": 6699,
            "edition": "eng-bukhari",
            "reference": {
                "book": 83,
                "hadith": 76
            },
            "arabic_number": 6699
        },
        "collection": "Sahih al Bukhari"
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:29.119Z",
        "request_id": "10e81e01-b5f4-4db5-a6eb-045f2e2a2d90"
    },
    "status": "ok",
    "message": "Random hadith retrieved successfully",
    "success": true
}