Analyze Domain
Domain Authority Analysis
Enter a domain to analyze its historical legitimacy using Wayback Machine snapshots and AI-powered evaluation.
API Documentation
Use these endpoints to integrate DomainIQ into your own workflows.
🔑 Authentication
All API endpoints require an api_key parameter.
API Key: Include as "api_key" in request body (POST) or query param (GET/DELETE)
POST /api/analyze
Start a new domain analysis. Supports single URL or batch.
curl -X POST https://domainiq.scorpion.codes/api/analyze \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"url": "example.com"
}'
# Batch mode:
curl -X POST https://domainiq.scorpion.codes/api/analyze \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"urls": ["example1.com", "example2.com"]
}'
# Response:
{
"success": true,
"job_ids": ["abc123de"],
"message": "Started analysis for 1 domain(s)"
}
GET /api/status/{job_id}
Check real-time progress of an analysis job.
curl "https://domainiq.scorpion.codes/api/status/abc123de"
# Response:
{
"success": true,
"progress": {
"job_id": "abc123de",
"status": "analyzing",
"domain": "example.com",
"progress_pct": 65.0,
"current_step": "Analyzing screenshot 3/5...",
"years_found": [2005, 2010, 2015, 2020, 2024],
"total_snapshots": 5,
"screenshots_taken": 5,
"screenshots_analyzed": 3
}
}
GET /api/results/{job_id}
Get complete analysis results including authority score and screenshot evaluations.
curl "https://domainiq.scorpion.codes/api/results/abc123de" # Response includes: # - authority_score (0-100) # - verdict: "good" | "suspicious" | "bad" # - snapshot_scores: per-screenshot analysis # - flags_summary: detected issues
GET /api/history
List all past analysis jobs.
curl "https://domainiq.scorpion.codes/api/history?limit=20&offset=0"
DELETE /api/job/{job_id}?api_key=YOUR_KEY
Delete a job and all associated screenshots.
curl -X DELETE "https://domainiq.scorpion.codes/api/job/abc123de?api_key=YOUR_KEY"