Accès
API Gamma Insights
Interrogez par programmation la base de données de Gamma Insights via une API REST stable : entreprises de 52 marchés, transcriptions de conférences émetteurs et documents émetteurs. L'accès en lecture est standard ; les droits d'écriture permettent à vos propres systèmes de créer listes, recherches enregistrées et travaux d'enrichissement. Authentifiez-vous avec une clé API et recevez du JSON structuré.
Interface
- URL de base
- https://api.gamma-insights.co/api/v1/
- Authentification
- Clé d'API, transmise en en-tête de requête — X-API-Key
- Format
- JSON. Lecture en standard, droits d'écriture sur demande
- Accès en écriture
- Activé par clé. Couvre les listes, les recherches enregistrées, le statut de contact et les travaux d'enrichissement ; les données de référence restent en lecture seule
- Versionnement
- Version dans le chemin ; les champs sont ajoutés, jamais supprimés ni renommés
Démarrez en trois étapes
L'API est en lecture seule et renvoie du JSON. Chaque requête est authentifiée avec une clé API et combine des filtres optionnels avec un ET logique.
- 01
Obtenez une clé API
Demandez une clé à votre gestionnaire de compte. Elle n'est affichée qu'une fois et stockée uniquement sous forme de hash : conservez-la en lieu sûr.
- 02
Authentifiez-vous
Envoyez votre clé dans l'en-tête X-API-Key (ou Authorization: Api-Key <clé>) à chaque requête.
- 03
Interrogez les entreprises
Filtrez par pays, activité, localisation, chiffre d'affaires et plus encore, avec une pagination par page.
Ressources
Ce que vous pouvez interroger
| Ressource | Chemin | Retourne |
|---|---|---|
| Entreprises | GET /companies/ | Recherchez et listez des entreprises dans tous les pays pris en charge, avec des filtres combinables et la pagination. |
| Entreprises | GET /companies/{id}/ | Récupérez une entreprise par son identifiant de registre national (avec un pays optionnel pour lever l'ambiguïté). |
| Transcriptions | GET /transcripts/ | Recherchez des transcriptions de conférences de résultats par symbole, société, secteur, trimestre ou date, avec des synthèses de sentiment. |
| Transcriptions | GET /transcripts/{id}/content/ | Récupérez les blocs de contenu d'une transcription, annotés par intervenant, avec le sentiment par bloc. |
| Documents | GET /ir-documents/ | Publications des émetteurs — communiqués, présentations et rapports — pour l'univers couvert, avec un point de téléchargement par document. |
| Listes | GET, POST /lists/ | Lire vos listes d'entreprises, en créer de nouvelles et y ajouter des entreprises. |
| Recherches enregistrées | GET, POST /saved-searches/ | Lire, créer et mettre à jour les jeux de filtres enregistrés utilisés par votre équipe. |
| Workflow | POST /contact-status/ | Enregistrer où en est une entreprise dans votre propre processus d'approche ou de revue. |
| Workflow | POST /enrichment/ | Lancer un travail d'enrichissement de contacts sur un ensemble d'entreprises et en récupérer le résultat. |
Les points de lecture fonctionnent avec n'importe quelle clé. Les points d'écriture exigent une clé dont l'accès en écriture a été activé ; sans cela ils renvoient 403 et rien n'est créé.
Référence
Une première requête
Les filtres se combinent en ET logique ; les résultats sont paginés.
$ curl "https://api.gamma-insights.co/api/v1/companies/?country=FR&page_size=25" \
-H "X-API-Key: $GAMMA_API_KEY"
{
"count": 1284,
"next": "...?page=2",
"results": [ ... ]
}Garanties
Conçu pour l'intégration
- Contrat stable
- Les champs ne sont qu'ajoutés au sein d'une version, jamais supprimés ni renommés, pour que votre intégration continue de fonctionner.
- Limites prévisibles
- Chaque clé dispose de limites de débit horaires et quotidiennes claires, avec des réponses 401, 404 et 429 standard.
- Données publiques uniquement
- L'API n'expose que des données publiques de registre d'entreprises, des transcriptions de conférences émetteurs révisées et des documents émetteurs publiés — jamais de transcriptions privées, d'appels d'experts, de CRM interne ou de données d'un autre compte.