Übernahme-Radar

REST-API · v1

Alle Daten der Plattform per API

Vollständige REST-API für Distressed-M&A-Daten: Fälle, Tiefen-Recherche, Verwalter-Datenbank, Watchlists, Suchaufträge — und der AI Deal Playbook. JSON-Antworten, Bearer-Auth, Rate-Limits pro Tarif.

Base URL

https://uebernahmeradar.de/api/v1

Version

v1 · OpenAPI 3.1
Interaktive Referenz öffnen →OpenAPI-JSON öffnen

Funktionen

01

RESTful API-Design

02

API-Key-Auth (Bearer-Token)

03

Rate-Limit pro Organisation & Tarif

04

Vollständige Suchparameter

05

Field Selection für kompakte Responses

06

Keyset-Paginierung

07

AI Deal Playbook per Endpoint (Übernahme-Radar-exklusiv)

08

CORS aktiviert

09

Uniform Error-Envelope

Authentifizierung

Alle geschützten Endpoints erwarten einen Bearer-Token im Authorization-Header. API-Keys erstellst du im Dashboard unter Einstellungen → API-Tokens.

GET /api/v1/leads?sinceDays=7&limit=50
Authorization: Bearer ur_live_<your-token>
Accept: application/json

Rate Limiting

Limits richten sich nach deinem Tarif. Ein 429 Too Many Requests wird mit den Headern X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset und Retry-After geliefert.

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1719907200
Retry-After: 300

{ "error": { "code": "rate_limited",
             "message": "Daily quota exhausted." } }

Endpunkte

MethodPathDescription
GET/api/v1/healthÖffentlicher Health-Check (kein API-Key erforderlich).
GET/api/v1/leadsListe aller Insolvenzfälle. Filter: source, band, cat, priceMin/Max, sinceDays. Keyset-Paginierung.
GET/api/v1/leads/{id}Detail eines Falls inkl. Enrichment und Pipeline-State für deine Organisation.
GET/api/v1/leads/{id}/researchTiefen-Recherche zum Fall (Handelsregister-Auszug, Bundesanzeiger, Web-Analyse, Verwalter, Match-Signale).
POST/api/v1/leads/{id}/playbookAI Deal Playbook generieren — personalisierter Aktionsplan für DIESEN Fall + dein Käuferprofil. Body: { profileId?, regenerate?, lang? }.
GET/api/v1/administratorsVerzeichnis aller Insolvenzverwalter im System — Filter: nameLike, city, minCases, plan (paid).
GET/api/v1/administrators/{id}Verwalter-Detail mit Fallhistorie, Spezialisierung und Kontaktdaten (Kontaktdaten ab Standard-Tarif).
GET/api/v1/watchlistsDeine Watchlists.
POST/api/v1/watchlistsWatchlist anlegen. Body: { name }.
POST/api/v1/watchlists/{id}/membersFall zur Watchlist hinzufügen. Body: { announcementId, note? }.
DELETE/api/v1/watchlists/{id}/members/{announcementId}Fall aus Watchlist entfernen.
GET/api/v1/alertsDeine Suchaufträge (Alerts).
POST/api/v1/alertsNeuen Suchauftrag anlegen. Body: { name, query, channels[]? }.
PATCH/api/v1/alerts/{id}Suchauftrag aktualisieren (name, enabled, minBand, channels).
DELETE/api/v1/alerts/{id}Suchauftrag löschen.
GET/api/v1/usageNutzung + Quotas deiner Organisation im aktuellen Monat.

Vollständige Parameter + Antwortschemata in der interaktiven Referenz.

Beispielaufruf

curl

curl https://uebernahmeradar.de/api/v1/leads \
  -H "Authorization: Bearer ur_live_..." \
  -H "Accept: application/json" \
  -G --data-urlencode "sinceDays=7" \
       --data-urlencode "limit=50" \
       --data-urlencode "band=IDEAL"

TypeScript

const res = await fetch(
  "https://uebernahmeradar.de/api/v1/leads/" +
    id + "/playbook",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer ur_live_...",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      lang: "de",
      regenerate: false,
    }),
  },
);
const { playbook } = await res.json();

OpenAPI-Spec + interaktive Referenz

Die vollständige OpenAPI-3.1-Spec ist unter /api/v1/openapi.json abrufbar. Die interaktive Scalar-Referenz mit Try-it-Console erreichst du unter /api/v1/docs.

Interaktive Referenz öffnen →OpenAPI-JSON öffnen

API-Zugang aktivieren

API-Zugriff ist ab dem Pro-Solo-Tarif enthalten. Rate-Limits: Free 0/d · Searcher 100/d · Pro Solo 1.000/d · Boutique 10.000/d · Studio 100.000/d · Enterprise nach Vereinbarung.

Preise ansehenKostenlos starten