Entwickler
Daten-API
Die INSIGHTEX-Daten-API liefert öffentliche Unternehmensprofile mit dokumentierten Indikatoren, damit Ihre eigenen Tools dieselben Daten lesen können, die Sie im Verzeichnis sehen.
Indikatoren fassen öffentlich beobachtete Signale mit festen, dokumentierten Formeln zusammen. Sie sind keine Prognosen, Ratings oder Anlageberatung.
Wer sie nutzen kann
Die Daten-API und Massenexporte sind in Enterprise-Workspaces enthalten.
Authentifizierung
Erstellen Sie auf Ihrer Seite „Daten-API“ ein Token und senden Sie es im Authorization-Header als Bearer-Token oder im X-Api-Key-Header. Eine angemeldete Browsersitzung funktioniert ebenfalls.
Setzen Sie ein Token nie in eine URL. Anfragen mit einem Token im Query-String werden abgelehnt.
Beispielanfrage
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://www.insightex.si/api/v1/data/organizations?limit=50&country=US&updated_since=2026-01-01"Endpunkte
GET /api/v1/data/organizations- Liefert eine Seite mit Organisationen als JSON oder CSV.
GET /api/v1/data/organizations/export- Liefert alle passenden Organisationen als eine gestreamte CSV- oder JSON-Datei.
Parameter
| Parameter | Beschreibung |
|---|---|
limit | Zeilen pro Seite, von 1 bis 100. Standard ist 50. |
cursor | Der Wert von meta.next_cursor aus der vorherigen Seite. Für die erste Seite weglassen. |
country | Zweibuchstabige Ländercodes (ISO 3166-1 alpha-2), durch Kommas getrennt, bis zu 20. |
sector | Branchen-Slugs, durch Kommas getrennt, bis zu 20. |
q | Der Name der Organisation enthält diesen Text (2 bis 100 Zeichen, ohne Beachtung der Groß- und Kleinschreibung). |
updated_since | Ein Datum oder Zeitpunkt nach ISO 8601. Liefert Organisationen, deren Profil, Signale, Finanzierungsrunden oder Kennzahlen sich seitdem geändert haben. |
format | json (Standard) oder csv. |
Paginierung
Die Ergebnisse sind nach Organisations-ID sortiert. Folgen Sie meta.next_cursor oder links.next, bis der Wert null ist. Keine Organisation erscheint doppelt.
Antwortfelder
organization- Name, Slug, Typ, Website, Profillink, Branchen und Länder.
indicators- funding_activity, team_growth, product_launch_cadence und signal_score_30d. Jeder Indikator hat einen Score, eine Konfidenz, eine Methoden-ID, eine Begründung und seine Belege.
preference_match- Wie weit sich die Organisation mit den Branchen- und Marktpräferenzen Ihres eigenen Workspaces überschneidet.
updated_at- Wann sich das Organisationsprofil zuletzt geändert hat.
Methoden der Indikatoren
Jeder Indikator nutzt eine feste Formel. Gibt es keine Belege, sind Score und Konfidenz null statt geschätzt.
funding_activity.v1- Datierte Finanzierungsrunden der letzten 365 Tage und Finanzierungssignale der letzten 180 Tage. Score = min(95, 20 + 5 × Summe der Signal-Scores + 12 × Runden). Runden ohne Datum zählen nie.
team_growth.v1- Die annualisierte Veränderung zwischen der ersten und letzten datierten Mitarbeiterzahl. Rate = ((letzte − erste) ÷ erste) × 365 ÷ Tage dazwischen; Score = 50 + 25 × Rate, begrenzt auf 5 bis 95. Null bei weniger als zwei Werten, einem ersten Wert von null oder einem Zeitraum unter 30 Tagen.
product_launch_cadence.v1- Launch- und Release-Signale der letzten 90 Tage. Score = min(95, 20 + 14 × Signale + 3 × Summe der Signal-Scores). Null, wenn es keine gibt.
signal_score_30d- Die Summe aller Signal-Scores der letzten 30 Tage.
preference_match.v1- Der Anteil Ihrer gesetzten Branchen- und Länderpräferenzen, die zur Organisation passen: 0, 50 oder 100. Null, wenn Sie keine gesetzt haben.
Indikatoren fassen öffentlich beobachtete Signale mit festen, dokumentierten Formeln zusammen. Sie sind keine Prognosen, Ratings oder Anlageberatung.
Ratenlimits
120 Anfragen pro Minute und Mitglied, unabhängig von der Zahl der Tokens, und 10 vollständige Exporte pro Stunde. Antworten enthalten die Header X-RateLimit-Limit und X-RateLimit-Remaining.
Fehler
400: Ein Token wurde in der URL gesendet. 401: Das Token fehlt, ist ungültig, abgelaufen oder widerrufen. 402: Der Workspace enthält die Daten-API nicht. 403: Das Token darf diesen Endpunkt nicht nutzen. 422: Ein Parameter ist ungültig. 429: Zu viele Anfragen; warten Sie die Retry-After-Zeit ab.
Versionierung
Jede Antwort enthält den Header X-Insightex-Api-Version. Ändert sich eine Formel, ändert sich auch ihre Methoden-ID, zum Beispiel von .v1 zu .v2. Der ältere Endpunkt /api/data-products/organizations bleibt aus Kompatibilitätsgründen erhalten.