Developer API

Valdos API

Audit any website's credibility programmatically. Returns a structured JSON report with a 0–100 score, tech stack, reputation data, and AI analysis.

Available on Max and Custom plans

50 requests per day. API keys can be generated in your account settings.

Quick Start

# Audit a website
curl -X POST https://valdos.pages.dev/api/v1/audit   -H "Content-Type: application/json"   -H "X-API-Key: vd_live_your_key_here"   -d '{"url": "example.com"}'

Authentication

Pass your API key in the X-API-Key header, or as a ?key= query parameter.

Endpoint

POST /api/v1/audit

Request Body

url string, required — The website URL to audit

lang string, optional — Language for AI analysis (en or zh, default en)

Response

{
  "ok": true,
  "url": "example.com",
  "score": 72,
  "label": "Moderate",
  "scanned_at": "2026-06-28T12:00:00Z",
  "tech_stack": ["React", "Next.js"],
  "page_health": {
    "has_ssl": true,
    "has_privacy_policy": true,
    "broken_links": []
  },
  "monetization": {
    "detected": ["ads"],
    "pricing_transparent": false
  },
  "reputation": {
    "domain_age_days": 3650,
    "registrar": "Cloudflare",
    "has_dnssec": true
  },
  "red_flags": [],
  "green_flags": [],
  "ai_analysis": "This website appears..."
}

Errors

401Missing or invalid API key

403API access requires Max or Custom plan

429Daily limit reached (50/day)

500Audit failed (invalid URL, timeout, etc.)

Rate Limiting

The API allows 50 requests per day, resetting at midnight UTC. Responses include cached results for recently-audited URLs, which don't count against your quota.