Développeurs

Portail développeurs BirdSift

Tout pour intégrer BirdSift : docs API lisibles par les machines, clés d'espace de travail, connecteur MCP pour Claude et un bac à sable gratuit pour tester sur des données réelles.

Documentation et specs

Référence API REST

Endpoints versionnés `/v1` pour lister les leads, lancer des recherches bornées et rédiger des messages. Miroir Markdown pour les agents.

Spec OpenAPI 3.1

Surface machine-readable pour codegen, function calling et découverte par les agents sur `/openapi.json`.

Connecteur MCP

Recherche, consultation des leads et brouillons depuis Claude Desktop ou Claude Code — OAuth, sans clé API côté client.

Métadonnées OAuth

Serveur d'autorisation et métadonnées de ressource protégée pour MCP et clients OAuth.

Clés API

Les clés API BirdSift sont des secrets liés à l'espace de travail, pour scripts serveur et automatisations. Créez-en une dans l'app : icône de clé dans l'en-tête, nommez-la et copiez le texte en clair — affiché une seule fois, non récupérable. Utilisez l'en-tête `Authorization: Bearer bsk_live_…` sur `https://api.birdsift.com/v1/*`. N'intégrez jamais une clé dans du JavaScript navigateur ou un dépôt public.

Créer une clé API

Démarrage rapide

Chaque espace démarre avec 25 crédits gratuits — assez pour une vraie recherche et un brouillon avant d'acheter un forfait. Remplacez `$BIRDSIFT_API_KEY` par une clé créée dans l'app.

1. Lire la doc API publique (sans auth)

curl -s https://api.birdsift.com/v1/docs

2. Vérifier le solde de crédits

curl -s https://api.birdsift.com/v1/credits \
  -H "Authorization: Bearer $BIRDSIFT_API_KEY"

3. Lancer une recherche bornée

curl -s -X POST https://api.birdsift.com/v1/searches \
  -H "Authorization: Bearer $BIRDSIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries":[{"location":"Montréal, QC","category":"plombier"}],"filters":{"no_website":true},"max_results":5}'

Environnement bac à sable

BirdSift n'expose pas d'API mock séparée — le bac à sable, c'est votre espace sur l'infrastructure de production avec 25 crédits gratuits à l'inscription. Lancez de vraies recherches Google Places, enregistrez des leads et rédigez des brouillons sur des données réelles, sans carte bancaire. Crédits épuisés : achetez un forfait ou mettez en pause.

Commencer dans le bac à sable

Construire sur BirdSift

Connectez-vous, créez une clé API ou branchez MCP, et lancez votre première recherche en quelques minutes.

Ouvrir l'app