API voor AI-zichtbaarheid
AI-antwoorden als data. Eén API.
Programmatische toegang tot hoe ChatGPT, Google AI-overzicht, Gemini, Perplexity, Claude en 10 andere engines elk merk noemen, rangschikken en citeren. Het is dezelfde dagelijkse data die de GeoGen-app aandrijft.
Maak een workspace-key in de app: Settings → Workspaces → jouw workspace → API Keys.
# Visibility trend for one tracked brand, last 7 days
$ curl "https://api.geogen.io/v1/trends/visibility?entityId=$ENTITY_ID&period=7d" \
-H "Authorization: Bearer $GEOGEN_API_KEY" {
"success": true,
"data": [
{ "date": "2026-10-05", "score": 71.2 },
{ "date": "2026-10-06", "score": 73.9 },
{ "date": "2026-10-07", "score": 78.4 }
]
} import os, requests
r = requests.get(
"https://api.geogen.io/v1/competitors",
params={"entityId": os.environ["ENTITY_ID"]},
headers={"Authorization": f"Bearer {os.environ['GEOGEN_API_KEY']}"},
)
for row in r.json()["data"]:
print(row["rank"], row["name"], row["visibility"]) $ npm install -g @geogenio/cli
$ geogen login
$ geogen competitors --entity $ENTITY_ID --json | jq '.[0]' Wat je kunt opvragen
-
Entiteiten en prompts
Maak en beheer gevolgde merken en de prompts die erop draaien.
- GET/entities
- POST/entities
- PATCH/entities
- GET/entities/check-domain
- GET/entities/prompts
- POST/entities/addprompt
- PATCH/entities/updateprompt
- DELETE/entities/deleteprompt
-
Zichtbaarheid en trends
Dagelijkse trends in zichtbaarheid, sentiment en bronvermeldingen per merk, te filteren op model, tag en prompt.
- GET/trends/visibility
- GET/trends/sentiment
- GET/trends/citations
- GET/entities/tracking-status
-
Antwoorden
Elk AI-antwoord met vermeldingsstatus, plus alle details: vermeldingen, bronvermeldingen en fan-outs.
- GET/responses
- GET/responses/details
-
Bronvermeldingen en fan-outs
De domeinen en URL’s die AI citeert en de webzoekopdrachten die het uitvoerde tijdens het antwoorden.
- GET/entities/citations
- GET/entities/citations/details
- GET/query-fanouts
-
Concurrenten
Het share-of-voice-klassement: zichtbaarheid, vermeldingen, gemiddelde positie en sentiment per merk.
- GET/competitors
-
Acties en workspace
Door AI gegenereerde aanbevelingen, het takenbord, modellen, leden, tags en domeingroepen.
- GET/entities/actions
- POST/entities/actions/update-status
- GET/models
- GET/workspace
- GET/domain-groups
Gebouwd als infrastructuur
De API is in bèta: endpoints kunnen veranderen en wijzigingen worden aangekondigd in de changelog.
- Base URL
- https://api.geogen.io/v1
- Authenticatie
- Workspace-key (wsk_…) via Authorization: Bearer of X-API-Key
- Formaat
- JSON, gepagineerd met total / limit / offset
- Rate limits
- 100 reads / min en 20 writes / min per key; hoger op aanvraag
- Actualiteit
- Elke prompt dagelijks opnieuw uitgevoerd; poll /entities/tracking-status voor nieuwe data
- Specificatie
- OpenAPI 3 op docs.geogen.io/openapi.json
Wat teams erop bouwen
Platforms en hostingproviders
Laat klanten in je controlepaneel of SaaS zien hoe AI-engines hun site zien.
Bureaus
Voed klantdashboards en maandrapporten met zichtbaarheid, bronvermeldingen en concurrenten.
Leveranciers van SEO-tools
Voeg een module voor AI-zichtbaarheid toe zonder zelf een pijplijn voor het scrapen van antwoorden te bouwen.
Data- en BI-teams
Plan pulls naar je datawarehouse en combineer AI-zichtbaarheid met verkeer en omzet.
Veelgestelde vragen
Wat is een API voor AI-zichtbaarheid?
Een API voor AI-zichtbaarheid levert gestructureerde data over hoe AI-assistenten vragen over een markt beantwoorden: welke merken ze noemen, op welke positie en in welke toon, welke bronnen ze citeren en welke zoekopdrachten ze uitvoeren. De GeoGen API biedt dit voor 15 engines, dagelijks ververst.
Welke engines dekt de API?
Dezelfde 15 engines als de app: ChatGPT, Google AI Overviews, Google AI Mode, Gemini, Perplexity, Microsoft Copilot, Mistral, Brave Leo, Claude Haiku uitgelezen zoals gebruikers ze zien, en DeepSeek, MiMo, Grok, Qwen, Claude Sonnet, Claude Opus bevraagd op modelniveau. GET /models toont ze allemaal.
Hoe authenticeer ik?
Maak in de app een workspace-API-key (Settings → Workspaces → jouw workspace → API Keys) en stuur die mee als Authorization: Bearer wsk_… of in de X-API-Key-header. Bewaar keys server-side.
Hoe actueel is de data?
Elke prompt draait elke dag in elke engine van het abonnement. Poll GET /entities/tracking-status om te weten wanneer de laatste check klaar was en wanneer de volgende gepland staat.
Is er een officiële API voor Google AI-overzicht?
Google biedt geen openbare API voor antwoorden uit het AI-overzicht. GeoGen leest AI-overzicht en AI Mode uit zoals gebruikers ze zien en levert de vermeldingen, posities en geciteerde bronnen via de eigen API.
Kan ik de data doorverkopen of in mijn product inbouwen?
Ja, onder een partnerovereenkomst. Platforms en leveranciers van SEO-tools bouwen GeoGen-data in hun producten in; praat met partnerships over volume en voorwaarden voor herdistributie.
Wees het merk dat AI aanbeveelt.
Zie hoe ChatGPT, Google AI-overzicht, Gemini, Perplexity en 9 andere AI-engines over jou praten. Binnen enkele minuten heb je resultaat.