// dev.geolyzer.io

Eine API, die echte Daten liefert.

GEOLYZER modelliert Ihre Marke als Knowledge Graph. Die REST-API ist live: Personas, Fakten und eine Discovery-first Artifacts-API für llms.txt, JSON-LD, Brief und FAQs — gebaut für CMS- und Agentur-Sync. TypeScript-SDK und MCP-Server sind in Vorbereitung.

API & Kanäle Datenmodell

GET /api/v1/projects/{token}/personas


                  // Persona · The Decision Maker · full profile{  "id": "decision-maker-01",  "archetype": "The Decision Maker",  "segment": "B2B · Senior Management",  "confidence": 0.94,  "values": [    "Reliability over speed",    "Evidence before commitment",    "Clear ROI accountability"  ],  "pain_points": [    "Too many vendors — no clear differentiator",    "AI gives generic answers, not local market data"  ],  "geo_profile": {    "mention_rate": 0.31,    "citation_rate": 0.09,    "avg_position": 2.4,    "engines": ["chatgpt", "perplexity"]  },  "journey_phases": [    { "phase": "research",  "prompt": "Best tax advisors Vienna for self-employed?" },    { "phase": "compare",  "prompt": "What sets Mustermann apart from competitors?" },    { "phase": "decide",   "prompt": "Mustermann GmbH reviews and credentials" }  ],  "eeat_score": 78,  "source_evidence": [{    "source": "reviews/2024-q4",    "confidence": 0.91,    "version": "1.3.0",    "approved_at": "2026-06-15T09:41Z"  }]}


                  // Artifacts Discovery · catalog for partner sync{  "generator": "geolyzer",  "project": { "name": "Mustermann GmbH", "primaryLanguage": "de" },  "updatedAt": "2026-07-08T23:00:00Z",  "artifacts": [    {      "type": "jsonld",      "name": "Brand Schema (JSON-LD)",      "available": true,      "availableLanguages": ["de", "en"],      "languages": [{        "lang": "de",        "updatedAt": "2026-06-15T09:41Z",        "hash": "a1b2c3...",        "href": "/artifacts/jsonld?lang=de"      }]    },    { "type": "faqs", "name": "FAQs", "available": true }  ]}


                  // FAQ artifact · fetched via href from discovery{  "faqs": [    {      "question": "Which tax advisors are available in Vienna?",      "answer": "For freelancers and self-employed, key options include...",      "class": "non_brand",      "journey_phase": "research"    },    {      "question": "What sets Mustermann apart from competitors?",      "answer": "Mustermann GmbH combines local track record with...",      "class": "brand_mention",      "journey_phase": "compare"    }  ]}


                  // JSON-LD · Schema.org FAQPage + Organization{  "@context": "https://schema.org",  "@type": "FAQPage",  "about": { "@type": "Organization", "name": "Mustermann GmbH" },  "mainEntity": [{    "@type": "Question",    "name": "Which tax advisors are available in Vienna?",    "acceptedAnswer": {      "@type": "Answer",      "text": "For freelancers in Vienna, key options include...",      "_provenance": {        "source": "kg/brand-entities",        "confidence": 0.88,        "approved_at": "2026-06-15T09:41Z"      }    }  }]}


                  // Knowledge Graph facts · grouped by node path{  "project": { "name": "Mustermann GmbH" },  "factCount": 142,  "nodes": [    { "path": "organization.identity", "facts": ["Mustermann GmbH", "Vienna, Austria"] },    { "path": "organization.services", "facts": ["Tax Advisory", "Payroll"] },    { "path": "trust_signals", "facts": ["impressum", "https", "certifications"] }  ]}

REST-API live Artifacts-Sync live EU-Hosting OpenAPI-Spec Provenance pro Freigabe

// für wen

Zwei Zielgruppen, eine Plattform.

GEOLYZER ist für Web-Agenturen, die Kundenprojekte betreuen, und für Entwickler, die GEO-Daten in eigene Systeme integrieren wollen.

// agenturen & partner

Für Web-Agenturen

Persona-Landingpages automatisch in eurem CMS rendern
Artefakte per Discovery-API synchronisieren — nur was sich geändert hat, wird geladen
JSON-LD direkt ins Theme einbinden — WordPress, TYPO3, Webflow
Ein Update im Knowledge Graph aktualisiert alle Outputs gleichzeitig
White-Label-Option über Channel-Partner-Programm verfügbar

Partner werden

// entwickler & evaluatoren

Für Entwickler

REST-API live: Token-Auth, öffentliche OpenAPI-Spec, versionierte Schemas
Discovery-first Artifacts-API für llms.txt, JSON-LD, Brief und FAQs
Freigegebene Briefs mit Provenance-Hash — kein Halluzinationsrisiko
MCP-Server (Claude, Cursor, n8n) und TypeScript-SDK in Vorbereitung — Early Access auf Anfrage

API-Zugang anfragen

// artifacts · live

Artefakte, gebaut für Sync.

Für CMS- und Agentur-Integrationen ist die Artifacts-Discovery-API der empfohlene Einstieg. Ein Katalog-Call liefert alle Export-Typen mit Frische-Metadaten pro Sprache — geladen wird nur, was sich wirklich geändert hat.

