{"content":[{"text":"/sandbox/repo\ntotal 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Sep 22 21:12 ..\ndrwxr-xr-x 8 root root 4096 Sep 18 08:00 .git\n-rw-r--r-- 1 root root  408 Sep 18 08:00 .gitignore\n---ENV---\nPI_GATEWAY_API_KEY=<redacted>\nGIT_CONFIG_KEY_0=<redacted>\n","type":"text"}]}

echo "=== git ===" && git -C /sandbox/repo status 2>/dev/null | head -20; echo "=== node ===" && node -v 2>/dev/null; echo "=== python ===" && python3 --version 2>/dev/null; echo "=== net check ===" && curl -sS -m 8 -o /dev/null -w "%{http_code}\n" https://peec.ai 2>&1 | head

{"content":[{"text":"=== git ===\nOn branch main\nnothing to commit, working tree clean\n=== node ===\nv22.23.2\n=== python ===\nPython 3.12.3\n=== net check ===\n200\n","type":"text"}]}

{"content":[{"text":"=== peec.ai homepage ===\n \r\n \r\n \r\n \r\n \r\n\t \r\n\t \r\n\t \r\n\t Peec AI - AI Search Analytics for Marketing Teams \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n \r\n\t\r\n\t\r\n\t try{if(localStorage.getItem(\"__framer_force_showing_editorbar_since\")){const n=document.createElement(\"link\");n.rel=\"modulepreload\";n.href=\"https://framer.com/edit/init.mjs\";document.head.appendChild(n)}}catch(e){} \r\n\t\r\n\t \r\n \r\n \r\n (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':\r\nnew Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],\r\nj=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=\r\n'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);\r\n})(window,document,'script','dataLayer','GTM-N5XX9SJW'); \r\n \r\n \r\n !function(e,r){try{if(e.vector)return void console.log(\"Vector snippet included more than once.\");var t={};t.q=t.q||[];for(var o=[\"load\",\"identify\",\"on\"],n=function(e){return function(){var r=Array.prototype.slice.call(arguments);t.q.push([e,r])}},c=0;c<o.length;c++){var a=o[c];t[a]=n(a)}if(e.vector=t,!t.loaded){var i=r.createElement(\"script\");i.type=\"text/javascript\",i.async=!0,i.src=\"https://cdn.vector.co/pixel.js\";var l=r.getElementsByTagName(\"script\")[0];l.parentNode.insertBefore(i,l),t.loaded=!0}}catch(e){console.error(\"Error loading Vector:\",e)}}(window,document);\r\n vector.load(\"518bdaad-b5c8-47d9-8dc0-40aecf202b37\");\r\n \r\n\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n !(function (t, e) {\r\n var o, n, p, r;\r\n e.__SV ||\r\n ((window.posthog = e),\r\n (e._i = []),\r\n (e.init = function (i, s, a) {\r\n function g(t, e) {\r\n var o = e.split(\".\");\r\n (2 == o.length && ((t = t[o[0]]), (e = o[1])),\r\n (t[e] = function () {\r\n","type":"text"}]}

for u in "https://peec.ai/api" "https://peec.ai/docs" "https://docs.peec.ai" "https://peec.ai/developers" "https://peec.ai/api-docs" "https://api.peec.ai"; do code=$(curl -sSL -m 10 -o /dev/null -w "%{http_code} %{url_effective}" "$u" 2>&1); echo "$code <- $u"; done

{"content":[{"text":"404 https://peec.ai/api <- https://peec.ai/api\n404 https://peec.ai/docs <- https://peec.ai/docs\n200 https://docs.peec.ai/intro-to-peec-ai <- https://docs.peec.ai\n404 https://peec.ai/developers <- https://peec.ai/developers\n404 https://peec.ai/api-docs <- https://peec.ai/api-docs\n404 https://api.peec.ai/ <- https://api.peec.ai\n","type":"text"}]}

{"content":[{"text":"=== docs intro ===\ndocument.documentElement.setAttribute(\"data-current-path\",p);\nvar q=w.mintlify.__apiPlaygroundInputsQueue;\nif(!Array.isArray(q)){q=[];w.mintlify.__apiPlaygroundInputsQueue=q;}\nw.mintlify.api=w.mintlify.api||{};\nw.mintlify.api.playground=w.mintlify.api.playground||{};\nif(typeof w.mintlify.api.playground.setServerVariables!==\"function\"){\nw.mintlify.api.playground.setServerVariables=function(v){q.push({type:\"set\",variables:v});};\nif(typeof w.mintlify.api.playground.clearServerVariables!==\"function\"){\nw.mintlify.api.playground.clearServerVariables=function(){q.push({type:\"clear\"});};\n \"data-banner-state\",\n) {\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Peec.ai Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}} ((a,b,c,d,e,f,g,h)=>{let i=document.documentElement,j=[\"light\",\"dark\"];function k(b){var c;(Array.isArray(a)?a:[a]).forEach(a=>{let c=\"class\"===a,d=c&&f?e.map(a=>f[a]||a):e;c?(i.classList.remove(...d),i.classList.add(f&&f[b]?f[b]:b)):i.setAttribute(a,b)}),c=b,h&&j.includes(c)&&(i.style.colorScheme=c)}if(d)k(d);else try{let a=localStorage.getItem(b)||c,d=g&&\"system\"===a?window.matchMedia(\"(prefers-color-scheme: dark)\").matches?\"dark\":\"light\":a;k(d)}catch(a){}})(\"class\",\"isDarkMode\",\"system\",null,[\"dark\",\"light\",\"true\",\"false\",\"system\"],{\"true\":\"dark\",\"false\":\"light\",\"dark\":\"dark\",\"light\":\"light\"},true,false) (function(){try{var f=null;var v=f||localStorage.getItem(\"isDarkMode\");if(v==='true')v='dark';else if(v==='false')v='light';if(v!=='light'&&v!=='dark'&&v!=='system')v=\"system\";document.documentElement.setAttribute(\"data-theme-preference\",v)}catch(e){}})(); Documentation Index Fetch the complete documentation index at: /llms.txt Use this file to discover all available pages before exploring further. :root{--banner-height:0px!important} (function i(a,b,c,d,e){try{let f,g,h=[];try{h=window.location.pathname.split(\"/\").filter(a=>\"\"!==a&&\"global\"!==a).slice(0,2)}catch{h=[]}let i=h.find(a=>c.includes(a)),j=[];for(let c of(i?j.push(i):j.push(b),j.push(\"global\"),j)){if(!c)continue;let b=a[c];if(b?.content){f=b.content,g=c;break}}if(!f)return void document.documentElement.setAttribute(d,\"hidden\");let k=!0,l=0;for(;l<localStorage.length;){let a=localStorage.key(l);if(l++,!a?.endsWith(e))continue;let b=localStorage.getItem(a);if(b&&b===f){k=!1;break}g&&(a.startsWith(`lang:${g}_`)||!a.startsWith(\"lang:\"))&&(localStorage.removeItem(a),l--)}document.documentElement.setAttribute(d,k?\"visible\":\"hidden\")}catch(a){console.error(a),document.documentElement.setAttribute(d,\"hidden\")}})(\n \"data-banner-state\",\n } (function(a){let b,c=(b=\"navbar-transition\",\"maple\"===a&&(b+=\"-maple\"),b);function d(){let a=!1;a=window.scrollY>50;let b=document.getElementById(c);b&&b.hasAttribute(\"data-is-opaque\")&&b.setAttribute(\"data-is-opaque\",`${!!a}`)}let e=function(){let a=document.createElement(\"style\"),b=`#${c}`;return a.appendChild(document.createTextNode(`${b},${b} *,${b} *::before,${b} *::after{-webkit-transition:none!important;-moz-transition:none!important;-o-transition:none!important;-ms-transition:none!important;transition:none!important}`)),document.head.appendChild(a),function(){window.getComputedStyle(document.body),setTimeout(()=>{document.head.removeChild(a)},1)}}();function f(){window.removeEventListener(\"scroll\",d),document.removeEventListener(\"DOMContentLoaded\",d),d(),e()}window.addEventListener(\"scroll\",d,{passive:!0}),document.addEventListener(\"DOMContentLoaded\",d),(\"requestAnimationFrame\"in globalThis?requestAnimationFrame:setTimeout)(d),\"complete\"===document.readyState?f():window.addEventListener(\"load\",f,{once:!0})})(\"mint\") (function () {\n var measure = function(){let a=document.querySelectorAll(\"[id='navbar'], [data-top-chrome]\"),b=0;a.forEach(a=>{let c=a.getBoundingClientRect();c.height>0&&(b=Math.max(b,c.bottom))});let c=0,d=document.getElementById(\"content-container\");if(d){let{overflowY:a}=getComputedStyle(d);(\"auto\"===a||\"scroll\"===a)&&(c=Math.max(0,d.getBoundingClientRect().top))}let e=`${Math.round(Math.max(0,b-c))+40}px`,f=document.documentElement.style;f.getPropertyValue(\"--scroll-mt\")!==e&&f.setProperty(\"--scroll-mt\",e)};\n (function(a){let b=[],c=0,d=\"undefined\"==typeof ResizeObserver?null:new ResizeObserver(f);function e(){let c=Array.from(document.querySelectorAll(\"[id='navbar'], [data-top-chrome]\"));(c.length!==b.length||c.some((a,c)=>a!==b[c]))&&d&&(d.disconnect(),c.forEach(a=>d.observe(a))),b=c,a()}function f(){c||(c=requestAnimationFrame(()=>{c=0,e()}))}let g=\"[id='navbar'], [data-top-chrome]\";function h(a){let b=a.target;if(b instanceof Element&&b.closest(g))return!0;for(let b of a.addedNodes)if(b instanceof Element&&(b.matches(g)||b.querySelector(g)))return!0;for(let b of a.removedNodes)if(b instanceof Element&&(b.matches(g)||b.querySelector(g)))return!0;return!1}new MutationObserver(a=>{a.some(h)&&f()}).observe(document.documentElement,{childList:!0,subtree:!0}),window.addEventListener(\"resize\",f),\"loading\"===document.readyState&&document.addEventListener(\"DOMContentLoaded\",e),e()})(measure);\n})(); Skip to main content (function e(a,b,c,d,e){try{let f=window.matchMedia(\"(max-width: 1024px)\").matches;if(e){document.documentElement.style.setProperty(c,\"0px\"),document.documentElement.setAttribute(\"data-assistant-state\",\"closed\");return}if(f||!d){document.documentElement.style.setProperty(c,\"0px\"),document.documentElement.setAttribute(\"data-assistant-state\",\"closed\"),d||localStorage.setItem(a,\"false\");return}let g=localStorage.getItem(a);if(null===g){document.documentElement.style.setProperty(c,\"0px\"),document.documentElement.setAttribute(\"data-assistant-state\",\"closed\");return}let h=JSON.parse(g),i=localStorage.getItem(b),j=null!==i?JSON.parse(i):368;document.documentElement.style.setProperty(c,h?j+\"px\":\"0px\"),document.documentElement.setAttribute(\"data-assistant-state\",h?\"open\":\"closed\")}catch(a){document.documentElement.style.setProperty(c,\"0px\"),document.documentElement.setAttribute(\"data-assistant-state\",\"closed\")}})(\n ) Peec.ai Docs home page Search... ⌘ K Ask Assistant ⌘ I Contact Website Log In Search... Navigation Get Started Welcome to Peec AI Documentation Agencies MCP Server Customer API :root{--topbar-tabs-height:3rem} Get Started Welcome to Peec AI Quickstart Guide Main metrics Set up Your Project Setting up your prompts Organizing your setup Identifying your competitors Interpret Your Results Agent Understanding chats Understanding your performance Brand insights Understanding sources Ads Sources Type Brand perception Market Objections Fact-checking Your project Brand profile Manage your project AI Shopping Shopping overview Products Upload and manage your products Setting up shopping prompts Optimize Actions Agent Analytics Connecting your data Crawl insights Crawlability Use cases AI referrals Misc Sidebar navigation Metrics overview My website Single sign-on (SSO) Video library Integrations Data Studio connector (function () {\n var parent = item.closest('[data-component-part=\"scroll-area-viewport\"]');\n})(); {\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.peec.ai/#organization\",\"name\":\"Peec.ai Docs\",\"url\":\"https://docs.peec.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/peecai-b61a1960/BVQQX1wLWNjFOa_V/images/logo-white.svg?fit=max&auto=format&n=BVQQX1wLWNjFOa_V&q=85&s=5d3f30a498a2c71a875226adc1a9de52\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.peec.ai#website\",\"name\":\"Peec.ai Docs\",\"url\":\"https://docs.peec.ai\",\"publisher\":{\"@id\":\"https://docs.peec.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.peec.ai/intro-to-peec-ai#webpage\",\"url\":\"https://docs.peec.ai/intro-to-peec-ai\",\"name\":\"Welcome to Peec AI\",\"description\":\"The #1 AI search analytics tool for marketing teams and agencies.\",\"dateModified\":\"2026-09-08T09:58:18.565Z\",\"isPartOf\":{\"@id\":\"https://docs.peec.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.peec.ai/intro-to-peec-ai#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.peec.ai/intro-to-peec-ai#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Peec.ai Docs\",\"item\":\"https://docs.peec.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Welcome to Peec AI\",\"item\":\"https://docs.peec.ai/intro-to-peec-ai\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.peec.ai/intro-to-peec-ai#article\",\"headline\":\"Welcome to Peec AI\",\"name\":\"Welcome to Peec AI\",\"description\":\"The #1 AI search analytics tool for marketing teams and agencies.\",\"url\":\"https://docs.peec.ai/intro-to-peec-ai\",\"mainEntityOfPage\":{\"@id\":\"https://docs.peec.ai/intro-to-peec-ai#webpage\"},\"dateModified\":\"2026-09-08T09:58:18.565Z\",\"publisher\":{\"@id\":\"https://docs.peec.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.peec.ai#website\"}}]} document.documentElement.setAttribute('data-page-mode', \"none\"); On this page What you’ll find in these docs What Peec AI does How Peec AI collects data Technical approach: UI scraping vs API access Why we don’t use APIs Our UI scraping advantage How Peec AI helps Get Started Welcome to Peec AI The #1 AI search analytics tool for marketing teams and agencies. \n Set up your project: Learn how to craft effective prompts for your industry, organize your tracking system with tags and topics, and identify which competitors to watch. This is where you build everything you need to start collecting meaningful data. \n Interpret your results: Once your prompts are running, you’ll see visibility data, position trends, and sentiment patterns. This section shows you how to analyze your data to spot real opportunities, from understanding chat details to reading graph trends over time. \n Take action: Based on your visibility data, Peec AI generates specific suggestions to improve your results, like recommending which publications to reach out to, identifying content gaps to fill, or highlighting sources where a mention could boost your visibility. \n ​ How Peec AI collects data \n Unlike traditional analytics tools that rely on APIs, Peec AI uses UI scraping technology to interact with AI platforms exactly as real users do. This approach has several advantages: \n Real-world accuracy: The data reflects actual user experiences, not sanitized API responses. \n Comprehensive coverage: Peec AI can reach platforms that don’t offer public APIs or have limited API functionality. \n Peec AI’s UI scraping simulates real user interactions, so the data it collects matches what the average user sees on these AI platforms. For most platforms, this means the platform decides which model to use and whether it runs a web search. This is the reality for a logged-out user, and the approach closest to the average user’s experience. \n ​ Technical approach: UI scraping vs API access \n ​ Why we don’t use APIs \n Most AI analytics tools rely on official APIs, but that approach has key limitations: \n Different responses: API responses often differ from what users see in the actual interface. \n Different sources: The number and type of sources in API responses can differ from those shown to real users. \n ​ Our UI scraping advantage \n Instead of APIs, Peec AI uses browser automation to interact with AI platforms through their web interfaces: \n Real user simulation: Peec AI uses the same interfaces your customers use, so the data reflects what real users see. \n Consistent data quality: Every interaction follows the same user journey as a real user. \n Resilient to API changes: Because Peec AI doesn’t depend on official APIs, it keeps working when those APIs change or restrict access. \n This approach means your visibility data reflects the real user experience, not a filtered or modified API response. \n The analysis goes beyond basic mentions: you can filter by time period, compare multiple competitors, and access all your data through exports, the Data Studio connector , and the API for custom analysis or integration with your existing analytics stack. \n Make data-driven decisions: Use probability-based insights for your strategy. \n","type":"text"}]}

