Developer API Documentation & Pipeline Specs
Integrate real-time crawler audits and schema checks into your developer workflow and continuous integrations.
REST Endpoint Specifications
Request payload format to perform automated website crawlers audits:
POST https://miiiira.com/api/v1/audit
// Headers:
Authorization: Bearer YOUR_API_SECRET_TOKEN
Content-Type: application/json
// Payload:
{
"domain": "example.com",
"crawl_agents": ["GPTBot", "ClaudeBot", "PerplexityBot"]
}// Response (200 OK):
{
"status": "success",
"domain": "example.com",
"scores": {
"overall": 85,
"crawl": 40,
"schema": 15,
"semantic": 30
},
"issues_detected": 1
}Pipeline Architecture Overview
Miiiira\'s client-side auditing scanner process sequence during active domains checkup:
+------------------+ +------------------+ +------------------+
| Domain Input | --> | DNS Lookup | --> | Robots Parser |
+------------------+ +------------------+ +------------------+
│
▼
+------------------+ +------------------+ +------------------+
| Score Aggregator | <-- | Semantic Audit | <-- | Schema Parser |
+------------------+ +------------------+ +------------------+
Diagnostic Error Code Map
Common errors returned by the scanner and resolution checklist options:
| Error Code | Audit Issue | Root Cause | Fix Resolution |
|---|---|---|---|
| M101_BOT_BLOCK | AI Bot Disallow Exclusions | User-agent exclusions detected in robots.txt. | Allow GPTBot or PerplexityBot directives. |
| M102_SCHEMA_INVALID | Missing Entity Graph markup | No SameAs social/developer references found. | Inject Organization structured schema. |
| M103_DNS_RESOLVE_FAIL | Domain Unreachable | DNS lookup failed during scan. | Verify domain availability status. |
Check Your Site's AI Citations Compatibility
Run a real-time crawl audit and review immediate structured schema recommendation logs.
Explore Topic Cluster
Audit entity maps and ranking checkups within our cluster.