# AIScan Agent API

**Canonical:** https://apis.io/apis/getaiscan-app/aiscan-agent-api/  
**Provider:** AIScan — https://apis.io/providers/getaiscan-app/  
**Base URL:** https://api.getaiscan.app  
**Documentation:** https://getaiscan.app/

AIScan Agent API is one of 2 APIs that [AIScan](https://apis.io/providers/getaiscan-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include AI Visibility, Website Auditing, x402, Agentic Commerce, and agent-native. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Pay-per-capability REST API for AI-visibility auditing: five cheap HTTP checks (site health and AI-crawler access, llms.txt, Schema.org JSON-LD, agent files, MCP discoverability), four category scores (AEO, GEO, Agent Readiness, MCP Readiness), a full audit, generated llms.txt / mcp.json / SKILL.md fix files, a fix pack, a competitor comparison, a bundled full report, and three Brand Visibility capabilities that measure brand mentions across 30 AI answers. Every capability is POST /api/agent/{capability} with a JSON body and an x402 V2 payment in the PAYMENT-SIGNATURE header (a signed payload settled through the Coinbase CDP facilitator, or a Base USDC transfer tx hash); an unpaid call returns HTTP 402 with the price. GET /api/agent/index is the free catalog. 20 operations across 20 paths, OpenAPI 3.1.0 version 5.9.4 at https://api.getaiscan.app/openapi.json with servers[] https://api.getaiscan.app.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/agent/check_health` | Site availability, robots.txt, AI crawler access (GPTBot, ClaudeBot, PerplexityBot), sitemap presence |
| POST | `/api/agent/check_llms_txt` | llms.txt existence and quality check: sections, links, statistics |
| POST | `/api/agent/check_schema` | Schema.org JSON-LD detection: types found, FAQ schema, Organization schema |
| POST | `/api/agent/check_agent_files` | openapi.json, ai-plugin.json, x402 payment support detection |
| POST | `/api/agent/check_mcp` | MCP discoverability: /.well-known/mcp.json, agent.json, MCP Server Card |
| POST | `/api/agent/score_aeo` | Full AEO (AI Search Visibility) score 0-100 with detailed checks |
| POST | `/api/agent/score_geo` | Full GEO (Citation Readiness) score 0-100 with detailed checks |
| POST | `/api/agent/score_agent` | Full Agent Readiness score 0-100 with detailed checks |
| POST | `/api/agent/score_mcp` | Full MCP Readiness score 0-100, the only scanner that checks this |
| POST | `/api/agent/full_audit` | Complete audit: all 4 scores (AEO, GEO, Agent, MCP), 80+ checks |
| POST | `/api/agent/generate_llms_txt` | Generate a ready-to-deploy llms.txt tailored to the site |
| POST | `/api/agent/generate_mcp_json` | Generate ready-to-deploy mcp.json + agent.json for the site |
| POST | `/api/agent/fix_pack` | Copy-paste fix instructions for every failed check |
| POST | `/api/agent/generate_skill` | Generate a ready-to-run SKILL.md fix file that Claude Code and other AI coding agents execute to apply every fix automatically |
| POST | `/api/agent/compare` | Gap analysis vs a competitor URL: who wins each category and why |
| POST | `/api/agent/full_report` | Everything: full audit + fix pack + generated llms.txt and mcp.json |
| POST | `/api/agent/visibility_check` | Brand visibility in AI answers: AIScan runs 30 realistic niche prompts through a frontier AI model - mention rate, share of voice, who gets recommended inste... |
| POST | `/api/agent/visibility_vs_competitor` | Head-to-head brand visibility in AI answers: 30 niche prompts, both brands measured on the same answers - mention rates, share of voice, verdict. Params: bra... |
| POST | `/api/agent/visibility_fix_pack` | Ready-to-deploy fix materials for weak visibility areas: citable passages, FAQ schema JSON-LD, llms.txt sections. Params: brand + niche + weak_spots array (f... |
| GET | `/api/agent/index` | Free capability catalog with prices and endpoints |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/getaiscan-app/refs/heads/main/openapi/getaiscan-app-openapi.json
- **OpenAPI** — https://api.getaiscan.app/openapi.json
- **OpenAPI** — https://getaiscan.app/openapi.json
- **Documentation** — https://getaiscan.app/llms.txt
- **APIReference** — https://api.getaiscan.app/openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/getaiscan-app/refs/heads/main/overlays/getaiscan-app-openapi-overlay.yaml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/getaiscan-app/refs/heads/main/mcp/getaiscan-app-tool-crosswalk.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/getaiscan-app/refs/heads/main/apis.yml

## Other AIScan APIs (1)

- [AIScan A2A Agent](https://apis.io/apis/getaiscan-app/aiscan-a2a-agent/)

## Tags

AI Visibility, Website Auditing, x402, Agentic Commerce, agent-native

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/getaiscan-app/aiscan-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/getaiscan-app/.