{"content":[{"text":"=== look for sitemap/nav ===\nhttps://docs.peec.ai/actions\nhttps://docs.peec.ai/ads\nhttps://docs.peec.ai/agencies/agency-getting-started\nhttps://docs.peec.ai/agencies/managing-your-projects\nhttps://docs.peec.ai/agencies/understanding_credits\nhttps://docs.peec.ai/agent\nhttps://docs.peec.ai/ai-referrals\nhttps://docs.peec.ai/api-reference/agent-analytics/get-ai-referrals\nhttps://docs.peec.ai/api-reference/agent-analytics/list-referral-sources\nhttps://docs.peec.ai/api-reference/brand-perception/create-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/edit-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attribute-rankings\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attribute-sources\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attributes\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-competitive-breakdown\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-objection-sources\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-objections\nhttps://docs.peec.ai/api-reference/brand-perception/list-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/list-brand-perception-industries\nhttps://docs.peec.ai/api-reference/company/list-projects\nhttps://docs.peec.ai/api-reference/products/create-categories\nhttps://docs.peec.ai/api-reference/products/create-global-brand\nhttps://docs.peec.ai/api-reference/products/create-products\nhttps://docs.peec.ai/api-reference/products/delete-categories\nhttps://docs.peec.ai/api-reference/products/delete-products\nhttps://docs.peec.ai/api-reference/products/get-product\nhttps://docs.peec.ai/api-reference/products/get-shopping-attributes\nhttps://docs.peec.ai/api-reference/products/get-shopping-summary\nhttps://docs.peec.ai/api-reference/products/get-shopping-trend\nhttps://docs.peec.ai/api-reference/products/list-categories\nhttps://docs.peec.ai/api-reference/products/list-global-brands\nhttps://docs.peec.ai/api-reference/products/list-merchants\nhttps://docs.peec.ai/api-reference/products/list-products\nhttps://docs.peec.ai/api-reference/products/list-shopping-demand\nhttps://docs.peec.ai/api-reference/products/list-shopping-performance\nhttps://docs.peec.ai/api-reference/products/update-categories\nhttps://docs.peec.ai/api-reference/products/update-products\nhttps://docs.peec.ai/api-reference/project/accept-brand-suggestion\nhttps://docs.peec.ai/api-reference/project/accept-prompt-suggestion\nhttps://docs.peec.ai/api-reference/project/accept-topic-suggestion\nhttps://docs.peec.ai/api-reference/project/archive-prompt\nhttps://docs.peec.ai/api-reference/project/create-brand\nhttps://docs.peec.ai/api-reference/project/create-custom-domain-classification\nhttps://docs.peec.ai/api-reference/project/create-custom-url-classification\nhttps://docs.peec.ai/api-reference/project/create-prompt\nhttps://docs.peec.ai/api-reference/project/create-tag\nhttps://docs.peec.ai/api-reference/project/create-topic\nhttps://docs.peec.ai/api-reference/project/delete-brand\nhttps://docs.peec.ai/api-reference/project/delete-custom-domain-classification\nhttps://docs.peec.ai/api-reference/project/delete-custom-url-classification\nhttps://docs.peec.ai/api-reference/project/delete-prompt\nhttps://docs.peec.ai/api-reference/project/delete-tag\nhttps://docs.peec.ai/api-reference/project/delete-tag-group\nhttps://docs.peec.ai/api-reference/project/delete-topic\nhttps://docs.peec.ai/api-reference/project/generate-prompt-suggestions\nhttps://docs.peec.ai/api-reference/project/generate-topics\nhttps://docs.peec.ai/api-reference/project/get-agent-visits\nhttps://docs.peec.ai/api-reference/project/get-chat\nhttps://docs.peec.ai/api-reference/project/get-project-profile\nhttps://docs.peec.ai/api-reference/project/get-prompt-suggestion-generation\n","type":"text"}]}