Sync wie ein CDN: erst entdecken, dann nur laden, was sich geändert hat.

01
Discovery
GET /artifacts liefert den Katalog — jeder Artefakt-Typ mit updatedAt und hash pro Sprache.
02
Change Detection
Hash oder Zeitstempel vergleichen — nur geänderte Artefakte erneut abrufen.
03
Detail
Exakt die href aus der Discovery-Antwort aufrufen, nicht selbst zusammenbauen. ETag/304 unterstützt.

GET /api/v1/projects/{token}/artifacts

GET https://app.geolyzer.io/api/v1/projects/{token}/artifacts
Authorization: Bearer kglz_...

llms_txt llms.txt text/markdown read:artifacts

llms_full_txt llms-full.txt text/markdown read:artifacts

brief Agent Brief text/markdown read:brief · read:artifacts

jsonld Brand Schema (JSON-LD) application/ld+json read:jsonld · read:artifacts

faqs FAQs application/json read:faqs · read:artifacts

// api · live

Endpunkte & Integration.

Alle Endpunkte liefern dieselben Kernobjekte aus demselben Knowledge Graph. Auth über Bearer-Token, pro Projekt gescopet. OpenAPI-Spec öffentlich einsehbar.

Authorization: Bearer kglz_...

GET /api/v1/projects/{token}/artifacts Empfohlener Einstieg LIVE

Discovery-Katalog: alle Artefakte mit Sprachen, Hash und Frische-Zeitstempel pro Sprache.

GET /api/v1/projects/{token}/artifacts/{type} Empfohlener Einstieg LIVE

Artefakt-Detail — abgerufen über die href aus der Discovery-Antwort, nicht selbst gebaut. Unterstützt ETag/304.

GET /api/v1/projects/{token}/personas LIVE

Alle Buyer Personas des Projekts — mit Wertekompass, Journey-Phasen und EEAT-Score.

GET /api/v1/projects/{token}/brief LIVE

Freigegebenes Markenbriefing — Markdown, strukturierte Daten und Provenance-Hash.

GET /api/v1/projects/{token}/facts LIVE

Aktive Knowledge-Graph-Fakten, gruppiert nach Node-Pfad.

GET /api/v1/projects/{token}/jsonld LIVE

JSON-LD-Graph direkt — Legacy-Pfad. Für Partner-Sync empfehlen wir die Artifacts-API.

GET /api/v1/projects/{token}/topics LIVE

Themen-Fragmente mit Fakten-Anzahl und Plugin-URL.

GET /api/v1/projects/{token}/languages LIVE

Verfügbare Sprachen und Sprachkonfiguration des Projekts.

GET /api/v1/projects/{token}/codes LIVE

Aggregator: Brief, Topics und Plugin-URLs in einem Call.

GET /embed.js LIVE

Einbettbares Snippet, das JSON-LD direkt in die Host-Seite injiziert.

// datenmodell

Was die API zurückgibt.

Fünf Kernobjekte. Alle aus demselben Knowledge Graph, alle mit Provenance. Kein freier Text, kein Halluzinationsrisiko.

01 Facts

Aktive Knowledge-Graph-Fakten, gruppiert nach Node-Pfad.

project
factCount
nodes[]

02 Persona

Buyer Persona mit Wertekompass, Journey-Phasen und EEAT-Score.

archetype
values[]
journey_phases[]
eeat_score

03 Artifact

Sync-Objekt der Discovery-API — pro Sprache mit Hash und Href.

type
name
mediaType
availableLanguages[]
languages[]

04 Brief

Freigegebenes Markenbriefing mit Provenance-Hash.

language
markdown
structured
provenance
approvedAt

05 Topic

Themen-Fragment mit Fakten-Anzahl.

key
label
factsCount
pluginUrl
markdown

// provenance

Provenance pro Freigabe

Jeder Brief trägt vier Felder. So weiß jedes integrierte System, worauf die Freigabe beruht.

kgFactsHash Hash der zugrunde liegenden KG-Fakten — Beleg für Grounding
approved Boolean · redaktionell freigegeben, bevor er live geht
approvedAt ISO-8601 Freigabe-Timestamp
modelVersion Versions-Tag des Brief-Modells

// roadmap · geplant

Was kommt.

MCP-Server Early Access

Markendaten direkt in Claude, Cursor und n8n — als MCP-Tool. Early Access auf Anfrage.

TypeScript SDK Geplant

Typisierter Wrapper um die REST-API. Typed Models, Node- und Edge-kompatibel, mit Webhook-Helfern.

Webhooks Geplant

Events bei Modell-Updates und Artefakt-Änderungen — für Alerts und Automatisierung statt Polling.

// zugang

API-Zugang anfragen.

Wir vergeben API-Zugang projektweise und mit klaren Erwartungen. Haben Sie als Partner bereits ein Projekt-Token, nutzen Sie es direkt — sonst ein kurzes technisches Gespräch mit jemandem, der die Plattform gebaut hat. Kein Sales-Pitch.

Antwort innerhalb von 48 Stunden. Mensch, kein Bot.

API-Zugang anfragen Plattform-Übersicht ansehen