Skip to content
VectorCite
Free audit

Programmatic AEO audits

Three free public endpoints. Same Mirror Engine, same rubric, same Fix Kit output as the dashboard. Agencies integrate VectorCite into their own client reporting without writing the engine themselves.

Base URL https://vectorcite.digiocular.com. For a domain’s quick grade, see the public grade API.

Single-page audit

POST /api/public-audit/run

Audit a single URL against a single buyer query. Returns a slug pointing to the shareable result page at /audit/{slug}.

Free-tier limits

  • 5 audits / day per IP, 3 / day per email (durable DB cap + edge cap).
  • Cold-worker probe: 5-8s (first call), 1-3s warm.
  • Every result gets a permanent, indexable link you can share.
Request
curl -X POST https://vectorcite.digiocular.com/api/public-audit/run \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "query": "best CRM for small agencies",
    "email": "you@your-company.com"
  }'
Response
{ "slug": "qFpN2eOo8", "score": 58 }

Site-wide audit

POST /api/public-audit/site

Crawl up to 8 pages from a domain’s sitemap, expand the query into 4 intent variants, run the Mirror Engine over the full grid, and return a site-wide scorecard.

Free-tier limits

  • 1 site audit / day per IP (heavy operation, ~30-90s warm).
  • Max 8 pages × 4 queries = 32 probe cells per call.
  • Result page indexable at /audit/site/{slug}.
Request
curl -X POST https://vectorcite.digiocular.com/api/public-audit/site \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "digiocular.com",
    "query": "AI website design agency",
    "email": "you@your-company.com"
  }'
Response
{
  "slug": "abc12345",
  "score": 64,
  "pagesAudited": 8,
  "queriesUsed": 4
}

Schema verifier

POST /api/audit/verify-schema

The closed-loop “did my Fix Kit go live?” check. Re-crawls a URL, parses every <script type="application/ld+json"> block, and returns the valid types and any errors.

Free-tier limits

  • 5 calls / day per IP (shared with audit-ip tier).
  • expectedType is optional: omit it to list every type found.
Request
curl -X POST https://vectorcite.digiocular.com/api/audit/verify-schema \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-site.com/article",
    "expectedType": "Article"
  }'
Response
{
  "live": true,
  "blockCount": 2,
  "validCount": 2,
  "types": ["Article", "FAQPage"],
  "errors": [],
  "matched": true,
  "detail": "2 JSON-LD blocks parsed cleanly. Types: Article, FAQPage."
}

Need higher limits or programmatic access at scale?

Pro tier lifts the daily caps and exposes the full dashboard API (auth’d token, authenticated probe queue, results polling, monitored-query portfolio CRUD). Email digiocular@gmail.com for agency-tier API access.

Quick grader APISee plans