Access
Gamma Insights API
Query the Gamma Insights database programmatically over a stable REST API: companies across 13 markets, issuer-call transcripts and issuer documents. Read access comes as standard; write scopes let your own systems create lists, saved searches and enrichment jobs. Authenticate with an API key and get structured JSON back.
Interface
- Base URL
- https://api.gamma-insights.co/api/v1/
- Authentication
- API key, sent as a request header — X-API-Key
- Format
- JSON. Read access as standard, write scopes on request
- Write access
- Enabled per key. Covers lists, saved searches, contact status and enrichment jobs; the reference data stays read-only
- Versioning
- Path-versioned; fields are added, never removed or renamed
Get started in three steps
The API is read-only and returns JSON. Every request is authenticated with an API key and combines optional filters with logical AND.
- 01
Get an API key
Request a key from your account manager. It is shown once and stored only as a hash, so keep it somewhere safe.
- 02
Authenticate
Send your key in the X-API-Key header (or Authorization: Api-Key <key>) on every request.
- 03
Query companies
Filter by country, activity, location, revenue and more, with page-based pagination.
Resources
What you can query
| Resource | Path | Returns |
|---|---|---|
| Companies | GET /companies/ | Search and list companies across all supported countries with combinable filters and pagination. |
| Companies | GET /companies/{id}/ | Retrieve a single company by its national registry identifier (with an optional country to disambiguate). |
| Transcripts | GET /transcripts/ | Search earnings-call transcripts by ticker, company, sector, quarter or date, with sentiment summaries. |
| Transcripts | GET /transcripts/{id}/content/ | Retrieve a transcript's speaker-tagged content blocks with per-block sentiment. |
| Documents | GET /ir-documents/ | Issuer publications — releases, presentations and reports — for the covered universe, with a download endpoint per document. |
| Lists | GET, POST /lists/ | Read your company lists, create new ones, and add companies to them. |
| Saved searches | GET, POST /saved-searches/ | Read, create and update the saved filter sets your team works from. |
| Workflow | POST /contact-status/ | Record where a company stands in your own outreach or review process. |
| Workflow | POST /enrichment/ | Queue a contact-enrichment job for a set of companies and collect the result. |
Read endpoints work with any key. The write endpoints require a key on which write access has been enabled; without it they return 403 and nothing is created.
Reference
A first request
Filters combine with logical AND; results are paginated.
$ 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": [ ... ]
}Guarantees
Built to integrate against
- Stable contract
- Fields are only ever added within a version, never removed or renamed, so your integration keeps working.
- Predictable limits
- Each key has clear hourly and daily rate limits, with standard 401, 404 and 429 responses.
- Public data only
- The API exposes public company-registry data, reviewed issuer-call transcripts and published issuer documents only — never private transcripts, expert calls, internal CRM or another account's data.