BotSeen API

curl https://www.botseen.com/api/v1/projects \
  -H "Authorization: Bearer bs_live_your_key_here"

claude mcp add --transport http botseen https://www.botseen.com/api/mcp \
  --header "Authorization: Bearer bs_live_your_key_here"

{
  "mcpServers": {
    "botseen": {
      "url": "https://www.botseen.com/api/mcp",
      "headers": { "Authorization": "Bearer bs_live_your_key_here" }
    }
  }
}

curl https://www.botseen.com/api/v1/projects \
  -H "Authorization: Bearer bs_live_…"

{
  "data": [
    {
      "id": "3f6a1c2e-…",
      "name": "Acme",
      "brand_url": "https://acme.com",
      "category": "Project management software",
      "visibility": 62,
      "prompt_count": 20,
      "engine_count": 5,
      "hallucinations": 1,
      "last_scanned_at": "2026-07-08T09:00:12.000Z"
    }
  ]
}

curl https://www.botseen.com/api/v1/projects/3f6a1c2e-… \
  -H "Authorization: Bearer bs_live_…"

{
  "data": {
    "id": "3f6a1c2e-…",
    "name": "Acme",
    "brand_url": "https://acme.com",
    "category": "Project management software",
    "icp": "startup founders",
    "engines": ["chatgpt", "perplexity", "gemini", "google_ai", "claude"],
    "competitors": [
      { "name": "Jira", "url": "https://atlassian.com/jira" }
    ],
    "prompts": [
      {
        "id": "9b2d4e88-…",
        "text": "best project management tool for startups",
        "intent": "buying",
        "topic": "Project Management"
      }
    ],
    "latest_scan": {
      "visibility": 62,
      "hallucinations": 1,
      "scanned_at": "2026-07-08T09:00:12.000Z"
    }
  }
}

curl https://www.botseen.com/api/v1/projects/3f6a1c2e-…/results \
  -H "Authorization: Bearer bs_live_…"

{
  "data": [
    {
      "prompt_id": "9b2d4e88-…",
      "engine": "perplexity",
      "brand_mentioned": true,
      "position": 2,
      "competitors": ["Jira", "ClickUp"],
      "citations": [
        { "url": "https://reddit.com/r/startups/…", "title": "What PM tool…" }
      ],
      "wrong_claims": [],
      "answer": "For startups, the top picks are…",
      "model": "sonar-pro"
    }
  ]
}

const res = await fetch("https://www.botseen.com/api/v1/projects", {
  headers: { Authorization: `Bearer ${process.env.BOTSEEN_API_KEY}` }
});
const { data } = await res.json();

for (const project of data) {
  console.log(`${project.name}: ${project.visibility ?? "not scanned"}% visible`);
}

import os, requests

headers = {"Authorization": f"Bearer {os.environ['BOTSEEN_API_KEY']}"}
projects = requests.get("https://www.botseen.com/api/v1/projects", headers=headers).json()["data"]

for p in projects:
    results = requests.get(
        f"https://www.botseen.com/api/v1/projects/{p['id']}/results", headers=headers
    ).json()["data"]
    missing = [r for r in results if not r["brand_mentioned"]]
    print(f"{p['name']}: missing from {len(missing)} of {len(results)} answers")

function pullVisibility() {
  const res = UrlFetchApp.fetch("https://www.botseen.com/api/v1/projects", {
    headers: { Authorization: "Bearer " + PropertiesService
      .getScriptProperties().getProperty("BOTSEEN_API_KEY") }
  });
  const rows = JSON.parse(res.getContentText()).data
    .map(p => [p.name, p.visibility, p.hallucinations, p.last_scanned_at]);
  const sheet = SpreadsheetApp.getActiveSheet();
  sheet.getRange(2, 1, rows.length, 4).setValues(rows);
}