Developer API & Webhooks

Koppel GeoEngine aan je eigen tools: haal je gemeten data op, lees het schema of llms.txt van je website, en laat je CMS nieuwe pagina's automatisch aanmelden.

Basis-URL: https://geoengine.tech

Authenticatie

Beveiligde endpoints verwachten je persoonlijke API-sleutel in de Authorization-header. De sleutel geeft enkel toegang tot je eigen account. Deel hem nooit publiek of in browsercode.

Authorization: Bearer <token>

Jouw API-sleutel

your_api_key_here

Dit is een voorbeeldsleutel. Maak een account aan en genereer je eigen beveiligde sleutel in Integraties. API-toegang is inbegrepen bij Pro en Enterprise.

Data-export (Looker Studio, Power BI & Google Sheets)

GET/api/public/looker/export

Geeft je gemeten paginadata terug: AI Content-Scores, schema-status en sitemap-synchronisatie per website. Ideaal voor Looker Studio of een eigen rapport.

format	json \| csv	Standaard json. csv geeft een downloadbaar bestand.
site	own \| uuid	Optioneel: beperk tot je eigen site of één klantwebsite.

curl "https://geoengine.tech/api/public/looker/export?format=csv" \
  -H "Authorization: Bearer your_api_key_here"

Schema ophalen (JSON-LD)

GET/api/public/payload/{tag_id}?url=…

Geeft het gevalideerde JSON-LD-schema voor één pagina van je website. Dit is dezelfde bron die de GeoEngine-tag gebruikt, dus geen sleutel nodig. Zonder actief plan of gekende pagina krijg je {"jsonld": null}.

tag_id	uuid	De tag-ID van je website, te vinden in je dashboard.
url	string	Volledige pagina-URL op je eigen domein.

curl "https://geoengine.tech/api/public/payload/YOUR_TAG_ID?url=https://example.com/page"

llms.txt

GET/api/public/llms/{tag_id}.txt

Levert je actuele llms.txt, live opgebouwd uit je kennisbank, bedrijfsprofiel en pagina's (60 seconden cache). Beschikbaar op Pro en Enterprise.

curl "https://geoengine.tech/api/public/llms/YOUR_TAG_ID.txt"

Webhook: nieuwe pagina melden

POST/api/public/v1/ping

Laat je CMS (WordPress, Drupal, …) GeoEngine verwittigen zodra een pagina gepubliceerd of bijgewerkt is. De pagina wordt in de wachtrij gezet en op de achtergrond verwerkt. Kost geen AI-credits; telt mee voor je paginalimiet.

url

string

Verplicht. Moet op een van je eigen websites staan.

Antwoord: 202 {"ok": true, "status": "queued"}

curl -X POST "https://geoengine.tech/api/public/v1/ping" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/new-article"}'

Webflow-integratiegids

Twee stappen, geen programmeerwerk nodig: stap 1 maakt je website leesbaar voor AI, stap 2 laat GeoEngine je site opnieuw controleren telkens je publiceert.

1Tag plaatsen (Head Code)

Kopieer je eigen GeoEngine-tag uit je dashboard. Hieronder staat alleen een voorbeeld.
Open in Webflow Project Settings → Custom Code.
Plak de tag in het veld Head Code en klik op Save Changes.
Klik op Publish. Controleer daarna de installatie in je dashboard.

<script src="https://geoengine.tech/api/public/tag/YOUR_TAG_ID" async></script>

2Automatisch bijwerken bij publiceren

Maak in je dashboard bij Integraties een API-sleutel aan.
Open in Webflow Site Settings → Apps & Integrations → Webhooks en klik op Add Webhook.
Kies als trigger Site Publish.
Plak dit adres in het veld Destination URL en klik op Save:

https://geoengine.tech/api/public/v1/ping?token=your_api_key_here

Je sleutel zit in dit adres: deel het met niemand, net als een wachtwoord. Telkens je in Webflow publiceert, controleert GeoEngine je pagina's opnieuw. Dit kost geen AI-credits.

Data-export (Looker Studio, Power BI & Google Sheets)

Gebruik deze beveiligde feed om je GeoEngine-data rechtstreeks in je eigen dashboards of in Google Sheets te laden (Looker Studio, Power BI, Google Sheets). Je hebt alleen je sleutel en de export-link hierboven nodig.

Foutcodes

400	Bad Request	Ongeldige parameters of body.
401	Unauthorized	Ontbrekende of ongeldige sleutel.
403	Forbidden	Pro/Enterprise vereist of website gepauzeerd.
404	Not Found	Website of URL hoort niet bij je account.
409	Conflict	Paginalimiet bereikt.