/v1/random
Random exercise(s) by filter
Pruébalo en vivo
10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.
Funciona. Consigue una clave API y úsala en tu proyecto.
Obtener una clave APIFragmentos de código
curl "https://api.oanor.com/exercises-api/v1/random" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/exercises-api/v1/random", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/exercises-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/exercises-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": {
"count": 1,
"filters": {
"q": null,
"force": null,
"level": null,
"muscle": null,
"category": null,
"mechanic": null,
"equipment": null
},
"results": [
{
"id": "Dynamic_Chest_Stretch",
"name": "Dynamic Chest Stretch",
"force": "pull",
"level": "beginner",
"images": [
"https://raw.githubusercontent.com/yuhonas/free-exercise-db/main/exercises/Dynamic_Chest_Stretch/0.jpg",
"https://raw.githubusercontent.com/yuhonas/free-exercise-db/main/exercises/Dynamic_Chest_Stretch/1.jpg"
],
"category": "stretching",
"mechanic": null,
"equipment": null,
"instructions": [
"Stand with your hands together, arms extended directly in front of you. This will be your starting position.",
"Keeping your arms straight, quickly move your arms back as far as possible and back in again, similar to an exaggerated clapping motion. Repeat 5-10 times, increasing speed as you do so."
],
"primaryMuscles": [
"chest"
],
"secondaryMuscles": [
"middle back"
]
}
]
},
"meta": {
"timestamp": "2026-05-31T02:39:56.531Z",
"request_id": "c4cc3cd0-9981-4f3b-b799-92477f3fb5f4"
},
"status": "ok",
"message": "Random exercise retrieved",
"success": true
}