// dev.geolyzer.io

Ett API som levererar riktiga data.

GEOLYZER modellerar ditt varumärke som en Knowledge Graph. REST-API:et är live: personas, fakta och ett discovery-first Artifacts-API för llms.txt, JSON-LD, briefer och FAQ:er — byggt för CMS- och byrå-sync. TypeScript-SDK och MCP-server är under arbete.

API & kanaler Datamodell

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 per brief

// för vem

Två målgrupper, en plattform.

GEOLYZER är för webbyråer som sköter kundprojekt och för utvecklare som vill integrera GEO-data i sina egna system.

// byråer & partner

För webbyråer

Rendera persona-landningssidor automatiskt i ert CMS
Synka artefakter via discovery-API:et — bara det som ändrats hämtas
Bädda in JSON-LD direkt i temat — WordPress, TYPO3, Webflow
En uppdatering i Knowledge Graph uppdaterar alla outputs samtidigt
White label-alternativ tillgängligt via channel partner-programmet

Bli partner

// utvecklare & utvärderare

För utvecklare

REST API live: token-auth, publik OpenAPI-spec, versionerade scheman
Discovery-first Artifacts-API för llms.txt, JSON-LD, briefer och FAQ:er
Godkända briefer bär en provenance-hash — ingen hallucinationsrisk
MCP-server (Claude, Cursor, n8n) och TypeScript-SDK under arbete — early access på förfrågan

Begär API-åtkomst

// artifacts · live

Sync-redo artefakter.

För CMS- och byråintegrationer är Artifacts Discovery-API:et den rekommenderade ingången. Ett enda katalog-anrop returnerar varje export-typ med färskhetsmetadata per språk — du hämtar bara det som faktiskt ändrats.

Synka som en CDN: upptäck först, hämta bara det som ändrats.

01
Discovery
GET /artifacts returnerar katalogen — varje artefakt-typ med updatedAt och hash per språk.
02
Change detection
Jämför hash eller tidsstämpel — hämta bara om de artefakter som faktiskt ändrats.
03
Detalj
Anropa exakt den href som discovery returnerar, konstruera den aldrig själv. ETag/304 stöds.

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

Endpoints & integration.

Alla endpoints returnerar samma kärnobjekt från samma Knowledge Graph. Auth via Bearer-token, scopeat per projekt. OpenAPI-spec publikt tillgänglig.

Authorization: Bearer kglz_...

GET /api/v1/projects/{token}/artifacts Rekommenderad ingång LIVE

Discovery-katalog: varje artefakt med färskhetsmetadata per språk (hash + tidsstämpel).

GET /api/v1/projects/{token}/artifacts/{type} Rekommenderad ingång LIVE

Artefakt-detalj — hämtas via href från discovery-svaret, inte konstruerad manuellt. Stödjer ETag/304.

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

Alla buyer personas för projektet — med värdekompass, journey-faser och EEAT-score.

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

Godkänd varumärkesbrief — Markdown, strukturerade data och provenance-hash.

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

Aktiva Knowledge Graph-fakta, grupperade efter nod-sökväg.

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

JSON-LD-graf direkt — legacy-väg. För partner-sync rekommenderar vi Artifacts-API:et.

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

Ämnesfragment med faktaantal och plugin-URL.

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

Tillgängliga språk och språkkonfiguration för projektet.

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

Aggregator: brief, topics och plugin-URL:er i ett enda anrop.

GET /embed.js LIVE

Inbäddningsbart snippet som injicerar JSON-LD direkt i värdsidan.

// datamodell

Vad API:et returnerar.

Fem kärnobjekt. Alla från samma Knowledge Graph, alla med provenance. Ingen fri text, ingen hallucinationsrisk.

01 Facts

Aktiva Knowledge Graph-fakta, grupperade efter nod-sökväg.

project
factCount
nodes[]

02 Persona

Buyer persona med värdekompass, journey-faser och EEAT-score.

archetype
values[]
journey_phases[]
eeat_score

03 Artifact

Sync-objekt från discovery-API:et — per språk med hash och href.

type
name
mediaType
availableLanguages[]
languages[]

04 Brief

Godkänd varumärkesbrief med provenance-hash.

language
markdown
structured
provenance
approvedAt

05 Topic

Ämnesfragment med faktaantal.

key
label
factsCount
pluginUrl
markdown

// provenance

Provenance per brief

Varje brief bär fyra fält. Integrerade system vet alltid vad ett godkännande bygger på.

kgFactsHash Hash av de underliggande KG-fakta — bevis på grounding
approved Boolean · redaktionellt godkänd innan den går live
approvedAt ISO-8601 godkännande-tidsstämpel
modelVersion Versionstagg för brief-modellen

// roadmap · planerat

Vad som kommer härnäst.

MCP-server Early access

Varumärkesdata direkt i Claude, Cursor och n8n — som ett MCP-verktyg. Early access på förfrågan.

TypeScript SDK Planerat

Typad wrapper runt REST-API:et. Typade modeller, Node- och Edge-kompatibel, med webhook-hjälpare.

Webhooks Planerat

Events vid modelluppdateringar och artefaktändringar — för alerts och automatisering i stället för polling.

// åtkomst

Begär API-åtkomst.

Vi tilldelar API-åtkomst per projekt och med tydliga förväntningar. Redan partner med ett projekt-token? Använd det direkt — annars ett kort tekniskt samtal med någon som byggt plattformen. Ingen säljpitch.

Svar inom 48 timmar. Människa, inte bot.

Begär API-åtkomst Se plattformsöversikt