Aller au contenu
GET /v1/random

Random exercise(s) by filter

Essayez-le en direct

10 appels gratuits par jour — sans inscription, sans clé API. Passe par la passerelle oanor.

En-têtes personnalisés (facultatif)
api.oanor.com/exercises-api

Ça marche. Récupérez une clé API et utilisez-la dans votre projet.

Obtenez une clé API

Extraits de code

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_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "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
}