// dev.geolyzer.io

Un'API che restituisce dati reali.

GEOLYZER modella il Suo brand come Knowledge Graph. La REST API è live: persona, fatti e un'Artifacts API discovery-first per llms.txt, JSON-LD, brief e FAQ — pensata per la sincronizzazione con CMS e agenzie. SDK TypeScript e server MCP sono in preparazione.

API e canali Modello dati

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 Sync Artifacts live Hosting in UE Spec OpenAPI Provenance per brief

// per chi

Due destinatari, una piattaforma.

GEOLYZER è per agenzie web che gestiscono progetti clienti e per sviluppatori che vogliono integrare dati GEO nei propri sistemi.

// agenzie & partner

Per agenzie web

Renderizza landing page Persona automaticamente nel tuo CMS
Sincronizza gli artifact tramite la Discovery API — si carica solo ciò che è cambiato
Incorpora JSON-LD direttamente nel tema — WordPress, TYPO3, Webflow
Un aggiornamento nel Knowledge Graph aggiorna tutti gli output contemporaneamente
Opzione white-label disponibile tramite il programma di channel partner

Diventa partner

// sviluppatori & valutatori

Per sviluppatori

REST API live: token auth, spec OpenAPI pubblica, schemi versionati
Artifacts API discovery-first per llms.txt, JSON-LD, brief e FAQ
I brief approvati portano un hash di provenance — nessun rischio allucinazione
Server MCP (Claude, Cursor, n8n) e SDK TypeScript in preparazione — early access su richiesta

Richiedi accesso API

// artifacts · live

Artifact pronti per il sync.

Per le integrazioni CMS e agenzia, l'Artifacts Discovery API è il punto di accesso consigliato. Una singola chiamata al catalogo restituisce ogni tipo di export con metadati di freschezza per lingua — si carica solo ciò che è davvero cambiato.

Sync come una CDN: prima scopri, poi carica solo ciò che è cambiato.

01
Discovery
GET /artifacts restituisce il catalogo — ogni tipo di artifact con updatedAt e hash per lingua.
02
Change detection
Confronta hash o timestamp — ricarica solo gli artifact realmente cambiati.
03
Detail
Chiama esattamente la href restituita dalla discovery, senza costruirla manualmente. ETag/304 supportato.

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 FAQ application/json read:faqs · read:artifacts

// api · live

Endpoint e integrazione.

Tutti gli endpoint restituiscono gli stessi oggetti principali dallo stesso Knowledge Graph. Auth via Bearer token, scoped per progetto. Spec OpenAPI pubblicamente disponibile.

Authorization: Bearer kglz_...

GET /api/v1/projects/{token}/artifacts Punto di accesso consigliato LIVE

Catalogo di discovery: ogni artifact con metadati di freschezza per lingua (hash + timestamp).

GET /api/v1/projects/{token}/artifacts/{type} Punto di accesso consigliato LIVE

Dettaglio artifact — recuperato tramite la href dalla risposta di discovery, non costruito manualmente. Supporta ETag/304.

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

Tutte le buyer persona del progetto — con bussola dei valori, fasi di journey e EEAT-Score.

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

Briefing brand approvato — Markdown, dati strutturati e hash di provenance.

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

Fatti attivi del Knowledge Graph, raggruppati per percorso di nodo.

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

Grafo JSON-LD diretto — percorso legacy. Per il sync partner consigliamo l'Artifacts API.

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

Frammenti tematici con conteggio dei fatti e URL del plugin.

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

Lingue disponibili e configurazione linguistica del progetto.

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

Aggregatore: brief, topics e URL del plugin in un'unica chiamata.

GET /embed.js LIVE

Snippet incorporabile che inietta JSON-LD direttamente nella pagina host.

// modello dati

Cosa restituisce l'API.

Cinque oggetti principali. Tutti dallo stesso Knowledge Graph, tutti con provenance. Niente testo libero, nessun rischio di allucinazione.

01 Facts

Fatti attivi del Knowledge Graph, raggruppati per percorso di nodo.

project
factCount
nodes[]

02 Persona

Buyer persona con bussola dei valori, fasi di journey e EEAT-Score.

archetype
values[]
journey_phases[]
eeat_score

03 Artifact

Oggetto di sync della discovery API — per lingua, con hash e href.

type
name
mediaType
availableLanguages[]
languages[]

04 Brief

Briefing brand approvato con hash di provenance.

language
markdown
structured
provenance
approvedAt

05 Topic

Frammento tematico con conteggio dei fatti.

key
label
factsCount
pluginUrl
markdown

// provenance

Provenance per brief

Ogni brief porta quattro campi. I sistemi integrati sanno sempre su cosa si basa un'approvazione.

kgFactsHash Hash dei fatti KG sottostanti — prova del grounding
approved Booleano · approvato redazionalmente prima di andare live
approvedAt Timestamp ISO-8601 di approvazione
modelVersion Tag di versione del modello di brief

// roadmap · pianificato

Cosa arriva.

Server MCP Early access

Dati brand direttamente in Claude, Cursor e n8n — come tool MCP. Early access su richiesta.

SDK TypeScript Pianificato

Wrapper tipizzato attorno alla REST API. Modelli tipizzati, compatibile Node ed Edge, con helper webhook.

Webhook Pianificato

Eventi per aggiornamenti del modello e cambi negli artifact — per alert e automazione invece del polling.

// accesso

Richiedi accesso API.

Assegniamo l'accesso API per progetto e con aspettative chiare. Sei già partner con un token di progetto? Usalo direttamente — altrimenti una breve conversazione tecnica con chi ha costruito la piattaforma. Nessun pitch commerciale.

Risposta entro 48 ore. Una persona, non un bot.

Richiedi accesso API Vedi panoramica della piattaforma