Ir al contenido
GET /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.

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

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

Obtener una clave API

Fragmentos 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
}