Developers

The BusinessVeno API and MCP

Read your AI visibility, AI answers, Google rankings, cited sources and AI-bot visits in your own tools: with the REST API, in ChatGPT or Claude through MCP, or in Looker Studio.

The API and MCP come with Strategist (2,000 API and 2,000 MCP requests a month) and Sentinel (5,000 of each). API keys only read, apart from sending AI-bot visits; an AI assistant you connect by signing in can also add questions, keywords and competitors when you ask it to.

Get started

  1. Create an API key in BusinessVeno under Settings › API & MCP (admins). It's shown once - keep it secret: anyone with it can read your data.
  2. Send it with every request as the header Authorization: Bearer followed by the key.
  3. Ask for your websites: each has an id you use in the other addresses.
Base address
https://api.businessveno.com/api/public/v1
Your first call
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites"

Endpoints

Requests answer JSON. days is how far back to look, from 1 up to your plan's history (Strategist 365, Sentinel 1,095). Each GET request counts as one API request.

GET /websites

Your websites, with the id the other addresses use.

Example
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites"
Answer (shortened)
[{ "id": "3f2b8c1e-0000-4000-8000-000000000001", "domain": "example.dk", "name": "Example", "websiteUrl": "https://example.dk/" }]

GET /websites/{id}/visibility

AI visibility by day: score 0-100, how often AI assistants mention and recommend you, your average position and how many answers were read.

Example
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/visibility?days=90"
Answer (shortened)
{ "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

The AI answers to your tracked questions: assistant, question, whether you were mentioned or recommended, position and the links it cited. engine shows one assistant only: chatgpt, google-ai-overview, google-ai-mode, perplexity-web or gemini-web, or the key of an AI engine add-on you have. At most the 2,000 newest answers.

Example
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"
Answer (shortened)
[{ "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

Your tracked keywords' latest Google positions. An empty position means not found.

Example
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/rankings"
Answer (shortened)
[{ "keyword": "bakery aarhus", "position": 4, "url": "https://example.dk/", "checkedAt": "2026-10-31T06:12:00Z" }]

GET /websites/{id}/citations

The websites AI assistants cite most in answers to your questions (the top 100).

Example
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/citations?days=30"
Answer (shortened)
[{ "domain": "tripadvisor.com", "count": 12 }]

GET /websites/{id}/agent-visits

AI-bot visits to your website by bot, by day and by page, and people who came from an AI answer. It fills once visits are collected: with the Cloudflare Worker, the WordPress plugin, the Vercel code, a log upload or agent-events below.

Example
curl -H "Authorization: Bearer bv_your_key" "https://api.businessveno.com/api/public/v1/websites/3f2b8c1e-0000-4000-8000-000000000001/agent-visits?days=30"
Answer (shortened)
{ "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 AI-bot visits from your own server. website is your website's address in BusinessVeno, or one of its subdomains (blog.example.com counts for example.com); events is up to 500 visits, each with userAgent, path, status, timestamp and, if you have them, referrer and ip. We keep only AI bots and people who came from an AI answer, drop bots whose ip isn't their owner's, and never store the ip. A timestamp older than 7 days becomes now. Each kept visit counts toward your monthly AI-bot visits (Strategist 200,000, Sentinel 1,000,000), not your API requests; each key may send up to 1,200 requests a minute. An unknown website or more than 500 events answers 400 (common.invalid_request).

Example
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"
Answer (shortened)
{ "accepted": 1, "ignored": 0 }

Errors and limits

Errors answer JSON with an error (a sentence you can show) and a code (stable, for your code).

Errors and limits
StatusCodeWhat it means
401api.invalid_keyThe key is missing, wrong or revoked.
402plan.feature_not_includedYour plan doesn't include the API.
402plan.limit_reachedThis month's requests are used up.
404common.not_foundNo website with that id for this key.
429common.too_many_requestsMore than 60 requests in a minute: wait and try again.
  • 60 requests a minute per key, API and MCP together. Every answer has X-RateLimit-Limit and X-RateLimit-Remaining headers; above the limit the answer is 429 with a Retry-After header: wait that many seconds.
  • Strategist has 2,000 API requests and 2,000 MCP requests a month, Sentinel 5,000 of each - see the prices. Requests count from the first of the month.

MCP for ChatGPT and Claude

MCP lets an AI assistant read your data and answer questions like "How is our AI visibility this month?". Each tool call counts as one MCP request.

MCP server address
https://api.businessveno.com/api/public/v1/mcp
  • ChatGPT: in Settings › Connectors, add a custom connector with the MCP server address (needs a ChatGPT plan with custom connectors). Sign in to BusinessVeno when asked and choose which companies it may read - one connection can cover all your clients.
  • Claude: in Settings › Connectors, add a custom connector with the MCP server address, then sign in to BusinessVeno and choose the companies.
  • Tools that take a header instead of signing in (Claude Code, mcp-remote): use an API key as the Authorization header, as below.
Claude Code
claude mcp add --transport http businessveno https://api.businessveno.com/api/public/v1/mcp --header "Authorization: Bearer bv_your_key"
Tools
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

  1. Create an API key in Settings › API & MCP and copy it.
  2. Open the BusinessVeno connector in Looker Studio (new tab)
  3. Click Authorize, then paste your key.
  4. Pick your website and the data (visibility, AI answers, Google rankings, cited sources or AI-bot visits), then click Connect. Each time a chart loads its data, that counts as one API request.