{
  "name": "Caelara Labs compatibility routes",
  "description": "Four calls that many projects already make to scrape, email-verification, company-lookup and SEO-audit services, answered by the Caelara Labs edge APIs. Change the base URL and send your Caelara key (or an x402 payment) instead of the old credential.",
  "migration": {
    "step_1": "Replace the base URL of the call with https://compat.caelaralabs.com.",
    "step_2": "Send your Caelara key as X-Caelara-Key (or Authorization: Bearer <key>), or pay per call with an x402 X-PAYMENT header. A free 50-call trial key: https://caelaralabs.com/shield/#trial",
    "step_3": "Read the response using the shapes below. They are flat JSON documented here; they are not copies of another provider's schema, so adjust the few fields your code reads.",
    "example": {
      "before": "curl -X POST https://your-current-provider.example/v1/scrape -H \"Authorization: Bearer OLD_KEY\" -d '{\"url\":\"https://example.com\"}'",
      "after": "curl -X POST https://compat.caelaralabs.com/v1/scrape -H \"X-Caelara-Key: $CAELARA_KEY\" -H \"Content-Type: application/json\" -d '{\"url\":\"https://example.com\"}'"
    }
  },
  "pricing": "Each request is billed as the upstream calls it makes: 0.005 USDC for an atomic endpoint, 0.025 USDC for a composite. Compare these with your current provider's price list; no saving is promised.",
  "auth": "Your credential is forwarded to the upstream API unchanged and is never stored here. With no credential, the upstream answers HTTP 402 with x402 payment terms.",
  "routes": [
    {
      "method": "POST",
      "path": "/v1/scrape",
      "summary": "Fetch a page and return clean Markdown",
      "maps_to": [
        "api.caelaralabs.com/v1/url-to-markdown"
      ],
      "usdc_per_request": "0.005",
      "body": {
        "url": "Page address (required)",
        "formats": "Optional. Only \"markdown\" is available."
      },
      "returns": "{ success, data: { markdown, metadata: { title, sourceURL, length } } }",
      "notes": "HTML output is not offered; asking for another format returns 422."
    },
    {
      "method": "GET",
      "path": "/v1/email-verifier",
      "summary": "Check whether an address can receive mail",
      "maps_to": [
        "api.caelaralabs.com/v1/lead-verify-composite",
        "compliance.caelaralabs.com/v1/disposable-email-db"
      ],
      "usdc_per_request": "0.030",
      "query": {
        "email": "Address to check (required)"
      },
      "returns": "{ success, email, result: deliverable | risky | undeliverable, score, checks: { syntax_valid, mx_found, mx_records, spf, dmarc, disposable, role_account, free_provider }, method }",
      "notes": "Uses DNS signals only (MX, SPF, DMARC, disposable and role lists). The mailbox itself is never contacted, so \"deliverable\" means the domain can receive mail, not that the inbox exists. Two upstream calls per request."
    },
    {
      "method": "GET",
      "path": "/v1/company/find",
      "summary": "Look up a company from its domain",
      "maps_to": [
        "api.caelaralabs.com/v1/company-intel-composite"
      ],
      "usdc_per_request": "0.025",
      "query": {
        "domain": "Company domain such as example.com (required)"
      },
      "returns": "{ success, domain, name, description, website, logo, social: { twitter, linkedin, github }, email_provider, mx_records, ip_addresses, retrieved_at }",
      "notes": "Built from the public home page, DNS and MX records. Fields the site does not publish are null."
    },
    {
      "method": "GET",
      "path": "/v1/seo/audit",
      "summary": "Check AI-search readiness: llms.txt, AI crawler access, structured data",
      "maps_to": [
        "seo.caelaralabs.com/v1/geo-readiness-composite"
      ],
      "usdc_per_request": "0.025",
      "query": {
        "url": "Page or site address (required)"
      },
      "returns": "{ success, url, score, grade, breakdown, checks: { llms_txt, ai_crawlers, structured_data }, recommendations }",
      "notes": "Scores generative-engine readiness, not rankings."
    }
  ],
  "openapi": "https://compat.caelaralabs.com/openapi.json",
  "contact": "ops@caelaralabs.com"
}