Kf Klinforge

Für Marketing-Agenturen und Verzeichnis-Betreiber

Sichtbarkeit als API.

White-Label-Endpoints für Schema.org-Generierung, NAP-Monitoring, GEO-Scoring und AI-Visibility-Tracking. Bauen Sie Ihre Praxis-Tools auf unserer Infrastruktur — DSGVO-konform, in Deutschland gehostet, mit signiertem AVV.

# Schema.org JSON-LD für eine Praxis generieren curl -X POST "https://api.klinforge.de/v1/localiq/profiles/{id}/schema" \ -H "Authorization: Bearer mk_live_..." \ -d '{"schema_type":"MedicalOrganization","include_geo":true}' # 200 OK — validiertes JSON-LD { "schema_type": "MedicalOrganization", "validation_score": 0.96, "jsonld": { "@context": "https://schema.org", "@type": "MedicalOrganization", "name": "Orthopädiezentrum Mitte", "address": { "@type": "PostalAddress", "postalCode": "90402" } } }

Wofür Sie die API nutzen

Drei typische Use-Cases für Agenturen.

White-Label-Dashboard

Bauen Sie eigene Praxis-Sichtbarkeits-Dashboards für Ihre Kunden — mit Klinforge-Daten unter Ihrem Brand. Pricing nach API-Tier (Starter/Pro/Agent).

Bulk-Schema-Generierung

Automatische Erzeugung validierten Schema.org-Markups für hunderte oder tausende Praxis-Profile. JSON-LD-Output direkt einsetzbar im Praxis-CMS.

AI-Citation-Monitoring

Wöchentliche Probes gegen ChatGPT, Perplexity und Claude — über Ihren gesamten Praxis-Bestand. Score-Drop-Webhooks für proaktives Kundenmanagement.

Kern-Endpoints

14 dokumentierte Endpoints.

Vollständige OpenAPI-Spec mit Beispielen unter docs.klinforge.de. Hier die wichtigsten:

POST/v1/localiq/profiles

Praxis-Profil anlegen (Name, NAP, Fachrichtung). Returns UUID + slug.

POST/v1/localiq/profiles/{id}/schema

Schema.org JSON-LD generieren mit Validation-Score.

POST/v1/localiq/profiles/{id}/nap-check

NAP-Konsistenz-Audit über 12 Quellen.

POST/v1/localiq/geo-score

Aggregierter Sichtbarkeits-Score 0,0–1,0.

POST/v1/localiq/profiles/{id}/ai-visibility/ping

AI-Citation-Probe (ChatGPT / Perplexity / Claude).

GET/v1/localiq/profiles/{id}/ai-visibility/report

Aggregierter AI-Citation-Bericht für Zeitraum.

GET/v1/localiq/profiles/{id}/gbp-guidance

Google-Business-Profile-Optimierungs-Checkliste.

POST/v1/localiq/profiles/{id}/webhooks

Score-Drop-Webhooks und Event-Subscriptions.

Technik

Stack & Garantien.

HMAC-SHA256 API-Keys

Mit Pepper gehashed, Pre-/Live-Trennung (mk_test_ / mk_live_), Per-Key-Scopes und Rate-Limits. Keine Plaintext-Speicherung.

DSGVO Art. 32 TOMs

Hosting Hetzner Nürnberg. Verschlüsselung in Transit (TLS 1.3) und at Rest (AES-256). Audit-Log aller Schreib-Operationen. AVV nach Art. 28 verfügbar.

Per-Tier Rate-Limits

Free 500 Req/mo · Starter 10k · Pro 100k · Agent 50k/mo. Burst-Limits dokumentiert. 429 mit Retry-After-Header.

API-Zugang für Agenturen.

Pricing nach Volumen. Persönliches Onboarding inkl. AVV-Bereitstellung und Test-Account vor Vertragsabschluss.