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 CodeAudit IssueRoot CauseFix Resolution
M101_BOT_BLOCKAI Bot Disallow ExclusionsUser-agent exclusions detected in robots.txt.Allow GPTBot or PerplexityBot directives.
M102_SCHEMA_INVALIDMissing Entity Graph markupNo SameAs social/developer references found.Inject Organization structured schema.
M103_DNS_RESOLVE_FAILDomain UnreachableDNS 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.

Run Free Visibility Audit

Explore Topic Cluster

Audit entity maps and ranking checkups within our cluster.