MedusAIPM Beta Documentation

DugganUSA AI Presence Management — Beta User Guide

Patent Notice: MedusAIPM is Patent #102 in the DugganUSA portfolio.

What Is AIPM?

AI Presence Management (AIPM) measures how visible and accurately represented your brand is to AI models. As AI-powered search and recommendations replace traditional search, companies need to know: Do the models know you? Do they get the facts right? Would they recommend you?

MedusAIPM audits your domain across multiple frontier AI models and combines that with a structural readiness assessment of your website.

API Endpoints

Base URL: https://analytics.dugganusa.com Authentication: Authorization: Bearer <api_key>

Register for an API key at https://analytics.dugganusa.com/stix/register

`POST /api/v1/aipm/audit`

Runs a full AIPM audit (perception + structure) for a given domain. Queries 3 frontier AI models and evaluates structural readiness.

Request Body:

{
  "domain": "example.com"
}

Example:

curl -X POST https://analytics.dugganusa.com/api/v1/aipm/audit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

`POST /api/v1/aipm/nps`

Quick NPS (Net Promoter Score) check — returns how likely each AI model is to recommend the brand, without a full structural audit.

Request Body:

{
  "domain": "example.com"
}

Example:

curl -X POST https://analytics.dugganusa.com/api/v1/aipm/nps \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

`POST /api/v1/aipm/optimize`

Analyzes your site’s structure and generates specific fix recommendations to improve your AIPM score.

Request Body:

{
  "domain": "example.com"
}

Example:

curl -X POST https://analytics.dugganusa.com/api/v1/aipm/optimize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

`GET /api/v1/aipm/leaderboard`

Returns the current AIPM leaderboard — top-scoring domains across all audits.

Example:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://analytics.dugganusa.com/api/v1/aipm/leaderboard"

`GET /api/v1/aipm/history/:domain`

Returns score history for a specific domain over time. Useful for tracking improvement after optimizations.

Example:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://analytics.dugganusa.com/api/v1/aipm/history/example.com"

Scoring Methodology

The AIPM Combined Score blends two dimensions:

Component	Weight
AI Perception Score	60%
Structural Readiness Score	40%

Epistemic Cap: All scores are capped at 95/95 — no domain can claim perfect AI presence because model knowledge evolves continuously.

AI Perception Scoring

MedusAIPM queries three frontier AI models and evaluates responses across five dimensions:

Models Queried:

GPT-4o (OpenAI)
Gemini 2.5 Flash (Google)
Perplexity Sonar

Perception Dimensions

Dimension	What It Measures
Awareness	Does the model know your brand exists?
Accuracy	Does it get the facts right about you?
Sentiment	What tone does the model use when describing you?
Recommendation	Would it send customers your way?
NPS	Net Promoter Score — AI models as respondents

AIPM-NPS Calculation

Each model returns a confidence score from 0–10 for whether it would recommend the brand. These scores are classified:

Score	Category
9–10	Promoter
7–8	Passive
0–6	Detractor

AIPM-NPS = %Promoters − %Detractors

This applies the classic NPS methodology but uses AI models as the respondent pool instead of human customers.

Structural Readiness Scoring

The structural score evaluates how well your website is prepared for AI crawlers and knowledge extraction:

Factor	Weight
`robots.txt` (AI crawler directives)	25%
LD-JSON (structured data)	25%
Semantic HTML	20%
Sitemap	15%
Meta tags	15%

Tier Access & Rate Limits

Tier	Price	Audits/Day	Features
Free	$0	1	Single domain audit
Professional	$495/mo	10	Multi-domain + historical tracking
Enterprise	$2,495/mo	Unlimited	Leaderboard access + historical tracking + bulk audits

Register at https://analytics.dugganusa.com/stix/register

Fortune 500 Leaderboard (Current)

Live results from MedusAIPM audits of major companies:

Company	Combined Score	Structure Score
Zscaler	72	76
CrowdStrike	69	67
UnitedHealth Group	67	72
DugganUSA	66	86
Target	61	54
Palo Alto Networks	53	25
Best Buy	42	3

Published Audits

Detailed write-ups from real AIPM audits:

Butterbot Tools

MedusAIPM is also available through Butterbot (our AI assistant) with these tool commands:

Tool	Description
`audit_ai_presence`	Run a full AIPM audit for any domain
`check_ai_nps`	Quick NPS score — how AI models rate a brand
`optimize_ai_presence`	Get structural fix recommendations

Quick Start

Register at https://analytics.dugganusa.com/stix/register
Get your API key from the dashboard
Run your first audit:

curl -X POST https://analytics.dugganusa.com/api/v1/aipm/audit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "yourdomain.com"}'

Review your scores — Combined, Perception, and Structure
Improve your structure score by adding LD-JSON, semantic HTML, a sitemap, and AI-friendly robots.txt directives