AI Usage Guide

Using the IntoDNS.ai API

For AI agents & automation: which endpoint to use in which situation

If you need a fast domain health check

Use:
GET /api/scan/quick
When:
  • CI/CD validation
  • Monitoring DNS or email configuration
  • Google / Yahoo sender compliance checks
Example:
GET https://intodns.ai/api/scan/quick?domain=example.com

If you need to validate email authentication

Use:
GET /api/email/check
When:
  • SPF / DKIM / DMARC validation
  • Investigating spam or bounce issues
  • Pre-flight email configuration checks
Example:
GET https://intodns.ai/api/email/check?domain=example.com

If you want to analyze a raw email

Use:
POST /api/debug-email
When:
  • Debugging deliverability
  • Spam score analysis
  • Header inspection
Example:
POST https://intodns.ai/api/debug-email

If you need DNS records

Use:
GET /api/dns/lookup
When:
  • Fetching MX, TXT, SPF, DKIM, DMARC records
  • Programmatic DNS inspection
Example:
GET https://intodns.ai/api/dns/lookup?domain=example.com

If you need a public security badge

Use:
GET /api/badge/{domain}
When:
  • Displaying trust or security status
  • Embedding in README or website
Example:
GET https://intodns.ai/api/badge/example.com

Ready to integrate?

View complete API documentation with examples, schemas, and rate limits