Exercises API: Browse the Blackterz Exercise Catalog

The Exercises API exposes the entire Blackterz exercise catalog in a single authenticated request. Each exercise object includes its name, category, static image, optional animated GIF URL, and a comma-separated string of associated muscle group names resolved via a SQL GROUP_CONCAT join. The catalog covers barbell, dumbbell, bodyweight, machine, and cable movements.

GET /api/ejercicios

Returns all exercises in the catalog, ordered alphabetically by name. Muscle groups are resolved by a SQL LEFT JOIN against the ejercicios_grupos_musculares and grupos_musculares tables, collapsed into a single musculos string per row using GROUP_CONCAT. Auth required: Yes — Authorization: Bearer <token>

Request

No query parameters or request body. Authentication is handled entirely by the Authorization header.

curl -X GET https://api.blackterzgym.com/api/ejercicios \
  -H "Authorization: Bearer <your_token>"

Response

status

string

required

Always "ok" on success.

data

array

required

Array of exercise objects. Ordered alphabetically by nombre.

Show Exercise object fields

integer

Unique exercise identifier.

nombre

string

Exercise name in Spanish (e.g., "Press de banca", "Sentadilla").

descripcion

string

Short description of the exercise and its primary equipment type.

categoria

string

Exercise category (e.g., "fuerza").

imagen_url

string | null

Filename of the static preview image, e.g. "bench-press.avif". Serve from /images/<imagen_url>.

gif_url

string | null

URL to an animated demonstration GIF. Returns null when no GIF has been configured for this exercise.

musculos

string | null

Comma-separated list of muscle group names involved in this exercise, ordered alphabetically. Built via SQL GROUP_CONCAT. Example: "Glúteos, Isquiotibiales, Trampas". Returns null if no muscle groups are mapped.

Sample response

{
  "status": "ok",
  "data": [
    {
      "id": 32,
      "nombre": "Abdominales",
      "descripcion": "Ejercicio de peso corporal para Core.",
      "categoria": "fuerza",
      "imagen_url": "crunches.avif",
      "gif_url": null,
      "musculos": "Core"
    },
    {
      "id": 33,
      "nombre": "Abdominales sentado",
      "descripcion": "Ejercicio de peso corporal para Core.",
      "categoria": "fuerza",
      "imagen_url": "sit-ups.avif",
      "gif_url": null,
      "musculos": "Core, Flexores Cadera"
    },
    {
      "id": 61,
      "nombre": "Aductores en máquina",
      "descripcion": "Ejercicio de máquina para Aductores.",
      "categoria": "fuerza",
      "imagen_url": "hip-adduction.avif",
      "gif_url": null,
      "musculos": "Aductores"
    }
  ]
}

Error responses

500 Internal Server Error

Returned when the database query fails.

{
  "status": "error",
  "message": "Error interno del servidor"
}

401 Unauthorized

Returned when no token is provided or the token is invalid/expired. Handled by the verificarToken middleware before reaching this controller.

{
  "status": "error",
  "message": "Token no válido o expirado"
}

Full curl example

curl -X GET https://api.blackterzgym.com/api/ejercicios \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Overview

Endpoints

Exercises API: Browse the Blackterz Exercise Catalog

GET /api/ejercicios

Request

Response

Sample response

Error responses

Full curl example

Build docs developers (and LLMs) love

Overview

Endpoints

Documentation Index

​GET /api/ejercicios

​Request

​Response

​Sample response

​Error responses

​Full curl example

Build docs developers (and LLMs) love

GET /api/ejercicios

Request

Response

Sample response

Error responses

Full curl example