Get AI visibility

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/ai-visibility"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/ai-visibility", {
  headers: { Authorization: "Bearer mr_ws_…" },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.get(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/ai-visibility",
    headers={"Authorization": "Bearer mr_ws_…"},
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/ai-visibility");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…"],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.get("https://app.monoranks.com/api/v1/sites/SITE_ID/ai-visibility", { headers: { Authorization: "Bearer mr_ws_…" } });

{
  "weeks": [
    {
      "week": "2026-10-05",
      "answers": 6,
      "mentionRate": 50,
      "citationRate": 33,
      "promptsAsked": 2,
      "truncated": false,
      "prompts": [
        {
          "promptId": "3e5a7c9e-1a3c-4e5a-8c7e-1a3c5e7a9c1e",
          "prompt": "Best place to buy a gravel bike online in the US?",
          "locale": "en",
          "active": true,
          "answers": [
            {
              "model": "gpt-5.2",
              "modelName": "GPT-5.2",
              "provider": "openai",
              "namedUs": true,
              "citedUs": true,
              "citedUrls": [
                "https://acmebikes.com/gravel-bikes/"
              ],
              "sourceUrls": [
                "https://acmebikes.com/gravel-bikes/",
                "https://www.rei.com/c/gravel-bikes"
              ],
              "sources": [
                "acmebikes.com",
                "rei.com"
              ],
              "answeredAt": "2026-10-05T04:12:09.000Z"
            },
            {
              "model": "claude-sonnet-4-6",
              "modelName": "Claude Sonnet 4.6",
              "provider": "anthropic",
              "namedUs": false,
              "citedUs": false,
              "citedUrls": [],
              "sourceUrls": [
                "https://www.rei.com/c/gravel-bikes"
              ],
              "sources": [
                "rei.com",
                "competitivecyclist.com"
              ],
              "answeredAt": "2026-10-05T04:12:31.000Z"
            }
          ]
        }
      ]
    }
  ],
  "note": "Sampled weekly from the configured AI models; each answer is one observation. Answer text is not included. Failed answers are left out.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/visibility"
}

{
  "error": {
    "code": "bad_weeks",
    "message": "weeks must be a whole number from 1 to 12."
  }
}

{
  "error": {
    "code": "missing_key",
    "message": "Send the key as Authorization: Bearer mr_site_…"
  }
}

{
  "error": {
    "code": "missing_scope",
    "message": "This key does not have the scope this call needs."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Website not found."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "More than 1200 requests this hour for this key."
  }
}

{
  "error": {
    "code": "feature_off",
    "message": "AI visibility is switched off for now."
  }
}