Les données des artisans français vérifiés, accessibles aux sites partenaires, agrégateurs et assistants IA.
Authorization de chaque requête./v1/*.curl -H "Authorization: Bearer sk_pub_xxxxxxxx_votreSecret" \
"https://lefairefrancais.fr/api-proxy/v1/merchants?family=gastronomie&limit=5"
Votre clé est secrète : ne l'exposez jamais dans du code côté navigateur ou une application mobile. Appelez l'API depuis votre serveur.
Chaque requête porte l'en-tête Authorization: Bearer sk_pub_<préfixe>_<secret>. Une clé absente, inconnue ou révoquée répond 401 avec un code stable : API_KEY_REQUIRED, API_KEY_INVALID ou API_KEY_REVOKED.
| Méthode | Chemin | Description |
|---|---|---|
| GET | /v1/merchants | Annuaire des artisans (filtres family, trade, department, q, pagination page / limit) |
| GET | /v1/merchants/{slug} | Fiche complète d'un artisan (produits, événements, avis) |
| GET | /v1/events | Événements à venir (department, type, from, to) |
| GET | /v1/events/{slug} | Détail d'un événement |
| GET | /v1/families | Familles d'artisans |
| GET | /v1/departments | Départements et nombre d'artisans |
| GET | /v1/trades | Métiers |
| GET | /v1/search?q= | Recherche transverse artisans, produits, événements |
Les réponses ont la même forme que celles de l'API publique du site.
# Les départements
curl -H "Authorization: Bearer $FRANCE_API_KEY" "https://lefairefrancais.fr/api-proxy/v1/departments"
# Une fiche artisan
curl -H "Authorization: Bearer $FRANCE_API_KEY" "https://lefairefrancais.fr/api-proxy/v1/merchants/boulangerie-dupont-paris"
# Recherche
curl -H "Authorization: Bearer $FRANCE_API_KEY" "https://lefairefrancais.fr/api-proxy/v1/search?q=poterie"
const res = await fetch("https://lefairefrancais.fr/api-proxy/v1/events?type=FAIR", {
headers: { Authorization: `Bearer ${process.env.FRANCE_API_KEY}` },
});
const { items, total } = await res.json();
| Élément | Valeur |
|---|---|
| Quota par défaut | 10 000 requêtes par jour et par clé |
| Réinitialisation | Chaque jour à minuit UTC |
| Pagination | limit jusqu'à 60 |
Chaque réponse contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (secondes avant la réinitialisation). Quota épuisé : 429 avec le code API_QUOTA_EXCEEDED et l'en-tête Retry-After.
Tout usage abusif entraîne la révocation de la clé.
Les erreurs ont la forme { "statusCode", "code", "message", "requestId" }. Codes fréquents : API_KEY_REQUIRED (401), API_KEY_INVALID (401), API_KEY_REVOKED (401), MERCHANT_NOT_FOUND (404), API_QUOTA_EXCEEDED (429).
Le fichier llms.txt décrit la plateforme et mentionne l'API /v1/, consommable avec une clé.
Les clés sont délivrées sur demande, gratuitement pour un usage non abusif. Décrivez votre projet et le volume attendu.