Riferimento API v1

Catalogo auto-documentato dell'API (pubblico, senza token).

Esempio di richiesta

curl "https://www.superalternance.com/api/v1"

Esempio di risposta

{
  "name": "superalternance API partenaires",
  "version": "1",
  "authentication": { "type": "bearer", "description": "…" },
  "endpoints": [ … ]
}

Autocompletamento « professione o corso di formazione » per una barra di ricerca.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/suggest?q=boul&limit=5"

Esempio di risposta

{
  "query": "boul",
  "suggestions": [
    { "kind": "rome", "value": "Boulanger", "secondary": "Métier" },
    { "kind": "formation", "value": "CAP Boulanger", "secondary": "CFA des métiers" }
  ]
}

Autocompletamento di luoghi: regioni, dipartimenti e comuni.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/places?q=lyon"

Esempio di risposta

{
  "query": "lyon",
  "suggestions": [
    { "kind": "city", "value": "Lyon", "secondary": "69001 · Rhône", "lat": 45.758, "lng": 4.835 }
  ]
}

Ricerca unificata offerte + corsi di formazione, filtrabile per luogo, professione, corso di formazione e livello.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/search?metier=boulanger&lieu=Lyon&type=jobs&limit=5"

Esempio di risposta

{
  "filters": { "metier": "boulanger", "resolvedRomeCodes": ["D1102", "D1104"], "lieu": "Lyon", "type": "jobs" },
  "pagination": { "limit": 5, "offset": 0 },
  "totals": { "jobs": 42, "formations": 0 },
  "results": [
    {
      "kind": "job", "id": "…", "title": "Boulanger en alternance",
      "subtitle": "Maison Dupain · Lyon", "city": "Lyon",
      "latitude": 45.75, "longitude": 4.84,
      "labels": ["Apprentissage", "CAP"],
      "url": "https://www.superalternance.com/fr/offres/…"
    }
  ]
}

Ultime offerte di apprendistato pubblicate, con filtro luogo facoltativo.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/jobs/latest?lieu=Bordeaux&limit=10"

Esempio di risposta

{
  "filters": { "lieu": "Bordeaux" },
  "total": 10,
  "jobs": [
    { "id": "…", "title": "Développeur web en alternance", "subtitle": "Acme · Bordeaux",
      "city": "Bordeaux", "latitude": 44.84, "longitude": -0.58,
      "labels": ["Apprentissage"], "url": "https://www.superalternance.com/fr/offres/…" }
  ]
}

Dettaglio completo di un'offerta: contratto, datore di lavoro, localizzazione, candidatura.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/jobs/abc123"

Esempio di risposta

{
  "job": {
    "id": "abc123", "title": "Boulanger en alternance",
    "contractTypes": ["Apprentissage"], "duration": "24 mois",
    "location": { "city": "Lyon", "zipCode": "69003", "region": "Auvergne-Rhône-Alpes" },
    "company": { "name": "Maison Dupain", "siret": "…", "siren": "…" },
    "apply": { "email": null, "url": "…" }
  }
}

Dettaglio completo di un corso di formazione: titolo di studio, RNCP, organismo (CFA), ritmo.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/formations/xyz789"

Esempio di risposta

{
  "formation": {
    "id": "xyz789", "title": "CAP Boulanger", "diploma": "CAP",
    "rncpCode": "RNCP…", "targetDiplomaLevel": "3",
    "location": { "city": "Lyon", "region": "Auvergne-Rhône-Alpes" },
    "cfa": { "name": "CFA des métiers", "siret": "…" }
  }
}

Profilo del datore di lavoro per SIRET ed elenco delle sue offerte di apprendistato aperte.

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/companies/12345678901234"

Esempio di risposta

{
  "company": {
    "siret": "12345678901234", "siren": "123456789", "name": "Maison Dupain",
    "size": "10 à 19 salariés", "nafCodes": ["1071C"],
    "location": { "city": "Lyon", "region": "Auvergne-Rhône-Alpes" },
    "openJobsCount": 3, "openJobs": [ … ]
  }
}

Statistiche aggregate della piattaforma (+ contatori per professione).

Parametri

Esempio di richiesta

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/stats?metier=boulanger"

Esempio di risposta

{
  "jobs": 17658, "formations": 58596, "cfa": 6923,
  "lastSyncAt": "2026-06-04T21:01:06.369Z",
  "metier": { "name": "boulanger", "jobs": 42, "formations": 120, "diplomas": 8 }
}