// docs · v0.1

Bau mit Owndex.

Eine REST-API über deutsche Firmen-, Patent- und Eigentümer-Intelligence. JSON rein, JSON raus, ein Header zur Authentifizierung. Funktioniert auch hervorragend als MCP-Server für KI-Agenten.

01Schnellstart

  1. Account im Dashboard anlegen — du bekommst sofort einen Key.
  2. Sende deinen Key im X-API-Key Header.
  3. Rufe /v1/scout?q=... auf und leg los.
export OWNDEX_KEY="od_live_..."

curl "https://api.owndex.de/v1/scout?q=battery" \
  -H "X-API-Key: $OWNDEX_KEY"

02Authentifizierung

Jede Datenanfrage braucht einen X-API-Key Header. Calls ziehen Credits aus deinem konto-weiten Pool (Free 200/Tag, Pro 100.000/Monat). Pro Key lassen sich zusätzlich Tageslimits und Ablaufdaten setzen. Keys jederzeit im Dashboard verwalten und widerrufen.

# header on every request
X-API-Key: od_live_xxxxxxxxxxxxxxxxxxxx

# 401 if missing / invalid
# 429 if the account credit pool is exhausted

03Beispiele

Scoute Firmen nach Technologiefeld in drei Sprachen. Antwort rechts.

curl "https://api.owndex.de/v1/scout?q=battery&private=true" \
  -H "X-API-Key: $OWNDEX_KEY"
// antwort · 200 OK
{
  "query": "battery",
  "matched_fields": [
    { "cpc": "H01M", "title": "Batteries, fuel cells" }
  ],
  "results": [
    {
      "company_number": "M1203_HRB4649",
      "name": "VARTA Microbattery GmbH",
      "region": "Baden-Württemberg",
      "patents_in_field": 67,
      "total_patents": 112,
      "owner": "Montana Tech Components AG",
      "shareholder_list_available": true
    }
  ]
}

04API-Referenz

Jeder Call zieht Credits aus dem konto-weiten Pool. Free: 200 Credits/Tag · Pro: 100.000/Monat. Die Spalte rechts zeigt die Credits pro Call.

GET
/v1/scout

Firmen nach Tech-Feld finden. Parameter: q, region, private, limit.

3 Cr.
GET
/v1/tech-fields

Stichwort → CPC-Technologiefelder auflösen.

1 Cr.
GET
/v1/companies

Firmen nach Namen suchen. Parameter: q, limit.

1 Cr.
GET
/v1/officers

Organe (Geschäftsführer u. a.) nach Namen suchen.

1 Cr.
GET
/v1/officer

Personen-Profil: Positionen über alle Firmen. Parameter: name.

1 Cr.
GET
/v1/company/{id}

Vollprofil: Organe, Tech-Felder, Patente, Eigentum, Frische.

1 Cr.
GET
/v1/search

Semantische / natürlichsprachliche Suche über den Unternehmensgegenstand.

5 Cr.
GET
/v1/stats

Abdeckungs-Statistiken des Datensatzes.

1 Cr.
GET
/account

Kontostand: Credits, Plan, Keys.

frei

05Rate Limits & Fehler

Credits werden konto-weit über den Plan-Pool abgerechnet (plus optionale Tageslimits pro Key). Ist der Pool leer, kommt 429.

  • 200 Erfolg
  • 401 Key fehlt / ungültig / abgelaufen
  • 404 Firma nicht gefunden
  • 429 Credit-Pool erschöpft
HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "detail": "Account credit pool exhausted
             (200/200 used). Upgrade or wait
             for reset."
}

06MCP-Server

Owndex liefert einen MCP-Server, damit Claude und andere Agenten Firmen scouten, Eigentum auflösen und semantisch suchen — als native Tools. Auf deinen Key zeigen lassen:

Tools: scout_companies, company_profile, semantic_search, tech_fields, dataset_stats.

// claude_desktop_config.json
{
  "mcpServers": {
    "owndex": {
      "command": "python",
      "args": ["product/mcp/server.py"],
      "env": { "OWNDEX_API_KEY": "od_live_..." }
    }
  }
}