// 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. Free-Keys erlauben 200 Anfragen/Tag; Pro hebt das auf 20.000. Keys jederzeit im Dashboard verwalten und widerrufen.

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

# 401 if missing / invalid
# 429 if over your daily quota

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_id": "de/hrb/12345",
      "name": "VARTA Microbattery GmbH",
      "region": "Baden-Württemberg",
      "patents_in_field": 67,
      "owner": "Montana Tech Components AG",
      "shareholder_list_available": true
    }
  ]
}

04API-Referenz

GET
/v1/scout

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

GET
/v1/tech-fields

Stichwort → CPC-Technologiefelder auflösen.

GET
/v1/company/{id}

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

GET
/v1/search

Semantische / natürlichsprachliche Suche über den Unternehmensgegenstand.

GET
/v1/stats

Abdeckungs-Statistiken des Datensatzes.

05Rate Limits & Fehler

Limits werden pro Key und Tag durchgesetzt. Bei Überschreitung kommt 429.

  • 200 Erfolg
  • 401 Key fehlt / ungültig
  • 404 Firma nicht gefunden
  • 429 Tageslimit erreicht
HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "detail": "Daily quota reached",
  "plan": "free",
  "limit": 200
}

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_..." }
    }
  }
}