public_exercises

Search Public Exercises

Changed on

Hybrid vector + keyword search over public_exercises.

The search core (embed → vector KNN → keyword regex → RRF merge → hydrate

  • gate) lives in services/exercise_library_search.py, shared with the chat tool search_exercise_library.

The response shape mirrors GET /public-exercises so callers can reuse the existing PublicExerciseOut type.

get/public-exercises/search

Request

  • Base URL: https://api.excellence-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.excellence-ai.com/public-exercises/search
  • Auth: OAuth 2 (password, token URL api/login)

Query parameters

qstring required

Free-text search query.

category_pathstring[] nullable

Prefix filter on category_path (repeat the query param per segment). Results are post-filtered to rows whose category_path starts with these segments.

difficultystring nullable

Exact-match filter on difficulty (easy/medium/hard).

type'exercice' | 'automatisme' | 'application_du_cours' nullable

Exact-match filter on type.

library'excellence' | 'cpge' | 'remediation' nullable

Admin-only library override. Non-admin callers stay gated by library_filter_for(user) regardless of this param.

subject'maths' | 'physique-chimie' nullable

Scope search to a matière (see list endpoint).

top_ninteger

Max number of results.

Response

Successful Response

idstring required
themesstring[] required
contentstring required
solutionstring required
figure_contentstring nullable
figure_solutionstring nullable
created_atstring date-time required
updated_atstring date-time required
sequence_numberinteger nullable
difficultystring nullable
category_pathstring[]
subject'maths' | 'physique-chimie'
library'excellence' | 'cpge' | 'remediation'
type'exercice' | 'automatisme' | 'application_du_cours'
origin'excellence' | 'saint_jean_hulst' | 'lacordaire'
likes_countinteger
savoirs_faire_idsstring[]
titlestring nullable

Changes