Public API Docs

Tech Detector API

Scan any public website and get back the technologies the detector finds. This page is safe to share with anyone who needs to call the API.

Authentication

Send the API key in the x-api-key header on protected endpoints.

x-api-key: <your-api-key>

Health Check

GET /health

curl https://ryszards-mac-mini.tail8a9cf4.ts.net/health

Analyze Endpoint

POST /analyze

curl -X POST https://ryszards-mac-mini.tail8a9cf4.ts.net/analyze \
  -H "content-type: application/json" \
  -H "x-api-key: <your-api-key>" \
  -d '{"url":"https://www.shopify.com","timeout_seconds":60}'

Request Body

{
  "url": "https://www.shopify.com",
  "timeout_seconds": 60
}
  • url is required and must be a valid public HTTP or HTTPS URL.
  • timeout_seconds is optional and must be between 5 and 180.

Response Shape

{
  "url": "https://www.shopify.com",
  "scan_type": "full",
  "scanner": "browser_deep_scan",
  "technologies": [
    {
      "name": "Shopify",
      "version": null,
      "confidence": 100,
      "categories": ["Ecommerce"],
      "groups": [],
      "source": "browser_deep_scan"
    }
  ],
  "raw": {}
}

Error Cases

  • 401: missing or invalid API key
  • 400: invalid payload or invalid URL
  • 502: scan failed upstream