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

Ajouter à Claude

Installez depuis le répertoire Connectors de Claude. Connectez-vous avec votre compte BirdSift — pas de clé API côté client.

Connecteur MCP

Recherchez des entreprises locales, consultez vos leads et rédigez des brouillons depuis Claude Desktop ou Claude Code.

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`.

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 10 crédits gratuits — assez pour une vraie recherche 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 10 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

Ajoutez BirdSift à Claude depuis le répertoire Connectors, ou connectez-vous à l'app pour créer des clés API et lancer des recherches dans le navigateur.

Ajouter à Claude Ouvrir l'app