Comment utiliser l'API The Stack

Ce guide vous explique comment interroger les données de The Stack par programmation, de la création de votre clé API jusqu’à vos premières requêtes HTTP.

1. Inscription et vérification du compte

Pour commencer, créez un compte sur la page d’inscription The Stack.

Après votre inscription, vous recevrez un e-mail contenant un lien de confirmation (pensez à vérifier vos courriers indésirables si vous ne le voyez pas dans la minute).

En cliquant sur ce lien, vous validez votre adresse e-mail et activez vos crédits d’essai gratuit, visibles sur votre Tableau de bord :

2. Générer votre clé API

Une fois votre compte vérifié, rendez-vous dans la section Clés API :

1. Cliquez sur « Générer une nouvelle clé ».
2. Une fenêtre sécurisée affiche votre nouvelle clé API secrète :

Important : Copiez et enregistrez votre clé secrète immédiatement dans un gestionnaire de mots de passe ou un fichier .env. Pour des raisons de sécurité, elle ne pourra plus être affichée après la fermeture de cette fenêtre.

Vous pouvez conserver jusqu’à 3 clés actives simultanément pour vos différents environnements (production, pré-production ou développement local).

3. Envoyer vos premières requêtes

Chaque requête adressée à l’API The Stack s’authentifie en transmettant votre clé secrète dans l’en-tête HTTP X-API-KEY.

Exemple A : Rechercher des publications Reddit

Interrogez les publications Reddit indexées par subreddit, mot-clé, score et date :

1
2

curl -X GET "https://thestack.es/api/v1/search/reddit?subreddit=SaaS&search=revenue&sort_by=score&order=desc" \
     -H "X-API-KEY: {votre_cle_api}"

Exemple B : Rechercher des profils d’investisseurs

Filtrez les business angels, fonds de capital-risque et investisseurs par zone géographique et préférences d’investissement :

1
2

curl -X GET "https://thestack.es/api/v1/search/investors?page=1&sort_by=updated_at&order=desc" \
     -H "X-API-KEY: {votre_cle_api}"

Paramètres courants

• page et per_page : Contrôle de la pagination (15 par défaut, 100 maximum).
• sort_by et order : Champ de tri (posted_at, score, updated_at) et ordre (asc ou desc).
• X-API-KEY : Votre jeton d’authentification transmis en en-tête.

4. Documentation interactive (Swagger)

L’ensemble des points d’accès est documenté dans notre interface OpenAPI / Swagger sur thestack.es/api/docs/.

Vous pouvez tester n’importe quel point d’accès directement depuis votre navigateur en cliquant sur « Try it out » :

5. Intégration avec vos outils No-Code et tableurs

Même sans écrire de code en Python ou JavaScript, vous pouvez connecter l’API The Stack à vos outils habituels :

• Tableurs : Utilisez des extensions comme API Connector dans Google Sheets ou Excel pour importer vos données en direct.
• Clients API : Importez les requêtes dans Postman ou Insomnia.
• Automatisation : Connectez votre clé API à Make, Zapier, Retool ou Clay pour alimenter vos workflows d’enrichissement.