{"content":[{"text":"# Peec.ai Docs\n\n- [Welcome to Peec AI](https://docs.peec.ai/intro-to-peec-ai.md): The #1 AI search analytics tool for marketing teams and agencies.\n- [Quickstart Guide](https://docs.peec.ai/quickstart-guide.md): The fastest way to understand your brand’s AI search presence.\n- [Visibility](https://docs.peec.ai/metrics/brand-metrics/visibility.md): How often your brand is mentioned in AI responses.\n- [Share of Voice](https://docs.peec.ai/metrics/brand-metrics/share-of-voice.md): How much of the conversation you own.\n- [Sentiment](https://docs.peec.ai/metrics/brand-metrics/sentiment.md): The tone and sentiment of your brand mentions.\n- [Position](https://docs.peec.ai/metrics/brand-metrics/position.md): How your brand ranks in AI responses.\n- [Setting up your prompts](https://docs.peec.ai/setting-up-your-prompts.md): Our in-depth guide to building your prompt and competitor tracking system.\n- [Organizing your setup](https://docs.peec.ai/organizing-your-setup.md): Keep your prompts manageable and analysis-ready with smart organization.\n- [Identifying your competitors](https://docs.peec.ai/identifying-your-competitors.md): Track how you perform against competitors and see which brands AI recommends alongside or instead of yours.\n- [Agent](https://docs.peec.ai/agent.md): Explore your Peec data by asking questions in plain language and get answers with charts generated for you.\n- [Understanding chats](https://docs.peec.ai/understanding-chats.md): Learn how to read the AI responses that form the foundation of all your analytics.\n- [Understanding your performance](https://docs.peec.ai/understanding-your-performance.md): Your main analytics hub for understanding how your brand performs across AI models, prompts, and competitors.\n- [Brand insights](https://docs.peec.ai/brand-insights.md)\n- [Understanding sources](https://docs.peec.ai/understanding-sources.md): Discover which websites AI models trust and learn how to optimize your presence across them.\n- [Ads](https://docs.peec.ai/ads.md): Identify which brands advertise on the prompts you’re tracking, review their ads, and see which pages those ads point to.\n- [Domains](https://docs.peec.ai/domains.md)\n- [URLs](https://docs.peec.ai/urls.md)\n- [Market](https://docs.peec.ai/brand-perception-market.md): How AI describes your brand against the market, broken into the attributes models associate with brands in your industry.\n- [Objections](https://docs.peec.ai/brand-perception-objections.md): The arguments AI makes against your brand when a buyer is deciding, grouped by meaning and traced to the pages behind them.\n- [Fact-checking](https://docs.peec.ai/brand-perception-fact-checking.md): What AI says about your brand, compared against the facts you provide, with any claims that contradict your facts highlighted first.\n- [Brand profile](https://docs.peec.ai/project-profile.md)\n- [Manage your project](https://docs.peec.ai/manage-your-project.md)\n- [Shopping overview](https://docs.peec.ai/overview.md): Track how your products appear across AI models by product, competitor, and week.\n- [Products](https://docs.peec.ai/products.md): See every product in your catalog with AI Shopping metrics and detailed insights into visibility, competitors, and attributes.\n- [Upload and manage your products](https://docs.peec.ai/uploading-products.md): Connect your product catalog to Peec to understand how each product performs across AI Shopping recommendations.\n- [Setting up shopping prompts](https://docs.peec.ai/setting-up-shopping-prompts.md): Build a prompt set for product tracking with strong category coverage as its foundation, then add product-specific prompts where deeper insights are needed.\n- [Actions](https://docs.peec.ai/actions.md): A prioritized list of ways to improve your AI visibility, with the evidence behind each recommendation and guidance on what to do next.\n- [Connecting your data](https://docs.peec.ai/connecting-your-data.md)\n- [Crawl insights](https://docs.peec.ai/crawl-insights.md)\n- [Crawlability](https://docs.peec.ai/crawlability.md)\n- [Use cases](https://docs.peec.ai/use-cases.md)\n- [AI referrals](https://docs.peec.ai/ai-referrals.md)\n- [Sidebar navigation ](https://docs.peec.ai/sidebar-navigation.md): A quick guide to the sections available in the Peec AI sidebar, their key features, and what you can do in each one.\n- [Metrics overview](https://docs.peec.ai/metrics-overview.md): The key metrics Peec AI tracks and how they help you understand and improve your AI search performance.\n- [My website](https://docs.peec.ai/my-website.md): See how AI interacts with your website, from visiting and citing your pages to driving traffic and conversions.\n- [Single sign-on (SSO)](https://docs.peec.ai/sso.md): Sign in to Peec AI through your company's identity provider, and require it for everyone on your domains.\n- [Video library](https://docs.peec.ai/video-library.md): For those who prefer the video format, this is a collection of all of the videos we've linked in this Product Documentation.\n- [Data Studio connector](https://docs.peec.ai/looker/introduction.md): Complete guide to connecting and using Peec AI data in Data Studio (formerly known as Looker Studio).\n- [Peec AI for Agencies: Getting started](https://docs.peec.ai/agencies/agency-getting-started.md)\n- [Understanding credits](https://docs.peec.ai/agencies/understanding_credits.md): How agencies can use credits to allocate prompts and models to their projects\n- [Managing your projects](https://docs.peec.ai/agencies/managing-your-projects.md)\n- [MCP Server](https://docs.peec.ai/mcp/introduction.md): Connect AI assistants like Claude, Cursor, and other MCP-compatible tools directly to your Peec AI data. Ask questions in plain language and get answers from the same data the dashboard shows.\n- [Setup Guide](https://docs.peec.ai/mcp/setup.md): Step-by-step instructions for connecting the Peec AI MCP Server to Claude, Cursor, and other AI tools. Stuck? Email support@peec.ai.\n- [Use Cases](https://docs.peec.ai/mcp/use-cases.md): Example prompts and workflows for the Peec AI MCP Server. Browse by type if you need ideas on what to ask.\n- [Prompts](https://docs.peec.ai/mcp/prompts.md): Peec AI ships native MCP prompts: ready-to-run analysis workflows exposed as slash commands in your AI tool. Each prompt runs a scripted sequence of tool calls and formats the output for you.\n- [Tools Reference](https://docs.peec.ai/mcp/tools.md): Every tool the Peec AI MCP Server exposes, with parameters and response fields.\n- [Introduction to Peec API](https://docs.peec.ai/api/introduction.md)\n- [Authentication for Peec API](https://docs.peec.ai/api/authentication.md)\n- [Rate Limits for Peec API](https://docs.peec.ai/api/ratelimits.md)\n- [Model Channels](https://docs.peec.ai/api/model-channels.md): A stable way to reference AI surfaces as underlying models evolve.\n- [Filtering and dimensions](https://docs.peec.ai/api/filtering-and-dimensions.md): How dimensions, filters, and having work on report endpoints, and the pitfalls to avoid.\n- [Changelog](https://docs.peec.ai/api/changelog.md): Track updates, improvements, and breaking changes to the Peec API.\n- [Get Brands Report](https://docs.peec.ai/api-reference/reports/get-brands-report.md): Get a report on Brands.\n- [Get Domains Report](https://docs.peec.ai/api-reference/reports/get-domains-report.md): Get a report on Source Domains.\n- [Get URLs Report](https://docs.peec.ai/api-reference/reports/get-urls-report.md): Get a report on Source URLs.\n- [Get URL Content](https://docs.peec.ai/api-reference/reports/get-url-content.md): Return the scraped markdown content of a source URL. Use the URLs report to discover URLs.\n- [List Fanout Search Queries](https://docs.peec.ai/api-reference/project/list-fanout-search-queries.md): List the fanout search queries of a project\n- [List Fanout Shopping Queries](https://docs.peec.ai/api-reference/project/list-fanout-shopping-queries.md): List the fanout shopping queries of a project\n- [List Brands](https://docs.peec.ai/api-reference/project/list-brands.md): List the brands of a project\n- [Create Brand](https://docs.peec.ai/api-reference/project/create-brand.md): Create a new brand within a project\n- [List Brand Social Channels](https://docs.peec.ai/api-reference/project/list-brand-social-channels.md): List the social channels configured for a project, optionally filtered to one brand.\n- [List Brand Suggestions](https://docs.peec.ai/api-reference/project/list-brand-suggestions.md): List the open brand suggestions of a project\n- [Accept Brand Suggestion](https://docs.peec.ai/api-reference/project/accept-brand-suggestion.md): Accept a brand suggestion by ID, converting it into a brand within the project\n- [Reject Brand Suggestion](https://docs.peec.ai/api-reference/project/reject-brand-suggestion.md): Reject a brand suggestion by ID, removing it from the project and preventing it from being re-suggested\n- [Delete Brand](https://docs.peec.ai/api-reference/project/delete-brand.md): Delete a brand within a project.\n- [Update Brand](https://docs.peec.ai/api-reference/project/update-brand.md): Update a brand within a project. Changes to name, regex, or aliases trigger a background recalculation of metrics. While recalculation is in progress, further updates to these fields are blocked (409 Conflict) until it completes.\n- [Set Brand Social Channels](https://docs.peec.ai/api-reference/project/set-brand-social-channels.md): Replace the complete list of social channels configured for a brand. Pass an empty list to remove them all.\n- [List Prompts](https://docs.peec.ai/api-reference/project/list-prompts.md): List the prompts of a project\n- [Create Prompt](https://docs.peec.ai/api-reference/project/create-prompt.md): Create a new prompt within a project. Without a `country_code` the prompt takes the market of its topic, or the project's market when the topic has none.\n- [List Prompt Suggestions](https://docs.peec.ai/api-reference/project/list-prompt-suggestions.md): List the prompt suggestions of a project\n- [Generate Prompt Suggestions](https://docs.peec.ai/api-reference/project/generate-prompt-suggestions.md): Generate Prompt Builder suggestions for a project, the same way the Prompt Builder does. Generation runs in the background: this returns its generation ID as soon as it is queued. Poll `GET /prompts/suggestions/generations/{generation_id}` until it succeeds or fails, then list successful results wit…\n- [Get Prompt Suggestion Generation](https://docs.peec.ai/api-reference/project/get-prompt-suggestion-generation.md): Get the authoritative state of a Prompt Builder suggestion generation queued by this project.\n- [Accept Prompt Suggestion](https://docs.peec.ai/api-reference/project/accept-prompt-suggestion.md): Accept a prompt suggestion by ID, creating a new prompt from it. Accepts both standard suggestions (`ps_`) and Prompt discovery suggestions (`pr_`); accepting a Prompt discovery suggestion also promotes its pending topic into a project topic. Optionally pass a country_code to override the suggestion…\n- [Reject Prompt Suggestion](https://docs.peec.ai/api-reference/project/reject-prompt-suggestion.md): Reject a prompt suggestion by ID, deleting it. Accepts both standard suggestions (`ps_`) and Prompt discovery suggestions (`pr_`).\n- [Update Prompt Suggestions](https://docs.peec.ai/api-reference/project/update-prompt-suggestions.md): Edit pending Prompt discovery suggestions (`pr_`) before accepting them: rewrite the text and/or replace the tag set per item. Editing keeps a suggestion pending — accept it to create the tracked prompt. Each item is independent: unknown ids are reported in `skipped`, and unsatisfiable items (a stan…\n- [Delete Prompt](https://docs.peec.ai/api-reference/project/delete-prompt.md): Delete a prompt and cascade to related chats\n- [Update Prompt](https://docs.peec.ai/api-reference/project/update-prompt.md): Update a prompt's topic and tags within a project\n- [Archive Prompt](https://docs.peec.ai/api-reference/project/archive-prompt.md): Archive a prompt (is_archived = true) so it stops running while keeping its chats and history\n- [Unarchive Prompt](https://docs.peec.ai/api-reference/project/unarchive-prompt.md): Unarchive a prompt (is_archived = false), reactivating it. Subject to the project's active-prompt plan limit\n- [List Tags](https://docs.peec.ai/api-reference/project/list-tags.md): List the tags of a project. Tags include user-created tags and Peec-managed system tags (is_system=true). Each tag carries a `group`: for system tags this is the mutually-exclusive dimension (branding or intentType); for user tags it is the user-defined group name (or null). Pass `group` to filter t…\n- [Create Tag](https://docs.peec.ai/api-reference/project/create-tag.md): Create a new tag within a project\n- [Delete Tag](https://docs.peec.ai/api-reference/project/delete-tag.md): Delete a tag within a project\n- [Update Tag](https://docs.peec.ai/api-reference/project/update-tag.md): Update a tag within a project\n- [List Tag Groups](https://docs.peec.ai/api-reference/project/list-tag-groups.md): List the user-defined tag groups of a project (distinct non-empty `group` values across the project's tags), each with its shared color and tag count. System groups (branding/intentType) are not included — see List Tags for those.\n- [Delete Tag Group](https://docs.peec.ai/api-reference/project/delete-tag-group.md): Delete a user-defined tag group. By default the tags are kept and simply ungrouped (their `group` becomes null); pass delete_tags=true to delete the tags themselves and detach them from every prompt. System groups (branding/intentType) cannot be deleted.\n- [Update Tag Group](https://docs.peec.ai/api-reference/project/update-tag-group.md): Rename and/or recolor a user-defined tag group. Applies to every tag in the group. System groups (branding/intentType) cannot be modified.\n- [List Topics](https://docs.peec.ai/api-reference/project/list-topics.md): List the topics of a project\n- [Create Topic](https://docs.peec.ai/api-reference/project/create-topic.md): Create a new topic within a project\n- [Generate Topics](https://docs.peec.ai/api-reference/project/generate-topics.md): Compose candidate topics for the project from its brand profile. Nothing is saved — review the returned names and create the ones you want with `POST /topics`. Composition already accounts for the project's existing topics, so it proposes only what fills a gap and can return an empty list when the s…\n- [List Topic Suggestions](https://docs.peec.ai/api-reference/project/list-topic-suggestions.md): List the topic suggestions of a project\n- [Accept Topic Suggestion](https://docs.peec.ai/api-reference/project/accept-topic-suggestion.md): Accept a topic suggestion by ID, converting it into a regular topic\n- [Reject Topic Suggestion](https://docs.peec.ai/api-reference/project/reject-topic-suggestion.md): Reject a topic suggestion by ID, deleting it and its associated prompt suggestions\n- [Delete Topic](https://docs.peec.ai/api-reference/project/delete-topic.md): Delete a topic, detaching all associated prompts and deleting prompt suggestions\n- [Update Topic](https://docs.peec.ai/api-reference/project/update-topic.md): Update a topic within a project\n- [List Models](https://docs.peec.ai/api-reference/project/list-models.md): Deprecated: use List Model Channels instead.\n- [List Model Channels](https://docs.peec.ai/api-reference/project/list-model-channels.md): List the model channels\n- [List Bots](https://docs.peec.ai/api-reference/project/list-bots.md): List all known AI agent bots from agent analytics.\n- [List Agent logs](https://docs.peec.ai/api-reference/project/list-agent-logs.md): List Agent access logs from your log provider integration or access file upload\n- [Get Agent Visits](https://docs.peec.ai/api-reference/project/get-agent-visits.md): Aggregate agent access log visits grouped by a chosen dimension (bot, response status, host, path).\n- [List Chats](https://docs.peec.ai/api-reference/project/list-chats.md): List the chats of a project\n- [Get Chat](https://docs.peec.ai/api-reference/project/get-chat.md): Get a single chat\n- [Get Project Profile](https://docs.peec.ai/api-reference/project/get-project-profile.md): Read the project's brand profile (description, industry, brand identity, target markets, audience distribution, products & services). Returns `{ profile: null }` if the project hasn't been profiled yet.\n- [Set Project Profile](https://docs.peec.ai/api-reference/project/set-project-profile.md): Replace the project's brand profile. All fields are required — the entire profile is overwritten. Triggers a background refresh of prompt suggestions. Audience distribution percentages must sum to 100. The project's display name is not part of the profile and cannot be changed via this endpoint. Ret…\n- [List Custom Domain Classifications](https://docs.peec.ai/api-reference/project/list-custom-domain-classifications.md): List the custom domain classifications defined for a project. These complement the built-in classifications and can be assigned to domains.\n- [Create Custom Domain Classification](https://docs.peec.ai/api-reference/project/create-custom-domain-classification.md): Define a new custom domain classification for a project. Once created, it can be assigned to domains via the assignment endpoint.\n- [Delete Custom Domain Classification](https://docs.peec.ai/api-reference/project/delete-custom-domain-classification.md): Delete a custom domain classification. Cascades through the override table, so any domains currently assigned this classification fall back to their heuristic classification.\n- [Set Domain Classification](https://docs.peec.ai/api-reference/project/set-domain-classification.md): Assign a built-in or custom classification to a domain (overriding any heuristic classification), or clear the assignment by passing null.\n- [List Custom URL Classifications](https://docs.peec.ai/api-reference/project/list-custom-url-classifications.md): List the custom URL classifications defined for a project. These complement the built-in classifications and can be assigned to URLs.\n- [Create Custom URL Classification](https://docs.peec.ai/api-reference/project/create-custom-url-classification.md): Define a new custom URL classification for a project. Once created, it can be assigned to URLs via the assignment endpoint.\n- [Delete Custom URL Classification](https://docs.peec.ai/api-reference/project/delete-custom-url-classification.md): Delete a custom URL classification. Cascades through the override table, so any URLs currently assigned this classification fall back to their heuristic classification.\n- [Set URL Classification](https://docs.peec.ai/api-reference/project/set-url-classification.md): Assign a built-in or custom classification to a URL (overriding any heuristic classification), or clear the assignment by passing null.\n- [List Products](https://docs.peec.ai/api-reference/products/list-products.md): List a project's products with headline metrics (mention_count, win_count, avg_position, avg_rating, visibility, share_of_voice) over the date range, filterable by category, merchant, brand, country, model channel, topic, and tag. Paginated.\n- [Get Product](https://docs.peec.ai/api-reference/products/get-product.md): Get one product's detail over a date range: headline metrics (visibility, win_rate, avg_position, avg_rating, mention_count) plus a delta for each against the immediately preceding equal-length period, the catalog metadata (brand, description, image, source, first-seen date), the effective price ran…\n- [Get Shopping Attributes](https://docs.peec.ai/api-reference/products/get-shopping-attributes.md): The LLM-extracted attribute comparison grid for a product (scope=product) or the whole catalog (scope=overview), split by tab into characteristics, fa…

echo "=== find customer API / auth pages ===" && curl -sSL -m 15 https://docs.peec.ai/sitemap.xml 2>&1 | grep -oE "<loc>[^<]+</loc>" | sed 's/<[^>]*>//g' | grep -iE "api|auth|mcp|quickstart|customer|token" | head -40

{"content":[{"text":"=== find customer API / auth pages ===\nhttps://docs.peec.ai/api-reference/agent-analytics/get-ai-referrals\nhttps://docs.peec.ai/api-reference/agent-analytics/list-referral-sources\nhttps://docs.peec.ai/api-reference/brand-perception/create-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/edit-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attribute-rankings\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attribute-sources\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-attributes\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-competitive-breakdown\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-objection-sources\nhttps://docs.peec.ai/api-reference/brand-perception/get-brand-perception-objections\nhttps://docs.peec.ai/api-reference/brand-perception/list-brand-perception-attribute-clusters\nhttps://docs.peec.ai/api-reference/brand-perception/list-brand-perception-industries\nhttps://docs.peec.ai/api-reference/company/list-projects\nhttps://docs.peec.ai/api-reference/products/create-categories\nhttps://docs.peec.ai/api-reference/products/create-global-brand\nhttps://docs.peec.ai/api-reference/products/create-products\nhttps://docs.peec.ai/api-reference/products/delete-categories\nhttps://docs.peec.ai/api-reference/products/delete-products\nhttps://docs.peec.ai/api-reference/products/get-product\nhttps://docs.peec.ai/api-reference/products/get-shopping-attributes\nhttps://docs.peec.ai/api-reference/products/get-shopping-summary\nhttps://docs.peec.ai/api-reference/products/get-shopping-trend\nhttps://docs.peec.ai/api-reference/products/list-categories\nhttps://docs.peec.ai/api-reference/products/list-global-brands\nhttps://docs.peec.ai/api-reference/products/list-merchants\nhttps://docs.peec.ai/api-reference/products/list-products\nhttps://docs.peec.ai/api-reference/products/list-shopping-demand\nhttps://docs.peec.ai/api-reference/products/list-shopping-performance\nhttps://docs.peec.ai/api-reference/products/update-categories\nhttps://docs.peec.ai/api-reference/products/update-products\nhttps://docs.peec.ai/api-reference/project/accept-brand-suggestion\nhttps://docs.peec.ai/api-reference/project/accept-prompt-suggestion\nhttps://docs.peec.ai/api-reference/project/accept-topic-suggestion\nhttps://docs.peec.ai/api-reference/project/archive-prompt\nhttps://docs.peec.ai/api-reference/project/create-brand\nhttps://docs.peec.ai/api-reference/project/create-custom-domain-classification\nhttps://docs.peec.ai/api-reference/project/create-custom-url-classification\nhttps://docs.peec.ai/api-reference/project/create-prompt\nhttps://docs.peec.ai/api-reference/project/create-tag\nhttps://docs.peec.ai/api-reference/project/create-topic\n","type":"text"}]}

{"content":[{"text":"======== api/introduction ========\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# Introduction to Peec API\n\n## Overview\n\nThe API provides a way for developers to programmatically work with the same data available in our platform. All endpoints return data in JSON format, ensuring smooth integration with modern apps, services, and workflows.\n\n<Note>\n  Access to this API is currently limited to Enterprise customers.\n</Note>\n\n## Getting Started\n\nTo use the API, you’ll need to generate an API key from your [Account](https://app.peec.ai/api-keys). This key is required for authenticating requests and securing access to your organization’s data.\n\nFor more details on how authentication works, see the [Authentication](./authentication) section.\n\n======== api/authentication ========\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# Authentication for Peec API\n\nAll requests to the **Peec AI Customer API** must be authenticated with a valid API key. API keys can be scoped at either the **company** or **project** level, depending on your use case. Create your API key [here](https://app.peec.ai/api-keys).\n\n***\n\n## Passing API Keys\n\nYou can authenticate by providing your API key in one of two ways:\n\n### 1. HTTP Header\n\n```bash theme={null}\ncurl -X GET \"https://api.peec.ai/customer/v1/prompts\" \\\n  -H \"x-api-key: YOUR_API_KEY\"\n```\n\n### 2. Query Parameter\n\n```bash theme={null}\ncurl -X GET \"https://api.peec.ai/customer/v1/prompts?api_key=REDACTED\"\n```\n\n> We recommend using the x-api-key header for better security.\n\n## API Key Scopes\n\nAPI key scopes determine the level of access granted to the API. Choosing the appropriate scope helps ensure that your integrations have only the permissions they need.\n\n* *Company-scoped keys* – provide access across all projects within your organization. Use when building integrations that span multiple projects.\n* *Project-scoped keys* – limited to a single project. Use when isolating access for specific applications, environments, or teams.\n\n## Best Practices\n\n* Keep your API keys secret and never expose them in client-side code.\n* Rotate keys regularly.\n* Use project-scoped keys where possible to limit risk.\n\n======== api/ratelimits ========\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# Rate Limits for Peec API\n\nThe **Peec AI Customer API** enforces rate limits to ensure reliable and fair usage. Rate limits are applied **per project**.\n\n## Current Limits\n\n* **200 requests per minute** per project.\n\n<Warning>\n  These limits may be adjusted. Please adhere to the response headers.\n</Warning>\n\nIf your application exceeds the limit, requests will return a `429 Too Many Requests` response until the window resets.\n\n## Response Headers\n\nEvery response includes standard rate limit headers so you can monitor usage:\n\n* `X-RateLimit-Limit` – the maximum number of requests allowed in the current window.\n* `X-RateLimit-Remaining` – the number of requests remaining in the current window.\n* `X-RateLimit-Reset` – the time (in seconds) until the rate limit resets.\n\nExample response headers:\n\n```\nX-RateLimit-Limit: 100\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 23\n```\n\n## Best Practices\n\n* Monitor the rate limit headers in your integration.\n* Implement **exponential backoff** or **retry logic** when receiving `429` responses.\n* If you need higher limits, [contact support](mailto:support@peec.ai).\n\n","type":"text"}]}

echo "=== any peec key in env? ===" && env | grep -iE "peec" || echo "(none)"; echo; echo "=== npm registry: peec SDK? ==="; for pkg in peec peec-ai "@peec/sdk" "@peec/ai" peec-sdk; do echo -n "$pkg -> "; curl -sSL -m 10 "https://registry.npmjs.org/$(echo $pkg | sed 's|/|%2f|')" 2>/dev/null | head -c 200 | grep -oE '"(error|name)"[^,]*' | head -1 || echo "(no response)"; echo; done

{"content":[{"text":"=== any peec key in env? ===\n(none)\n\n=== npm registry: peec SDK? ===\npeec -> \"error\":\"Not found\"}\n\npeec-ai -> \"error\":\"Not found\"}\n\n@peec/sdk -> \"error\":\"Not found\"}\n\n@peec/ai -> \"error\":\"Not found\"}\n\npeec-sdk -> \"error\":\"Not found\"}\n\n","type":"text"}]}

echo "=== PyPI peec? ==="; for pkg in peec peec-ai peec-sdk; do echo -n "$pkg -> "; curl -sSL -m 10 -o /dev/null -w "%{http_code}" "https://pypi.org/pypi/$pkg/json"; echo; done
echo; echo "=== live API probe without key ==="; curl -sSL -m 12 -i "https://api.peec.ai/customer/v1/projects" 2>&1 | head -20

{"content":[{"text":"=== PyPI peec? ===\npeec -> 404\npeec-ai -> 404\npeec-sdk -> 404\n\n=== live API probe without key ===\nHTTP/2 400 \r\ncontent-security-policy: script-src 'self' https://cdn.jsdelivr.net;default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests\r\ncross-origin-opener-policy: same-origin\r\ncross-origin-resource-policy: ?1\r\nreferrer-policy: no-referrer\r\nstrict-transport-security: max-age=15552000; includeSubDomains\r\nx-content-type-options: nosniff\r\nx-dns-prefetch-control: off\r\nx-frame-options: SAMEORIGIN\r\nx-xss-protection: 0\r\nvary: *\r\naccess-control-allow-origin: *\r\naccess-control-allow-methods: GET\r\naccess-control-allow-headers: host, user-agent, accept, via, x-cloud-trace-context, x-forwarded-proto, x-forwarded-for\r\naccess-control-expose-headers: host, user-agent, accept, via, x-cloud-trace-context, x-forwarded-proto, x-forwarded-for\r\ncontent-type: application/json;charset=utf-8\r\nx-trace-id: 49b001cca779a84c511033376d435595\r\nx-download-options: noopen\r\nx-permitted-cross-domain-policies: none\r\ndate: Tue, 22 Sep 2026 21:12:51 GMT\r\n","type":"text"}]}

echo "=== unauth body ==="; curl -sSL -m 12 "https://api.peec.ai/customer/v1/projects" 2>&1 | head -c 500; echo; echo; echo "=== bogus key body ==="; curl -sSL -m 12 -H "x-api-key: pk_test_not_a_real_key" "https://api.peec.ai/customer/v1/projects" 2>&1 | head -c 500; echo

echo "=== pricing page ==="; curl -sSL -m 15 https://peec.ai/pricing 2>&1 | sed 's/<[^>]*>/ /g' | tr -s ' \n' ' \n' | grep -iE "€|\\$|£|month|price|plan|enterprise|starter|pro|premium|seat|prompt|free|trial|credit" | head -60

{"content":[{"text":"=== pricing page ===\n !function(e,r){try{if(e.vector)return void console.log(\"Vector snippet included more than once.\");var t={};t.q=t.q||[];for(var o=[\"load\",\"identify\",\"on\"],n=function(e){return function(){var r=Array.prototype.slice.call(arguments);t.q.push([e,r])}},c=0;c<o.length;c++){var a=o[c];t[a]=n(a)}if(e.vector=t,!t.loaded){var i=r.createElement(\"script\");i.type=\"text/javascript\",i.async=!0,i.src=\"https://cdn.vector.co/pixel.js\";var l=r.getElementsByTagName(\"script\")[0];l.parentNode.insertBefore(i,l),t.loaded=!0}}catch(e){console.error(\"Error loading Vector:\",e)}}(window,document);\r\n t.push([e].concat(Array.prototype.slice.call(arguments, 0)));\r\n \"init capture register register_once register_for_session unregister unregister_for_session getFeatureFlag getFeatureFlagResult isFeatureEnabled reloadFeatureFlags updateEarlyAccessFeatureEnrollment getEarlyAccessFeatures on onFeatureFlags onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep identify setPersonProperties group resetGroups setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags reset get_distinct_id getGroups get_session_id get_session_replay_url alias set_config startSessionRecording stopSessionRecording sessionRecordingStarted captureException loadToolbar get_property getSessionProperty createPersonProfile opt_in_capturing opt_out_capturing has_opted_in_capturing has_opted_out_capturing clear_opt_in_out_capturing debug\".split(\r\n // styled + prefixed so it's easy to spot/filter in prod, quiet otherwise\r\n function capture(event, props) {\r\n log(\"posthog not ready, skipped: \" + event, props);\r\n window.posthog.capture(event, props);\r\n log(\"captured \" + event, props);\r\n\t :root body { background: rgb(247, 247, 247); } (function(){if(window.__pnhc)return;window.__pnhc=true;var p=null,lx=-1,ly=-1;document.addEventListener('pointermove',function(e){lx=e.clientX;ly=e.clientY;},{capture:true,passive:true});document.addEventListener('mouseover',function(e){var t=e.target,n=t&&t.closest?t.closest('nav'):null;if(n)p=t;},{capture:true,passive:true});document.addEventListener('mouseout',function(e){var r=e.relatedTarget;if(!r||!r.closest||!r.closest('nav'))p=null;},{capture:true,passive:true});function go(){if(!p)return;var ok=lx>=0&&[].slice.call(document.elementsFromPoint(lx,ly)).some(function(el){return el===p||p.contains(el)});if(ok)p.dispatchEvent(new MouseEvent('mouseenter',{bubbles:true,cancelable:true,view:window}));p=null;}window.addEventListener('framer:pageview',go,{once:true});window.addEventListener('load',function(){setTimeout(go,300);},{once:true});})(); See brand perception in action. Join us live September 22 ')\"> Not sure which is right for you? Talk to us Product Pricing Resources Partnerships Careers Log in Sign up See brand perception in action. Join us live September 22 ')\"> html body { background: rgb(247, 247, 247); } Pricing for Brands Track and improve your brand visibility across AI platforms with analytics your team will actually enjoy using. Track, analyze, and improve brand performance on AI search platforms through key metrics like Trusted by 3000+ brands and agencies ')\"> ')\"> Trusted by 3000+ brands and agencies ')\"> ')\"> Trusted by 3000+ brands and agencies ')\"> ')\"> Starter Monthly For SEO and content managers getting started with AI Search visibility. Starter Monthly For SEO and content managers getting started with AI Search visibility. Starter Monthly For SEO and content managers getting started with AI Search visibility. Get started This includes: This includes: 50 prompts Choose 3 models Unlimited users Daily tracking frequency 1 project Pro Monthly For SEO teams that need sophisticated AI Search tracking and insights. Pro Monthly For SEO teams that need sophisticated AI Search tracking and insights. Pro Monthly For SEO teams that need sophisticated AI Search tracking and insights. Get started This includes: This includes: 150 prompts Choose 3 models Unlimited users Daily tracking frequency 2 projects Advanced Monthly For marketing teams managing multiple projects with deeper reporting. Advanced Monthly For marketing teams managing multiple projects with deeper reporting. Advanced Monthly For marketing teams managing multiple projects with deeper reporting. Get started This includes: This includes: 350 prompts Choose 3 models Unlimited users Daily tracking frequency 5 projects Multi country Looker Studio integration Enterprise Custom Annual For global brands who need custom coverage, integrations, and dedicated support. Talk to Sales Everything in advanced, plus: Everything in advanced, plus: Fully customizable prompt tracking Choose from all models Daily or weekly tracking frequency Unlimited projects Custom prompt setup API access Single Sign-on (SSO) Up to 13 LLM models tracked Running a GEO agency? Track prompts across multiple brands. Running a GEO agency? Track prompts across multiple brands. Running a GEO agency? Track prompts across multiple brands. See agency pricing See agency pricing Tracking Coverage Tracking Coverage Tracking Coverage Available models Available models Prompts Prompts Active models Active models Frequency Frequency Monthly AI answers Calculated by multiplying tracked prompts by active models and tracking frequency. ')\"> Monthly AI answers Calculated by multiplying tracked prompts by active models and tracking frequency. ')\"> Countries Countries Projects Projects Languages Languages Competitors Competitors Team users Team users Discover Discover Discovery Discovery Brand context Brand context Prompt volume Relative demand for the topic behind each tracked prompt, scored 1–5. ')\"> Prompt volume Relative demand for the topic behind each tracked prompt, scored 1–5. ')\"> Competitor suggestions Competitor suggestions Topic suggestions Topic suggestions Prompt suggestions Prompts worth adding, drawn from your brand context and coverage gaps. ')\"> Prompt suggestions Prompts worth adding, drawn from your brand context and coverage gaps. ')\"> Prompt management Prompt management Prompts from keywords Prompts from keywords Personas Personas Bulk import Bulk import Sub-brand tracking Sub-brand tracking Regions &amp; languages Regions &amp; languages Topics, tags &amp; categories Topics, tags &amp; categories Brand classification Each prompt classified as branded or non-branded. ')\"> Brand classification Each prompt classified as branded or non-branded. ')\"> Intent classification Each prompt classified as informational, commercial, or transactional. ')\"> Intent classification Each prompt classified as informational, commercial, or transactional. ')\"> Measure Measure Brand analytics Brand analytics Visibility overview Your visibility, position, sentiment, and share of voice, tracked daily against competitors ')\"> Visibility overview Your visibility, position, sentiment, and share of voice, tracked daily against competitors ')\"> Brand insights How your brand performs across models, topics, geographies, and competitors. ')\"> Brand insights How your brand performs across models, topics, geographies, and competitors. ')\"> Ads library Prompts where AI answers carry a sponsored placement, and which advertisers appear. ')\"> Ads library Prompts where AI answers carry a sponsored placement, and which advertisers appear. ')\"> Local GEO Local GEO AI Shopping AI Shopping Product catalog upload Fetched from Shopify, or uploaded as a CSV — yours or from Google Merchant Center. ')\"> Product catalog upload Fetched from Shopify, or uploaded as a CSV — yours or from Google Merchant Center. ')\"> SKU-level tracking Visibility, Position, and Win rate on a per-product basis, in addition to brand-level metrics. ')\"> SKU-level tracking Visibility, Position, and Win rate on a per-product basis, in addition to brand-level metrics. ')\"> Top merchants Top merchants Shopping query fanouts Shopping query fanouts Shopping source visibility Domains and URLs AI retrieved when recommending a product. ')\"> Shopping source visibility Domains and URLs AI retrieved when recommending a product. ')\"> Source analytics Source analytics Domain &amp; URL detail view Domain &amp; URL detail view Subdomain tracking Subdomain tracking Fanout overview Fanout overview Retrievals Retrievals Citation share Citation share Source classification Each source classified into a category, like competitor, editorial, reference, or UGC. ')\"> Source classification Each source classified into a category, like competitor, editorial, reference, or UGC. ')\"> Brand Perception Brand Perception Brand attribute scoring The gap between what AI says you are known for, and where you place in the market. ')\"> Brand attribute scoring The gap between what AI says you are known for, and where you place in the market. ')\"> Custom attributes Attributes you define yourself, scored alongside the ones AI answers surface on their own. ')\"> Custom attributes Attributes you define yourself, scored alongside the ones AI answers surface on their own. ')\"> Objections Recurring arguments AI raises against your brand, grouped by meaning and traced to the pages behind them. ')\"> Objections Recurring arguments AI raises against your brand, grouped by meaning and traced to the pages behind them. ')\"> Prompts fact-checked Tracked prompts whose AI answers are checked for claims about your brand against the facts you set. ')\"> Prompts fact-checked Tracked prompts whose AI answers are checked for claims about your brand against the facts you set. ')\"> Facts per brand Statements you set about your brand, used as the reference each claim is checked against. ')\"> Facts per brand Statements you set about your brand, used as the reference each claim is checked against. ')\"> Act Act Gap analysis Sources that appear often and name competitors but not you, by source, domain, subdomain, URL, and host. ')\"> Gap analysis Sources that appear often and name competitors but not you, by source, domain, subdomain, URL, and host. ')\"> Recommended actions Ranked opportunities to improve AI visibility, grouped by earned and owned. ')\"> Recommended actions Ranked opportunities to improve AI visibility, grouped by earned and owned. ')\"> Agent actions Actions generated from your data, using pre-built and custom skills. ')\"> Agent actions Actions generated from your data, using pre-built and custom skills. ')\"> Report Report Visibility impact Visibility impact Visibility lift analysis Visibility lift analysis Visibility lift predictor Visibility lift predictor Custom tables &amp; views Custom tables &amp; views Agent analytics Agent analytics Crawlability audit Which AI bots your robots.txt allows, partially allows, or blocks, across 40+ bots. ')\"> Crawlability audit Which AI bots your robots.txt allows, partially allows, or blocks, across 40+ bots. ')\"> AI referrals Visits arriving on your site from AI assistants. ')\"> AI referrals Visits arriving on your site from AI assistants. ')\"> Crawl insights Which AI bots hit which pages, how often, and the status code returned. ')\"> Crawl insights Which AI bots hit which pages, how often, and the status code returned. ')\"> Automated reporting Automated reporting Shareable dashboards Shareable dashboards Data Studio connector Data Studio connector Data access Data access API API MCP MCP Custom exports (CSV) Custom exports (CSV) Platform, team &amp; support Platform, team &amp; support Role-based permissions Company-wide and per-project access levels, including full and read-only access. ')\"> Role-based permissions Company-wide and per-project access levels, including full and read-only access. ')\"> Single sign-on (SSO) Single sign-on (SSO) Support channels Support channels Onboarding Onboarding Peec agent Peec agent Company context What your company does, so output comes back in your voice. ')\"> Company context What your company does, so output comes back in your voice. ')\"> Project context Per-project context so the Agent answers about the right brand and competitive set. ')\"> Project context Per-project context so the Agent answers about the right brand and competitive set. ')\"> User memory User memory Skills Pre-built workflows for common jobs: reports, diagnostics, and more. ')\"> Skills Pre-built workflows for common jobs: reports, diagnostics, and more. ')\"> Custom skills Custom skills Integrations Integrations CDN &amp; log providers CDN &amp; log providers Google Analytics Google Analytics Starter Starter \"> ChatGPT ChatGPT \"> AI Mode AI Mode \"> AI Overviews AI Overviews \"> Microsoft Copilot Microsoft Copilot \"> Naver AI Naver AI \"> Gemini Gemini 50 50 3 3 daily daily 4500 4500 1 1 1 1 unlimited unlimited unlimited unlimited unlimited unlimited - - 5 5 5 5 4M bot visits 4M bot visits - - - Chat Chat Self-serve Self-serve Vercel Vercel Cloudflare Cloudflare AWS AWS CloudFront CloudFront Google Cloud CDN Google Cloud CDN Wordpress Wordpress Akamai Akamai Generic webhook Generic webhook CSV/CLF Upload CSV/CLF Upload Get started Pro Pro \"> ChatGPT ChatGPT \"> AI Mode AI Mode \"> AI Overviews AI Overviews \"> Microsoft Copilot Microsoft Copilot \"> Naver AI Naver AI \"> Gemini Gemini 150 150 3 3 daily daily 13500 13500 3 3 2 2 unlimited unlimited unlimited unlimited unlimited unlimited - Monthly Monthly 10 10 20 20 10M bot visits 10M bot visits - - - Chat + email Chat + email Self-serve Self-serve Vercel Vercel Cloudflare Cloudflare AWS AWS CloudFront CloudFront Google Cloud CDN Google Cloud CDN Wordpress Wordpress Akamai Akamai Generic webhook Generic webhook CSV/CLF Upload CSV/CLF Upload Get started Advanced Advanced \"> ChatGPT ChatGPT \"> AI Mode AI Mode \"> AI Overviews AI Overviews \"> Microsoft Copilot Microsoft Copilot \"> Naver AI Naver AI \"> Gemini Gemini 350 350 3 3 daily daily 31500 31500 3 3 5 5 unlimited unlimited unlimited unlimited unlimited unlimited Weekly Weekly 25 25 50 50 25M bot visits 25M bot visits - - Chat + email Chat + email Self-serve Self-serve Vercel Vercel Cloudflare Cloudflare AWS AWS CloudFront CloudFront Google Cloud CDN Google Cloud CDN Wordpress Wordpress Akamai Akamai Generic webhook Generic webhook CSV/CLF Upload CSV/CLF Upload Get started Enterprise Enterprise Custom Custom \"> ChatGPT ChatGPT \"> AI Mode AI Mode \"> AI Overviews AI Overviews \"> Microsoft Copilot Microsoft Copilot \"> Naver AI Naver AI \"> Gemini Gemini \"> Claude Sonnet 4 Claude Sonnet 4 Claude Sonnet 4 API \"> GPT 5 Search GPT 5 Search API \"> Grok Grok API \"> Deepseek Deepseek Deepseek API \"> Qwen Qwen Qwen API \"> Mistral Mistral API Meta Spark Meta Spark API \"> Perplexity Perplexity 350 350 unlimited unlimited daily / weekly daily / weekly unlimited unlimited unlimited unlimited unlimited unlimited unlimited unlimited unlimited unlimited unlimited unlimited Weekly Weekly unlimited unlimited unlimited unlimited Custom Custom Dedicated Dedicated Custom Custom Vercel Vercel Cloudflare Cloudflare AWS AWS CloudFront CloudFront Google Cloud CDN Google Cloud CDN Wordpress Akamai Generic webhook CSV/CLF Upload Talk to Sales Add-ons Additional Models Track more AI models without switching plans. \"> ChatGPT ChatGPT \"> AI Mode AI Mode \"> AI Overviews AI Overviews \"> Microsoft Co-pilot Microsoft Co-pilot \"> Perplexity Perplexity \"> Gemini Gemini Add extra models anytime in your dashboard. Starter Price reflects one additional model based on the prompts included in this plan. Annual Starter Price reflects one additional model based on the prompts included in this plan. Annual Starter Price reflects one additional model based on the prompts included in this plan. Annual Pro Price reflects one additional model based on the prompts included in this plan. Annual Pro Price reflects one additional model based on the prompts included in this plan. Annual Pro Price reflects one additional model based on the prompts included in this plan. Annual Advanced Price reflects one additional model based on the prompts included in this plan. Annual Advanced Price reflects one additional model based on the prompts included in this plan. Annual Advanced Price reflects one additional model based on the prompts included in this plan. Annual ')\"> Testimonials Check what the best marketers say about Peec AI. Peec AI offers key insights on AI visibility, helping brands stay at the forefront of discovery in the age of AI and generative search. As ChatGPT, Perplexity, and Deepseek drive traffic and conversions, Peec.ai measures the growth. Crystal Carter Head of SEO Comms Peec AI offers key insights on AI visibility, helping brands stay at the forefront of discovery in the age of AI and generative search. As ChatGPT, Perplexity, and Deepseek drive traffic and conversions, Peec.ai measures the growth. Crystal Carter Head of SEO Comms Peec allows us to pinpoint the exact types of content that are surfaced in specific LLMs. With that visibility, we’ve been able to prioritize our content strategy and drive a 5x year-over-year increase in traffic and demo requests from LLMs. Jon Gitlin SEO Strategist Peec allows us to pinpoint the exact types of content that are surfaced in specific LLMs. With that visibility, we’ve been able to prioritize our content strategy and drive a 5x year-over-year increase in traffic and demo requests from LLMs. Jon Gitlin SEO Strategist Peec avoids the issues we see with other SEO/AEO platforms, where there’s often an overload of features and information that isn't of primary importance. It keeps things simple - set up your prompts, see your AI visibility, and act on top citations. Ethan Smith CEO, Graphite ')\" data-framer-background-image-wrapper=\"true\"> Peec avoids the issues we see with other SEO/AEO platforms, where there’s often an overload of features and information that isn't of primary importance. It keeps things simple - set up your prompts, see your AI visibility, and act on top citations. Ethan Smith CEO Peec avoids the issues we see with other SEO/AEO platforms, where there’s often an overload of features and information that isn't of primary importance. It keeps things simple - set up your prompts, see your AI visibility, and act on top citations. Ethan Smith CEO Peec AI gave us a data-informed view of our LLMO strategy at Glide - virtually overnight. With its insights, our blog posts started ranking for targeted ChatGPT and Perplexity prompts within 24 hours. I am really impressed with the platform, and the exceptional support from the team. Sepy Bazzazi Head of Marketing Peec AI gave us a data-informed view of our LLMO strategy at Glide - virtually overnight. With its insights, our blog posts started ranking for targeted ChatGPT and Perplexity prompts within 24 hours. I am really impressed with the platform, and the exceptional support from the team. Sepy Bazzazi Head of Marketing Peec AI helps us identify what's being cited, adjust our strategy in real-time, and stay ahead of a rapidly evolving search landscape. For our team, the clarity and simplicity of the platform is invaluable when making strategic content decisions. Thomas Smeaton SEO Manager Peec AI helps us identify what's being cited, adjust our strategy in real-time, and stay ahead of a rapidly evolving search landscape. For our team, the clarity and simplicity of the platform is invaluable when making strategic content decisions. Thomas Smeaton SEO Manager As search marketers, our decisions should always be driven by data. Peec AI provides exactly the critical insights we need to stay competitive in the ever-evolving world of search. Artur Kosch General Manager As search marketers, our decisions should always be driven by data. Peec AI provides exactly the critical insights we need to stay competitive in the ever-evolving world of search. Artur Kosch General Manager Peec AI gave us a data-informed view of our LLMO strategy at Glide—virtually overnight. With its insight…

{"content":[{"text":"======== api-reference/company/list-projects ========\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# List Projects\n\n> List the projects of a company\n\n\n\n## OpenAPI\n\n````yaml https://api.peec.ai/customer/v1/openapi/json get /projects\nopenapi: 3.0.3\ninfo:\n  title: Peec AI Customer API\n  description: Development documentation\n  version: 1.0.0\n  contact:\n    name: Peec AI Team\n    email: support@peec.ai\nservers:\n  - url: https://api.peec.ai/customer/v1\nsecurity: []\npaths:\n  /projects:\n    get:\n      tags:\n        - Company\n      summary: List Projects\n      description: List the projects of a company\n      operationId: getProjects\n      parameters:\n        - name: limit\n          in: query\n          required: false\n          schema:\n            default: 1000\n            type: integer\n            minimum: 1\n            maximum: 10000\n        - name: offset\n          in: query\n          required: false\n          schema:\n            default: 0\n            type: integer\n            minimum: 0\n            maximum: 9007199254740991\n        - name: external_id\n          in: query\n          required: false\n          schema:\n            type: string\n        - name: start_date\n          in: query\n          required: false\n          schema:\n            type: string\n            format: date\n            pattern: >-\n              ^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$\n        - name: end_date\n          in: query\n          required: false\n          schema:\n            type: string\n            format: date\n            pattern: >-\n              ^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$\n      responses:\n        '200':\n          description: Success\n          content:\n            application/json:\n              schema:\n                type: object\n                properties:\n                  data:\n                    type: array\n                    items:\n                      type: object\n                      properties:\n                        id:\n                          type: string\n                          example: or_915e742b-396d-4a86-ad57-8bc84e8c2232\n                        name:\n                          type: string\n                          example: Peec AI\n                        status:\n\n======== api-reference/reports/get-brands-report ========\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# Get Brands Report\n\n> Get a report on Brands.\n\n## Aggregation Formulas\n\nWhen aggregating results across multiple rows/dimensions, use the following formulas:\n\n- **sentiment**: `((sum(sentiment_sum) / sum(sentiment_count)) / 2 + 0.5) * 100`\n- **position**: `sum(position_sum) / sum(position_count)`\n- **visibility**: `sum(visibility_count) / sum(visibility_total)`\n- **share_of_voice**: `mention_count / sum(mention_count)`\n\n## `filters` vs `having`\n\n`filters` are **pre-aggregation** row filters (applied as WHERE before GROUP BY). They shrink both the numerator and the denominator of ratio metrics. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `brand_id`. Note that `brand_id` in `filters` shrinks `share_of_voice`'s denominator too — so filtering to one brand collapses SoV to 1.0. Use `having` for `brand_id` if you want SoV preserved.\n\n`having` are **post-aggregation** row filters (applied as HAVING after GROUP BY). They select which aggregated rows are returned and do **not** shrink ratio-metric denominators. Filtering `{field: \"brand_id\", values: [X]}` here returns only brand X's row, but `share_of_voice` still divides X's mentions by mentions across all in-scope brands — so SoV stays in [0, 1]. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `brand_id`.\n\nPopulation fields (`model_id` etc.) are also allowed in `having` but require the matching value in `dimensions` so the column appears in GROUP BY; otherwise the request is rejected.\n\nWhen `dimensions` are requested, the `share_of_voice` denominator follows the same grouping as the numerator. Requesting `prompt_id` as a dimension produces per-(brand × prompt) rows whose `share_of_voice` is the brand's mentions in that prompt divided by all brands' mentions in that prompt.\n\n\n\n## OpenAPI\n\n````yaml https://api.peec.ai/customer/v1/openapi/json post /reports/brands\nopenapi: 3.0.3\ninfo:\n  title: Peec AI Customer API\n  description: Development documentation\n  version: 1.0.0\n  contact:\n    name: Peec AI Team\n    email: support@peec.ai\nservers:\n  - url: https://api.peec.ai/customer/v1\nsecurity: []\npaths:\n  /reports/brands:\n    post:\n      tags:\n        - Reports\n      summary: Get Brands Report\n      description: >-\n        Get a report on Brands.\n\n\n        ## Aggregation Formulas\n\n\n        When aggregating results across multiple rows/dimensions, use the\n        following formulas:\n\n\n        - **sentiment**: `((sum(sentiment_sum) / sum(sentiment_count)) / 2 +\n        0.5) * 100`\n\n        - **position**: `sum(position_sum) / sum(position_count)`\n\n        - **visibility**: `sum(visibility_count) / sum(visibility_total)`\n\n        - **share_of_voice**: `mention_count / sum(mention_count)`\n\n\n        ## `filters` vs `having`\n\n\n        `filters` are **pre-aggregation** row filters (applied as WHERE before\n        GROUP BY). They shrink both the numerator and the denominator of ratio\n        metrics. Allowed fields: `model_id` (deprecated), `model_channel_id`,\n        `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`,\n        `brand_id`. Note that `brand_id` in `filters` shrinks `share_of_voice`'s\n        denominator too — so filtering to one brand collapses SoV to 1.0. Use\n        `having` for `brand_id` if you want SoV preserved.\n\n\n        `having` are **post-aggregation** row filters (applied as HAVING after\n        GROUP BY). They select which aggregated rows are returned and do **not**\n        shrink ratio-metric denominators. Filtering `{field: \"brand_id\", values:\n        [X]}` here returns only brand X's row, but `share_of_voice` still\n        divides X's mentions by mentions across all in-scope brands — so SoV\n        stays in [0, 1]. Allowed fields: `model_id` (deprecated),\n        `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`,\n        `chat_id`, `brand_id`.\n\n","type":"text"}]}

echo "=== openapi spec? ==="; for u in "https://docs.peec.ai/openapi.json" "https://docs.peec.ai/api/openapi.json" "https://api.peec.ai/openapi.json" "https://docs.peec.ai/openapi.yaml"; do echo -n "$u -> "; curl -sSL -m 12 -o /dev/null -w "%{http_code}\n" "$u"; done
echo; echo "=== mcp setup (head) ==="; curl -sSL -m 15 "https://docs.peec.ai/mcp/setup.md" 2>&1 | sed -n '1,60p'

{"content":[{"text":"=== openapi spec? ===\nhttps://docs.peec.ai/openapi.json -> 404\nhttps://docs.peec.ai/api/openapi.json -> 404\nhttps://api.peec.ai/openapi.json -> 404\nhttps://docs.peec.ai/openapi.yaml -> 404\n\n=== mcp setup (head) ===\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n# Setup Guide\n\n> Step-by-step instructions for connecting the Peec AI MCP Server to Claude, Cursor, and other AI tools. Stuck? Email support@peec.ai.\n\n## Server URL\n\nAll platforms use the same URL:\n\n```text theme={null}\nhttps://api.peec.ai/mcp\n```\n\n## Authentication options\n\nThe server accepts two auth methods. Pick based on your client.\n\n* **OAuth 2.0** (default for most clients). The first connection redirects you to Peec AI to sign in and approve access. Your session persists across conversations. Use for Claude Desktop, Claude Web, Cursor, VS Code, Windsurf, and any other client that walks through an OAuth consent screen.\n* **Personal Access Token (PAT).** A long-lived bearer token tied to your Peec user. Use for clients that don't support OAuth, headless setups, CI, or when you want to keep the token in your own secrets manager.\n\n### Create a Personal Access Token\n\n<Steps>\n  <Step title=\"Open API Keys\">\n    Sign in to [app.peec.ai](https://app.peec.ai) and go to **API Keys** in the sidebar.\n  </Step>\n\n  <Step title=\"Create a token\">\n    In the **Personal Access Tokens** section click **Create token**. Give it a name (e.g. `Claude Desktop`, `Cursor laptop`) and pick an expiration: **Never**, **30 days**, **60 days**, or **90 days**.\n  </Step>\n\n  <Step title=\"Copy the token\">\n    Copy the token immediately. It's shown only once. Treat it like a password — anyone with it can act as you in Peec via MCP.\n  </Step>\n</Steps>\n\nTokens act on your user, so every call respects the same project access and organization-owner checks as your dashboard session. The **Last Used** column on the API Keys page updates each time the token is used, so you can spot tokens you can safely revoke. Revoke a token any time from the same page; clients using it lose access immediately.\n\n## Claude Desktop and Web (claude.ai)\n\n<Steps>\n  <Step title=\"Open settings\">\n    Open Claude Desktop and go to **Settings** or \\*\\*Customize \\*\\*(gear icon), then **Connectors**.\n  </Step>\n\n  <Step title=\"Browse connector\">\n    Search for and click on the **Peec AI** connector and install it\n  </Step>\n\n  <Step title=\"Authorize\">\n    Click **Connect**. You'll be redirected to Peec AI to sign in. Once authorized, return to the Claude Desktop.\n\n    <Info>\n      Please note that only workspace Admins in Claude can add the connector. If you are not able to, you might want to check with your admin\n    </Info>\n\n    <Frame>\n","type":"text"}]}

cd /tmp && curl -sSL -m 20 "https://api.peec.ai/customer/v1/openapi/json" -o peec_openapi.json -w "HTTP %{http_code}, %{size_download} bytes\n" 2>&1; echo "--- top-level ---"; python3 -c "import json;d=json.load(open('peec_openapi.json'));print('openapi',d.get('openapi'));print('servers',d.get('servers'));print('title',d['info'].get('title'));ps=list(d.get('paths',{}));print('num paths',len(ps));print('\n'.join(ps[:40]))" 2>&1 | head -60

{"content":[{"text":"HTTP 200, 516939 bytes\n--- top-level ---\nopenapi 3.0.3\nservers [{'url': 'https://api.peec.ai/customer/v1'}]\ntitle Peec AI Customer API\nnum paths 74\n/reports/brands\n/reports/domains\n/reports/urls\n/sources/urls/content\n/queries/search\n/queries/shopping\n/products/list\n/products/detail\n/products/attributes\n/products/summary\n/products/trend\n/products/performance\n/products/demand\n/products/merchants\n/products/create\n/products/update\n/products/delete\n/categories\n/categories/create\n/categories/update\n/categories/delete\n/global-brands\n/brand-perception/brand-attributes\n/brand-perception/attribute-rankings\n/brand-perception/attribute-sources\n/brand-perception/competitive-breakdown\n/brand-perception/objections\n/brand-perception/objection-sources\n/brand-perception/industries\n/brand-perception/attribute-clusters\n/brand-perception/attribute-clusters/edit\n/brand-perception/attribute-clusters/create\n/brands\n/brands/social-channels\n/brands/suggestions\n/brands/suggestions/{brand_suggestion_id}/accept\n/brands/suggestions/{brand_suggestion_id}/reject\n/brands/{brand_id}\n/brands/{brand_id}/social-channels\n/prompts\n","type":"text"}]}

cd /tmp && python3 -c "
import json
d=json.load(open('peec_openapi.json'))
p=d['paths']['/reports/brands']['post']
rb=p.get('requestBody',{})
print('=== /reports/brands POST requestBody ===')
print(json.dumps(rb, indent=1)[:2500])
"

{"content":[{"text":"=== /reports/brands POST requestBody ===\n{\n \"required\": true,\n \"content\": {\n  \"application/json\": {\n   \"schema\": {\n    \"type\": \"object\",\n    \"properties\": {\n     \"project_id\": {\n      \"description\": \"Required if using a company api key\",\n      \"example\": \"or_f45b94ba-5e35-4982-93ed-285e72ee14eb\",\n      \"type\": \"string\"\n     },\n     \"limit\": {\n      \"default\": 1000,\n      \"type\": \"integer\",\n      \"minimum\": 1,\n      \"maximum\": 10000\n     },\n     \"offset\": {\n      \"default\": 0,\n      \"type\": \"integer\",\n      \"minimum\": 0,\n      \"maximum\": 500000\n     },\n     \"start_date\": {\n      \"default\": \"2026-01-01\",\n      \"description\": \"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21\",\n      \"example\": \"2025-09-22\",\n      \"type\": \"string\",\n      \"format\": \"date\",\n      \"pattern\": \"^(?:(?:\\\\d\\\\d[2468][048]|\\\\d\\\\d[13579][26]|\\\\d\\\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\\\d|30)|(?:02)-(?:0[1-9]|1\\\\d|2[0-8])))$\"\n     },\n     \"end_date\": {\n      \"default\": \"2026-01-01\",\n      \"description\": \"full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21\",\n      \"example\": \"2025-09-22\",\n      \"type\": \"string\",\n      \"format\": \"date\",\n      \"pattern\": \"^(?:(?:\\\\d\\\\d[2468][048]|\\\\d\\\\d[13579][26]|\\\\d\\\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\\\d|30)|(?:02)-(?:0[1-9]|1\\\\d|2[0-8])))$\"\n     },\n     \"previous_start_date\": {\n      \"description\": \"Start of an explicit comparison window for deltas. Provide together with previous_end_date, or omit both to auto-derive an equal-length window immediately before [start_date, end_date].\",\n      \"type\": \"string\",\n      \"format\": \"date\",\n      \"pattern\": \"^(?:(?:\\\\d\\\\d[2468][048]|\\\\d\\\\d[13579][26]|\\\\d\\\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\\\d|30)|(?:02)-(?:0[1-9]|1\\\\d|2[0-8])))$\"\n     },\n     \"previous_end_date\": {\n      \"description\": \"End of the explicit comparison window. Provide together with previous_start_date, or omit both to auto-derive.\",\n      \"type\": \"string\",\n      \"format\": \"date\",\n      \"pattern\": \"^(?:(?:\\\\d\\\\d[2468][048]|\\\\d\\\\d[13579][26]|\\\\d\\\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\\\d|30)|(?:02)-(?:0[1-9]|1\\\\d|2[0-8])))$\"\n     },\n     \"dimensions\": {\n      \"example\": [\n       \"tag_\n","type":"text"}]}

cd /tmp && python3 -c "
import json
d=json.load(open('peec_openapi.json'))
p=d['paths']['/reports/brands']['post']
sch=p['requestBody']['content']['application/json']['schema']['properties']
print('REQUEST fields:', list(sch.keys()))
for f in ['dimensions','metrics','filters','having']:
    if f in sch:
        print('\n--',f,'--')
        print(json.dumps(sch[f])[:700])
resp=p['responses']['200']['content']['application/json']['schema']
print('\n=== 200 response props ===')
print(json.dumps(resp, indent=1)[:1500])
"

{"content":[{"text":"REQUEST fields: ['project_id', 'limit', 'offset', 'start_date', 'end_date', 'previous_start_date', 'previous_end_date', 'dimensions', 'filters', 'having', 'order_by', 'include_previous_period']\n\n-- dimensions --\n{\"example\": [\"tag_id\", \"model_id\"], \"description\": \"Dimensions to break down the report by.\", \"type\": \"array\", \"items\": {\"type\": \"string\", \"enum\": [\"prompt_id\", \"model_id\", \"model_channel_id\", \"tag_id\", \"topic_id\", \"date\", \"week\", \"month\", \"country_code\", \"chat_id\"]}}\n\n-- filters --\n{\"description\": \"Pre-aggregation row filters (applied as WHERE before grouping). Shrinks both the numerator and the denominator of ratio metrics. Allowed fields: `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id`, `brand_id`. Filtering by `brand_id` here also shrinks `share_of_voice`'s denominator \\u2014 so SoV collapses to 1.0 when scoping to a single brand. If you want SoV preserved (X's share against all in-scope brands), put `brand_id` in `having` instead. Multiple filters are AND'd.\", \"example\": [{\"field\": \"model_id\", \"operator\": \"in\", \"values\": [\"gpt-4o-search\"]}], \"type\": \"array\", \"items\": {\"anyOf\": [{\"type\": \"object\", \"properties\n\n-- having --\n{\"description\": \"Post-aggregation row filters (applied as HAVING after grouping). Selects which aggregated rows are returned without shrinking ratio-metric denominators. Multiple filters are AND'd together.\\n\\nPopulation fields \\u2014 `model_id` (deprecated), `model_channel_id`, `country_code`, `prompt_id`, `tag_id`, `topic_id`, `chat_id` \\u2014 and `brand_id` take `{field, operator, values}` with operator `in` or `not_in`. Population fields require the matching value in `dimensions` so the column appears in GROUP BY.\\n\\nMetric fields \\u2014 `visibility`, `share_of_voice`, `sentiment`, `position` \\u2014 take `{field, operator, value}` with operator `gt`, `gte`, `lt` or `lte`, and need no mat\n\n=== 200 response props ===\n{\n \"type\": \"object\",\n \"properties\": {\n  \"data\": {\n   \"type\": \"array\",\n   \"items\": {\n    \"type\": \"object\",\n    \"properties\": {\n     \"brand\": {\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"type\": \"string\",\n        \"example\": \"kw_915e742b-396d-4a86-ad57-8bc84e8c2232\"\n       },\n       \"name\": {\n        \"type\": \"string\",\n        \"example\": \"Peec AI\"\n       }\n      },\n      \"required\": [\n       \"id\",\n       \"name\"\n      ]\n     },\n     \"prompt\": {\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"type\": \"string\",\n        \"example\": \"pr_93f790de-5b7a-45ee-b782-61103c81f20d\"\n       }\n      },\n      \"required\": [\n       \"id\"\n      ]\n     },\n     \"model\": {\n      \"deprecated\": true,\n      \"description\": \"Deprecated: use model_channel instead\",\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"type\": \"string\",\n        \"example\": \"gpt-4o-search\"\n       }\n      },\n      \"required\": [\n       \"id\"\n      ]\n     },\n     \"model_channel\": {\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"type\": \"string\",\n        \"example\": \"openai-1\"\n       }\n      },\n      \"required\": [\n       \"id\"\n      ]\n     },\n     \"tag\": {\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"type\": \"string\",\n        \"example\": \"tg_23abec5b-100a-4261-9ee7-1effe68f0149\"\n       }\n      },\n      \"required\": [\n       \"id\"\n      ]\n     },\n     \"topic\": {\n      \"type\": \"object\",\n      \"properties\": {\n       \"id\": {\n        \"typ\n","type":"text"}]}

cd /tmp && python3 -c "
import json
d=json.load(open('peec_openapi.json'))
item=d['paths']['/reports/brands']['post']['responses']['200']['content']['application/json']['schema']['properties']['data']['items']['properties']
print('ALL response data-item fields:')
for k,v in item.items():
    print(' -',k, '|', v.get('type'), '|', str(v.get('example',''))[:30], '|', str(v.get('description',''))[:50])
"

{"content":[{"text":"ALL response data-item fields:\n - brand | object |  | \n - prompt | object |  | \n - model | object |  | Deprecated: use model_channel instead\n - model_channel | object |  | \n - tag | object |  | \n - topic | object |  | \n - country_code | string | US | \n - chat | object |  | \n - date | string | 2025-03-15 | \n - week | string | 2025-03-10 | Start (Monday) of the ISO week bucket.\n - month | string | 2025-03-01 | First day of the month bucket.\n - share_of_voice | number | 0.15 | Share of total mentions attributed to this brand w\n - mention_count | number | 42 | \n - visibility | number | 0.5 | \n - visibility_count | number | 5 | \n - visibility_total | number | 10 | \n - sentiment | number | 50 | \n - sentiment_sum | number | 0 | \n - sentiment_count | number | 10 | \n - position | number | 1.5 | \n - position_sum | number | 15 | \n - position_count | number | 10 | \n - previous | object |  | Same metrics computed over the requested compariso\n","type":"text"}]}

{"content":[{"text":"===== MOCK MODE =====\nMODE: --mock (offline sample data; no API key used)\nWindow: 2026-08-01 .. 2026-08-31  |  1 project(s)\n\nBrand             Visibility  ShareOfVoice  Mentions  Position  Sentiment\n-------------------------------------------------------------------------\nAcme                   62.0%         34.0%        51      1.80         71\nGlobex                 48.0%         27.0%        40      2.40         64\nInitech                31.0%         18.0%        27      3.10         58\n\nvisibility = how often the brand is mentioned; share_of_voice = its slice of all mentions;\nposition = avg rank in the answer (lower is better); sentiment = 0-100 tone.\n\n===== LIVE MODE (no key set — expect clean BLOCKED) =====\n\nBLOCKED by the API: HTTP 0: No API key. Set PEEC_API_KEY or pass api_key=... (Enterprise plan; create one at app.peec.ai/api-keys)\nexit=2\n","type":"text"}]}

{"content":[{"text":"=== live call with a bogus key (proves request wiring hits the real API) ===\n\nBLOCKED by the API: HTTP 401: Invalid API Key\n-> The Customer API is Enterprise-only. Create a key at https://app.peec.ai/api-keys and export PEEC_API_KEY.\nexit=2\n","type":"text"}]}

cd /sandbox/repo/peec_example && ls -la && echo "--- syntax check ---" && python3 -m py_compile peec_client.py demo.py && echo "OK: both files compile" && echo "--- final mock run ---" && python3 demo.py --mock | head -8

{"content":[{"text":"total 32\ndrwx------ 3 root root 4096 Sep 22 21:14 .\ndrwxr-xr-x 4 root root 4096 Sep 22 21:13 ..\n-rw------- 1 root root 3335 Sep 22 21:14 README.md\ndrwx------ 2 root root 4096 Sep 22 21:14 __pycache__\n-rw------- 1 root root 4457 Sep 22 21:14 demo.py\n-rw------- 1 root root 4525 Sep 22 21:13 peec_client.py\n--- syntax check ---\nOK: both files compile\n--- final mock run ---\nMODE: --mock (offline sample data; no API key used)\nWindow: 2026-08-01 .. 2026-08-31  |  1 project(s)\n\nBrand             Visibility  ShareOfVoice  Mentions  Position  Sentiment\n-------------------------------------------------------------------------\nAcme                   62.0%         34.0%        51      1.80         71\nGlobex                 48.0%         27.0%        40      2.40         64\nInitech                31.0%         18.0%        27      3.10         58\n","type":"text"}]}