API & flux RSS

Flux RSS

Deux flux RSS 2.0 sont disponibles, mis à jour toutes les heures, listant les bourses publiées les plus récentes (50 maximum) :

• GET /feed.xml

  Flux global : toutes les bourses publiées récemment, toutes nationalités et niveaux confondus.

• GET /feed/[nationalite].xml

  Flux filtré par nationalité éligible, où [nationalite] est l'un des slugs utilisés sur les pages Bourses pour vous, par exemple :

  https://trouvetabourse.com/feed/etudiants-togolais.xml

API publique /api/v1/scholarships

Endpoint JSON paginé listant les bourses au statut PUBLISHED, avec filtres optionnels.

curl "https://trouvetabourse.com/api/v1/scholarships?nationality=TG&level=MASTER&page=1"

Paramètres

Tous les paramètres sont optionnels et peuvent être combinés. Une valeur invalide ou inconnue est simplement ignorée (le filtre correspondant n'est pas appliqué).

Niveaux d'études

Types de financement

Domaines d'études (field)

Réponse

data contient la liste des bourses pour la page demandée, meta les informations de pagination.

{
  "data": [
    {
      "id": "clx1example",
      "slug": "bourse-excellence-eiffel-2026",
      "title": "Bourse d'excellence Eiffel — Master & Doctorat",
      "summary": "Bourse du gouvernement français pour les meilleurs étudiants internationaux...",
      "url": "https://trouvetabourse.com/bourses/bourse-excellence-eiffel-2026",
      "funder": { "name": "Campus France", "logoUrl": null },
      "fundingType": "TOTALE",
      "amount": { "min": 1181, "max": 1700, "currency": "EUR", "period": "month", "note": null },
      "studyLevels": ["MASTER", "DOCTORAT"],
      "fieldsOfStudy": ["informatique", "ingenierie"],
      "hostCountries": ["FR"],
      "eligibleNationalities": [],
      "excludedNationalities": ["FR"],
      "deadlineType": "FIXED",
      "deadline": "2026-09-15T00:00:00.000Z",
      "opensAt": null,
      "officialUrl": "https://www.campusfrance.org/fr/bourse-eiffel",
      "publishedAt": "2026-06-01T08:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 20,
    "total": 134,
    "pageCount": 7
  }
}

Rate limiting

L'API est limitée à 60 requêtes par minute par adresse IP. Les en-têtes de réponse X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset indiquent respectivement la limite, le nombre de requêtes restantes et l'horodatage Unix de réinitialisation de la fenêtre. Au-delà de la limite, l'API répond 429 Too Many Requests avec un en-tête Retry-After.

CORS

L'API est accessible en lecture depuis n'importe quel domaine (Access-Control-Allow-Origin: *). Aucune authentification n'est requise.

Widget embarquable

Affichez une sélection de bourses TrouveTaBourse directement sur votre site (blog, association étudiante, université...). Le widget est isolé dans son propre style (aucune dépendance, aucun conflit CSS) et s'adapte automatiquement.

<div data-bourses-widget data-nationality="TG" data-level="MASTER" data-count="3" data-theme="light" data-lang="fr"></div>
<script src="https://trouvetabourse.com/widget.js" async></script>

Attributs disponibles