Semantic (vector) search over the exercises accessible to your company. Unlike keyword search, it understands the meaning of your query — searching for "exercises for bad knees" returns relevant low-impact exercises even if they don't contain those exact words.

The AI Trainer runs this search internally when building workouts — you don't need to call it yourself for that. Use it directly when building your own agent, or a search/browse experience on top of the exercise library.

1GET https://data.kinestex.com/api/exercises/search

Requires the same JWT Bearer token as the trainer endpoints (see Authentication).

Query parameters:

Lightweight response (basic_info=true) — ideal as LLM context:

1{
2  "exercises": [
3    {
4      "id": "123",
5      "title": "Squat",
6      "description": "A fundamental lower-body exercise targeting the quads, glutes, and hamstrings.",
7      "thumbnail_url": "https://cdn.kinestex.com/exercises/squat-thumbnail.jpg",
8      "video_url": "https://cdn.kinestex.com/exercises/squat.mp4",
9      "male_thumbnail_url": "https://cdn.kinestex.com/exercises/squat-male-thumbnail.jpg",
10      "male_video_url": "https://cdn.kinestex.com/exercises/squat-male.mp4"
11    }
12  ],
13  "count": 1
14}

The full response (default) additionally includes per exercise: difficulty_level, position, calories_per_rep, body_parts, categories, contraindications, equipment (empty array = bodyweight), repeats, countdown, and a translation object for the requested lang with title, description, tips, exercise_steps, common_mistakes, and rest-speech audio URLs.

Rate limiting: 50 semantic searches per user per day (resets at UTC midnight) → 429 when exceeded. A company-level daily read quota also applies.

Errors: 400 (missing/too-long query, invalid limit), 401 (missing/invalid JWT), 429, 500.

Examples:

1# Basic search
2curl "https://data.kinestex.com/api/exercises/search?query=core+exercises+for+beginners&limit=10" \
3  -H "Authorization: Bearer <jwt>"
4
5# Localized, lightweight, category-filtered
6curl "https://data.kinestex.com/api/exercises/search?query=knee+friendly+exercises&lang=es&basic_info=true&categories=Strength,Cardio&limit=5" \
7  -H "Authorization: Bearer <jwt>"

See Build a workout-recommendation chatbot for a complete example pairing this endpoint with an LLM.