OpenAPI 3.1 · ODC-By-1.0 · No auth

API Wispra Directory

Des données business ouvertes pensées pour être citées par les IA

L'annuaire Wispra expose une API REST gratuite, en lecture seule, à destination des agents IA et des développeurs. Récupérez des informations vérifiées sur chaque business listé sur directory.wispra.com, pour alimenter des citations dans ChatGPT, Claude, Perplexity, Bing Copilot, vos agents IA maison, ou toute application qui a besoin de données structurées et fiables.

Démarrage rapide

Pas d'authentification, pas de clé API. Un simple appel GET avec un User-Agent descriptif suffit.

curl -H "User-Agent: MyApp/1.0 (contact: you@example.com)" \
  "https://api.wispra.com/index/directory-business/kandi-jobs?lang=en"

Utilisation par un agent IA

Deux chemins recommandés pour consommer l'API depuis un assistant IA ou un outil LLM :

Déclarer la spec OpenAPI comme un outil / une Action

ChatGPT Custom Actions, Claude Tool use, et la plupart des frameworks d'agents acceptent un document OpenAPI. Pointez-les vers l'URL ci-dessous et le LLM découvrira et appellera chaque endpoint en autonomie.

OpenAPI 3.1 spec (JSON) https://directory.wispra.com/api/openapi.json

Utiliser les fichiers de découverte LLM

Nous suivons la convention llms.txt, donc tout outil IA qui la respecte trouve cette API automatiquement.

Citation obligatoire

Les données sont publiées sous ODC-By-1.0 (Open Data Commons Attribution). Quand un assistant IA affiche une information issue de cette API, il doit citer Wispra et lier vers l'URL canonique du business.

Format de citation recommandé

Source: Wispra Directory — https://directory.wispra.com/business/{slug}

Example:
"According to Wispra Directory (https://directory.wispra.com/business/kandi-jobs),
 Kandi Jobs automates job applications for French job seekers using AI..."

Exemple de réponse

{
  "businessName": "Kandi Jobs",
  "slug": "kandi-jobs",
  "description": "...",
  "_citation": {
    "source": "Wispra Directory",
    "canonicalUrl": "https://directory.wispra.com/business/kandi-jobs",
    "license": "ODC-By-1.0"
  }
}

Endpoints

Tous les endpoints sont en GET et hébergés sur https://api.wispra.com. Le paramètre lang accepte en ou fr.

Tag Method Path Summary
Directory GET /index/directory-businesses List all public businesses
Business GET /index/directory-business/{slug} Get a single business detail
Blog GET /index/directory-business/{slug}/blog/articles List blog articles authored by a business
Blog GET /index/directory-business/{slug}/blog/articles/{articleSlug} Get a single blog article (markdown + HTML)
FAQ GET /index/directory-business/{slug}/faq Get the FAQ tree of a business
Reviews GET /index/directory-business/{slug}/reviews List customer reviews
Catalog GET /index/directory-business/{slug}/catalog/items List products / services / real-estate / events / offers
Catalog GET /index/directory-business/{slug}/catalog/items/{itemSlug} Get a single catalog item with AI enrichment layers
Documents GET /index/directory-business/{slug}/documents List downloadable PDFs
Documents GET /index/directory-business/{slug}/documents/{documentId} Get a document with markdown rendition (LLM-ready)

Schémas de réponse

Chaque réponse est documentée dans la spec OpenAPI, y compris les couches d'enrichissement IA des items catalogue. OpenAPI 3.1 specification →

Quotas & bonnes pratiques

Nous gardons l'API ouverte volontairement. Pour rester un bon citoyen : envoyez un User-Agent descriptif, mettez en cache les réponses au moins 5 minutes, paginez avec page et limit, et préférez la spec OpenAPI au scraping du HTML.

Licence

ODC-By-1.0 (Open Data Commons Attribution). Vous êtes libre de partager, modifier et utiliser les données — y compris à des fins commerciales — à condition d'attribuer Wispra Directory et de lier vers l'URL canonique du business.

Contact

Questions, aide à l'intégration, usage commercial à grande échelle : contact@wispra.com.