Udviklere
BusinessVeno-API og MCP
Læs din AI-synlighed, AI-svar, Google-placeringer, kilder og besøg fra AI-bots i dine egne værktøjer: med REST-API'et, i ChatGPT eller Claude via MCP eller i Looker Studio.
API og MCP følger med Strategist (2.000 API- og 2.000 MCP-forespørgsler om måneden) og Sentinel (5.000 af hver). API-nøgler kan kun læse, bortset fra at sende besøg fra AI-bots; en AI-assistent, du forbinder ved at logge ind, kan også tilføje spørgsmål, søgeord og konkurrenter, når du beder om det.
Kom i gang
- Opret en API-nøgle i BusinessVeno under Indstillinger › API & MCP (administratorer). Den vises kun én gang - hold den hemmelig: alle med nøglen kan læse dine data.
- Send den med hver forespørgsel som headeren Authorization: Bearer efterfulgt af nøglen.
- Hent dine websites: hvert har et id, som du bruger i de andre adresser.
- Grundadresse
https://api.businessveno.com/api/public/v1- Dit første kald
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites"
Endpoints
Forespørgsler svarer med JSON. days er, hvor langt tilbage der kigges, fra 1 og op til dit abonnements historik (Strategist 365, Sentinel 1.095). Hver GET-forespørgsel tæller som én API-forespørgsel.
GET /websites
Dine websites med det id, som de andre adresser bruger.
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites"- Svar (forkortet)
[{ "id": "3f2b8c1e-0000-4000-8000-000000000001", "domain": "example.dk", "name": "Example", "websiteUrl": "https://example.dk/" }]
GET /websites/{id}/visibility
AI-synlighed pr. dag: score 0-100, hvor ofte AI-assistenter nævner og anbefaler dig, din gennemsnitlige placering og hvor mange svar der blev læst.
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/visibility?days=90"- Svar (forkortet)
{ "websiteId": "3f2b8c1e-0000-4000-8000-000000000001", "history": [{ "date": "2026-10-31", "score": 42, "mentionRate": 0.5, "recommendationRate": 0.2, "averagePosition": 2.4, "answers": 30 }] }
GET /websites/{id}/answers
AI-svarene på dine overvågede spørgsmål: assistent, spørgsmål, om du blev nævnt eller anbefalet, placering og de links, den henviste til. engine viser kun én assistent: chatgpt, google-ai-overview, google-ai-mode, perplexity-web eller gemini-web, eller nøglen for et AI-tilkøb, du har. Højst de 2.000 nyeste svar.
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/answers?days=30&engine=chatgpt"- Svar (forkortet)
[{ "date": "2026-10-31", "engine": "chatgpt", "question": "best bakery in Aarhus", "mentioned": true, "recommended": false, "position": 3, "citations": ["https://example.dk/"] }]
GET /websites/{id}/rankings
Dine overvågede søgeords seneste Google-placeringer. En tom placering betyder ikke fundet.
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/rankings"- Svar (forkortet)
[{ "keyword": "bakery aarhus", "position": 4, "url": "https://example.dk/", "checkedAt": "2026-10-31T06:12:00Z" }]
GET /websites/{id}/citations
De websites, AI-assistenter oftest henviser til i svar på dine spørgsmål (top 100).
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/citations?days=30"- Svar (forkortet)
[{ "domain": "tripadvisor.com", "count": 12 }]
GET /websites/{id}/agent-visits
Besøg fra AI-bots på dit website pr. bot, pr. dag og pr. side, og personer, der kom fra et AI-svar. Data kommer, når besøgene bliver indsamlet: med Cloudflare-workeren, WordPress-pluginet, Vercel-koden, en upload af log eller agent-events herunder.
- Eksempel
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/agent-visits?days=30"- Svar (forkortet)
{ "totals": [{ "bot": "GPTBot", "visits": 120 }], "daily": [{ "date": "2026-10-31", "bot": "GPTBot", "visits": 4 }], "topPages": [{ "path": "/menu", "visits": 30 }], "visitors": [], "landingPages": [] }
POST /agent-events
Send besøg fra AI-bots fra din egen server. website er dit websites adresse i BusinessVeno eller et af dets underdomæner (blog.example.com tæller som example.com); events er op til 500 besøg, hver med userAgent, path, status, timestamp og, hvis du har dem, referrer og ip. Vi gemmer kun AI-bots og personer, der kom fra et AI-svar, sorterer bots fra, hvis ip ikke tilhører deres ejer, og gemmer aldrig ip. Et timestamp ældre end 7 dage bliver sat til nu. Hvert gemt besøg tæller med i dine månedlige besøg fra AI-bots (Strategist 200.000, Sentinel 1.000.000), ikke i dine API-forespørgsler; hver nøgle kan sende op til 1.200 forespørgsler i minuttet. Et ukendt website eller mere end 500 events giver 400 (common.invalid_request).
- Eksempel
curl -X POST -H "Authorization: Bearer bv_your_key" -H "Content-Type: application/json" -d '{ "website": "https://example.dk", "events": [{ "userAgent": "Mozilla/5.0 (compatible; GPTBot/1.2)", "path": "/menu", "status": 200, "timestamp": "2026-10-31T06:12:00Z" }] }' "https://api.businessveno.com/api/public/v1/agent-events"- Svar (forkortet)
{ "accepted": 1, "ignored": 0 }
Fejl og grænser
Fejl svarer med JSON med error (en sætning, du kan vise) og code (fast, til din kode).
| Status | Kode | Hvad det betyder |
|---|---|---|
| 401 | api.invalid_key | Nøglen mangler, er forkert eller tilbagekaldt. |
| 402 | plan.feature_not_included | Dit abonnement indeholder ikke API'et. |
| 402 | plan.limit_reached | Månedens forespørgsler er brugt. |
| 404 | common.not_found | Intet website med det id for denne nøgle. |
| 429 | common.too_many_requests | Mere end 60 forespørgsler på et minut: vent og prøv igen. |
- 60 forespørgsler i minuttet pr. nøgle, API og MCP tilsammen. Hvert svar har headerne X-RateLimit-Limit og X-RateLimit-Remaining; over grænsen er svaret 429 med en Retry-After-header: vent så mange sekunder.
- Strategist har 2.000 API-forespørgsler og 2.000 MCP-forespørgsler om måneden, Sentinel 5.000 af hver - se priserne. Forespørgsler tælles fra den første i måneden.
MCP til ChatGPT og Claude
Med MCP kan en AI-assistent læse dine data og svare på spørgsmål som "Hvordan går det med vores AI-synlighed i denne måned?". Hvert værktøjskald tæller som én MCP-forespørgsel.
- MCP-serverens adresse
https://api.businessveno.com/api/public/v1/mcp
- ChatGPT: under Indstillinger › Connectors tilføjer du en egen connector med MCP-serverens adresse (kræver et ChatGPT-abonnement med egne connectors). Log ind på BusinessVeno, når du bliver bedt om det, og vælg, hvilke virksomheder den må læse - én forbindelse kan dække alle dine kunder.
- Claude: under Indstillinger › Connectors tilføjer du en egen connector med MCP-serverens adresse, logger ind på BusinessVeno og vælger virksomhederne.
- Værktøjer, der bruger en header i stedet for at logge ind (Claude Code, mcp-remote): brug en API-nøgle som Authorization-header, som herunder.
- Claude Code
claude mcp add --transport http businessveno https://api.businessveno.com/api/public/v1/mcp --header "Authorization: Bearer bv_your_key"- Værktøjer
list_websites, get_ai_visibility, list_ai_answers, get_google_rankings, get_citations, get_ai_bot_visits, get_overview, list_recommendations, list_alerts, list_topics, list_competitors, why_them_not_me, list_opportunities, list_competitor_changes, get_website_issues, get_ai_accuracy, get_visibility_guard, get_ai_overviews, add_questions, add_keywords, add_competitor
Looker Studio
- Opret en API-nøgle under Indstillinger › API & MCP, og kopier den.
- Åbn BusinessVeno-connectoren i Looker Studio (ny fane)
- Klik på Authorize, og indsæt din nøgle.
- Vælg dit website og dataene (synlighed, AI-svar, Google-placeringer, kilder eller besøg fra AI-bots), og klik på Connect. Hver gang et diagram henter sine data, tæller det som én API-forespørgsel.