GET /v1/api/offres/autocomplete?q=dev HTTP/1.1

{
  "suggestions": [
    "Développeur Backend Java (H/F)",
    "Développeur Frontend React (H/F)",
    "Développeur Fullstack",
    "DevOps Engineer"
  ]
}

GET /v1/api/offres/search?q=java
  &secteur=SOFTWARE
  &typeContrat=CDI,CDD
  &niveauExperience=SENIOR
  &villeId=101
  &salaireMin=600000
  &teletravail=true
  &page=0&size=20
  &sort=relevance,desc

{
  "content": [
    {
      "id": 123,
      "slug": "dev-backend-java-douala-123",
      "titre": "Développeur Backend Java (H/F)",
      "entreprise": { "nom": "Tech Corp", "logoUrl": "..." },
      "ville": { "nom": "Douala" },
      "typeContrat": "CDI",
      "salaire": { "min": 600000, "max": 900000, "devise": "XAF" },
      "publishedAt": "2026-04-15T09:30:00Z",
      "rank": 0.85
    }
  ],
  "page": 0,
  "size": 20,
  "totalElements": 47,
  "totalPages": 3
}

GET /v1/api/offres/count?secteur=SOFTWARE HTTP/1.1

{ "count": 128 }

GET /v1/api/offres/search?villeId=101&size=10&sort=published_at,desc

GET /v1/api/offres/search?q=developpeur&niveauExperience=SENIOR&size=50

GET /v1/api/offres/search?teletravail=true

async function searchOffres(q, filters = {}) {
  const params = new URLSearchParams({ q, ...filters, page: 0, size: 20 });
  const r = await fetch(`/v1/api/offres/search?${params}`);
  return r.json();
}

const data = await searchOffres('java spring', {
  typeContrat: 'CDI',
  niveauExperience: 'SENIOR',
  villeId: 101,
});
console.log(`${data.totalElements} offres`);