API de búsqueda de ejercicios: consultas y 6 idiomas

Envía q con una clave de API. Una petición sin q devuelve un error 400. Los resultados llegan en el mismo envoltorio { data, pagination } que el listado, ordenados por relevancia y con los empates resueltos por id. Las páginas traen 50 resultados por defecto y como máximo 100.

curl -H "Authorization: Bearer fed_live_YOUR_KEY" \
  "https://api.fitexercisedb.com/v1/exercises/search?q=squat&pageSize=10&lang=fr"

Cada resultado incluye todos los campos descritos en la referencia de campos de la respuesta. Por debajo es una consulta de texto completo de PostgreSQL sobre el nombre, el músculo objetivo y el equipamiento; no se indexa nada más.

El índice usa la configuración de texto simple de PostgreSQL, que pasa las palabras a minúsculas pero no aplica lematización, y la consulta se construye con plainto_tsquery, que exige cada palabra. Por eso una consulta solo coincide con palabras completas y todas las palabras enviadas deben estar presentes.

Si necesitas autocompletado, carga una vez la taxonomía y los nombres que te interesan, guárdalos en caché y filtra en local; usa la búsqueda para la consulta final. Prueba consultas en la base de datos de ejercicios para ver qué contiene antes de programar.

No traduciendo tu consulta. El texto indexado es el nombre, el músculo objetivo y el equipamiento en inglés; los nombres traducidos no forman parte del índice, así que una palabra francesa solo coincide si se escribe igual en inglés. El parámetro lang cambia lo que se devuelve, no lo que se compara.

El patrón que funciona para un buscador localizado es traducir tú mismo las palabras del usuario a términos en inglés y pedir después a la API el texto en su idioma:

// The user types in French. You map it to English terms, then ask for French text back.
const q = toEnglish("développé couché");        // your own mapping: "bench press"
const url = `/v1/exercises/search?q=${encodeURIComponent(q)}&lang=fr`;

Para los casos comunes evita el texto libre: ofrece listas de partes del cuerpo, músculos y equipamiento, conserva el valor en inglés como clave y muestra una etiqueta traducida.

Se comprueban tres fuentes en orden. Gana la primera admitida, y nada de esto es un error:

Los sufijos de región se descartan, así que fr-FR y pt-BR se resuelven como fr y pt. La cabecera se recorre en el orden escrito y se usa la primera etiqueta admitida; los pesos de calidad no se comparan. Un valor como de no está admitido y da inglés sin avisar. Cada respuesta indica qué idioma usó:

Content-Language: fr
Vary: Accept-Language

Como la misma URL puede devolver texto distinto según Accept-Language, incluye el idioma en tu clave de caché o envía un lang explícito.

Esa última fila es la trampa. Una respuesta en francés muestra Poitrine para el pecho, pero el filtro espera Chest:

# the filter value stays English, the labels come back in French
curl -H "Authorization: Bearer fed_live_YOUR_KEY" \
  "https://api.fitexercisedb.com/v1/exercises?bodyPart=Chest&lang=fr"

Obtén las listas de filtros una vez, sin lang, y guarda esos valores como claves; las listas exactas están en la documentación.