{
  "openapi": "3.1.0",
  "info": {
    "title": "DomainVet",
    "version": "1.2.0",
    "description": "Domain intel for agents: DNS, RDAP age/registrar, CT certs, security headers, tech stack, sitemaps. Free tier 100 calls/day/IP; then $0.001/call via x402 (USDC on Base) or L402 (Lightning, 100 sats per 1,000 calls)."
  },
  "servers": [
    {
      "url": "https://domainvet.pages.dev"
    }
  ],
  "paths": {
    "/api/dns-lookup": {
      "get": {
        "operationId": "dnsLookup",
        "summary": "DNS lookup (A, AAAA, MX, NS, TXT, CAA, SOA...)",
        "description": "Resolve DNS records for a domain via DNS-over-HTTPS (1.1.1.1): A, AAAA, MX, NS, TXT (SPF/verification), CNAME, CAA, SOA, SRV, HTTPS, DS, DNSKEY. Returns values with TTLs, whether the domain exists (NXDOMAIN) and whether the answer was DNSSEC-validated.",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "Domain or hostname",
            "schema": {
              "type": "string",
              "description": "Domain or hostname"
            }
          },
          {
            "name": "types",
            "in": "query",
            "required": false,
            "description": "Comma-separated record types (default A,AAAA,MX,NS,TXT,CNAME,CAA,SOA). Also SRV,HTTPS,DS,DNSKEY,PTR",
            "schema": {
              "type": "string",
              "description": "Comma-separated record types (default A,AAAA,MX,NS,TXT,CNAME,CAA,SOA). Also SRV,HTTPS,DS,DNSKEY,PTR"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "dnsLookupPost",
        "summary": "DNS lookup (A, AAAA, MX, NS, TXT, CAA, SOA...) (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Domain or hostname"
                  },
                  "types": {
                    "type": "string",
                    "description": "Comma-separated record types (default A,AAAA,MX,NS,TXT,CNAME,CAA,SOA). Also SRV,HTTPS,DS,DNSKEY,PTR"
                  }
                },
                "required": [
                  "domain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/rdap-domain": {
      "get": {
        "operationId": "rdapDomain",
        "summary": "Domain registration age, expiry and registrar (RDAP)",
        "description": "Look up a domain's registration record via RDAP (the modern WHOIS): registration date, age in days/years, expiry date and days left, registrar, status flags, nameservers and DNSSEC. A domain registered days ago is a strong phishing/scam signal.",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "Domain name",
            "schema": {
              "type": "string",
              "description": "Domain name"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "rdapDomainPost",
        "summary": "Domain registration age, expiry and registrar (RDAP) (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Domain name"
                  }
                },
                "required": [
                  "domain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/ssl-certs": {
      "get": {
        "operationId": "sslCerts",
        "summary": "SSL/TLS certificates from Certificate Transparency",
        "description": "List unexpired TLS certificates issued for a domain from public Certificate Transparency logs (Cert Spotter, crt.sh fallback): issuer (Let's Encrypt, DigiCert...), names covered, validity window, latest expiry and days remaining. Note: shows issued certs, not necessarily the one being served.",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "Domain name",
            "schema": {
              "type": "string",
              "description": "Domain name"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "sslCertsPost",
        "summary": "SSL/TLS certificates from Certificate Transparency (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "description": "Domain name"
                  }
                },
                "required": [
                  "domain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/security-headers": {
      "get": {
        "operationId": "securityHeaders",
        "summary": "Grade a site's HTTP security headers",
        "description": "Fetch a URL and grade its HTTP security headers A-F: HSTS (with max-age), Content-Security-Policy, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, COOP/CORP. Also flags version-leaking headers (Server, X-Powered-By) and returns all response headers and the redirect chain.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Site URL",
            "schema": {
              "type": "string",
              "description": "Site URL"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "securityHeadersPost",
        "summary": "Grade a site's HTTP security headers (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Site URL"
                  }
                },
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/tech-detect": {
      "get": {
        "operationId": "techDetect",
        "summary": "Detect a website's technology stack",
        "description": "Identify what a site is built with from its HTML and headers: CMS (WordPress, Shopify, Webflow, Ghost...), framework (Next.js, Nuxt, Astro...), CDN/hosting (Cloudflare, Vercel, Netlify...), analytics, payments, support chat and web server. ~50 fingerprints; heuristic.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Site URL",
            "schema": {
              "type": "string",
              "description": "Site URL"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "techDetectPost",
        "summary": "Detect a website's technology stack (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Site URL"
                  }
                },
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/sitemap-urls": {
      "get": {
        "operationId": "sitemapUrls",
        "summary": "List a site's URLs from its sitemaps",
        "description": "Find a site's XML sitemaps (robots.txt Sitemap lines, /sitemap.xml, /sitemap_index.xml), follow sitemap indexes, and return the page URLs listed. Use it to enumerate a site's pages before reading them.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Site URL or direct sitemap.xml URL",
            "schema": {
              "type": "string",
              "description": "Site URL or direct sitemap.xml URL"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Max URLs to return (default 500, max 5000)",
            "schema": {
              "type": "integer",
              "description": "Max URLs to return (default 500, max 5000)"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "sitemapUrlsPost",
        "summary": "List a site's URLs from its sitemaps (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Site URL or direct sitemap.xml URL"
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Max URLs to return (default 500, max 5000)"
                  }
                },
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/favicon-find": {
      "get": {
        "operationId": "faviconFind",
        "summary": "Find a site's favicon and icons",
        "description": "Find a website's icons: <link rel=icon / apple-touch-icon / mask-icon> with sizes and types, the default /favicon.ico (verified), the og:image, and the best icon URL to display.",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Site URL",
            "schema": {
              "type": "string",
              "description": "Site URL"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      },
      "post": {
        "operationId": "faviconFindPost",
        "summary": "Find a site's favicon and icons (JSON body)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Site URL"
                  }
                },
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Result JSON (ok:false with error on bad input)"
          },
          "402": {
            "description": "Payment required: x402 `accepts` (USDC on Base) + L402 WWW-Authenticate"
          },
          "429": {
            "description": "Free limit reached"
          }
        }
      }
    },
    "/api/pricing": {
      "get": {
        "operationId": "pricing",
        "summary": "Pricing and limits",
        "responses": {
          "200": {
            "description": "Pricing"
          }
        }
      }
    }
  }
}