{
 "openapi": "3.0.3",
 "info": {
  "title": "Caelara Labs APIs",
  "version": "1.0.0",
  "description": "Ten API suites on the Caelara Labs edge. Atomic calls 0.005 USDC, composite calls 0.025 USDC. Each suite also publishes its own openapi.json, MCP server and agent card.",
  "contact": {
   "email": "ops@caelaralabs.com",
   "url": "https://caelaralabs.com"
  },
  "x-caelara-plans": {
   "self_serve": [
    {
     "name": "Free trial key",
     "price": "$0",
     "allowance": "50 calls over 7 days",
     "url": "https://caelaralabs.com/#trial"
    },
    {
     "name": "Suite Starter",
     "price_usd_month": 29,
     "allowance": "2,500 credits"
    },
    {
     "name": "Suite Pro",
     "price_usd_month": 79,
     "allowance": "10,000 credits"
    },
    {
     "name": "Suite Scale",
     "price_usd_month": 249,
     "allowance": "100,000 credits"
    },
    {
     "name": "Personal Shield",
     "price_usd_month": 9,
     "allowance": "1,000 screenings"
    },
    {
     "name": "Shield Builder",
     "price_usd_month": 79,
     "allowance": "10,000 screenings"
    },
    {
     "name": "Shield Growth",
     "price_usd_month": 299,
     "allowance": "50,000 screenings"
    }
   ],
   "credits": "Suite plans: one credit per 0.005 USDC of the listed per-call price.",
   "contact_sales": [
    {
     "name": "Enterprise invoice",
     "indicative_usd_month": "999+",
     "contact": "ops@caelaralabs.com"
    },
    {
     "name": "Platform & OEM runtime licensing",
     "indicative_usd_month": "25,000-75,000",
     "note": "Sub-keys on request.",
     "contact": "ops@caelaralabs.com"
    },
    {
     "name": "Enterprise & Cloud Marketplace commits",
     "indicative_usd_month": "25,000-100,000",
     "contact": "ops@caelaralabs.com"
    }
   ],
   "pricing_page": "https://caelaralabs.com/#pricing"
  }
 },
 "servers": [
  {
   "url": "https://caelaralabs.com"
  }
 ],
 "components": {
  "securitySchemes": {
   "CaelaraKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-Caelara-Key"
   },
   "x402USDC": {
    "type": "apiKey",
    "in": "header",
    "name": "X-PAYMENT",
    "description": "x402 USDC payment on Base"
   }
  }
 },
 "paths": {
  "/v1/company-intel-composite": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_company_intel_composite",
    "summary": "Company intelligence: web metadata + DNS + MX in one call",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Company domain, e.g. example.com",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/lead-verify-composite": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_lead_verify_composite",
    "summary": "Lead verification: email deliverability signals + LinkedIn URL checks",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "email",
      "in": "query",
      "required": true,
      "description": "Lead email address",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "linkedin_url",
      "in": "query",
      "required": false,
      "description": "LinkedIn profile URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/url-to-markdown": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_url_to_markdown",
    "summary": "Convert a web page to clean Markdown",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/seo-xray": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_seo_xray",
    "summary": "On-page SEO audit of a URL",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/email-mx-forensics": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_email_mx_forensics",
    "summary": "MX / provider forensics for an email address",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "email",
      "in": "query",
      "required": true,
      "description": "Email address",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/social-card-extractor": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_social_card_extractor",
    "summary": "Extract OpenGraph / Twitter card metadata",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/sitemap-crawler": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_sitemap_crawler",
    "summary": "Parse a sitemap into a URL list",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Sitemap or site URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max URLs (default 100)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/html-table-parser": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_html_table_parser",
    "summary": "Parse HTML tables into JSON",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": false,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "html",
      "in": "query",
      "required": false,
      "description": "Raw HTML (alternative to url)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/rss-json-normalizer": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "api_rss_json_normalizer",
    "summary": "Normalize RSS/Atom feeds to JSON",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Feed URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Max items (default 50)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/prompt-firewall-structurer": {
   "servers": [
    {
     "url": "https://api.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "api_prompt_firewall_structurer",
    "summary": "Scan a prompt for injection/PII and return a structured form",
    "tags": [
     "Web Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "prompt": {
          "type": "string",
          "description": "Prompt text"
         },
         "context": {
          "type": "string",
          "description": "Additional context"
         },
         "strict": {
          "type": "boolean",
          "description": "Strict mode"
         }
        },
        "required": [
         "prompt"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/video-viral-audit-composite": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_video_viral_audit_composite",
    "summary": "Viral audit of a TikTok/YouTube video: metadata + hook score + hashtags + thumbnail",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "TikTok or YouTube video URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/creator-profile-composite": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_creator_profile_composite",
    "summary": "Creator profile audit: bio-link page audit + engagement benchmark",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Link-in-bio or profile page URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "followers",
      "in": "query",
      "required": false,
      "description": "Follower count",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "avg_likes",
      "in": "query",
      "required": false,
      "description": "Average likes per post",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "avg_comments",
      "in": "query",
      "required": false,
      "description": "Average comments per post",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "avg_views",
      "in": "query",
      "required": false,
      "description": "Average views per post",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/tiktok-oembed": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_tiktok_oembed",
    "summary": "TikTok video metadata via public oEmbed",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "TikTok video URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/youtube-metadata": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_youtube_metadata",
    "summary": "YouTube video metadata via public oEmbed + thumbnail URLs",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "YouTube video URL or id",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/reels-hook-scorer": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "social_reels_hook_scorer",
    "summary": "Score the opening hook of a Reel/Short/TikTok script or caption",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Script or caption (first lines matter most)"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/thumbnail-analyzer": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_thumbnail_analyzer",
    "summary": "Analyze a thumbnail image: format, dimensions, aspect ratio, size",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Image URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/caption-hashtag-extractor": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "social_caption_hashtag_extractor",
    "summary": "Extract hashtags, mentions, links and emoji from a caption",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "caption": {
          "type": "string",
          "description": "Post caption"
         }
        },
        "required": [
         "caption"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/bio-link-auditor": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_bio_link_auditor",
    "summary": "Audit a link-in-bio page: link count, platforms, CTA and tracking",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Bio link page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/transcript-cleaner": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "social_transcript_cleaner",
    "summary": "Clean a raw transcript/VTT/SRT: timestamps, fillers, duplicates",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "transcript": {
          "type": "string",
          "description": "Raw transcript text"
         }
        },
        "required": [
         "transcript"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/engagement-rate-calc": {
   "servers": [
    {
     "url": "https://social.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "social_engagement_rate_calc",
    "summary": "Compute engagement rate metrics and benchmark tier",
    "tags": [
     "Social Analytics"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "followers",
      "in": "query",
      "required": true,
      "description": "Follower count",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "likes",
      "in": "query",
      "required": true,
      "description": "Likes",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "comments",
      "in": "query",
      "required": false,
      "description": "Comments",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "shares",
      "in": "query",
      "required": false,
      "description": "Shares",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "saves",
      "in": "query",
      "required": false,
      "description": "Saves",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "views",
      "in": "query",
      "required": false,
      "description": "Views",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/agent-input-firewall": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_agent_input_firewall",
    "summary": "Scan untrusted input: injection risk + PII redaction + sanitized text + allow/review/block verdict",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Untrusted input text"
         },
         "redact_pii": {
          "type": "boolean",
          "description": "Redact PII in sanitized output (default true)"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/agent-output-validator": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_agent_output_validator",
    "summary": "Validate LLM output: repair JSON, enforce schema, check grounding against a source, extract citations",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "output": {
          "type": "string",
          "description": "Raw LLM output"
         },
         "schema": {
          "type": "object",
          "description": "JSON Schema subset to enforce"
         },
         "source": {
          "type": "string",
          "description": "Source text for grounding check"
         }
        },
        "required": [
         "output"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/pii-redactor": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_pii_redactor",
    "summary": "Redact emails, phones, SSNs, cards (Luhn), IPs, API keys and JWTs",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to redact"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/prompt-injection-scanner": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_prompt_injection_scanner",
    "summary": "Score text for prompt-injection patterns",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to scan"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/token-compressor": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_token_compressor",
    "summary": "Compress text to a target ratio of its original length",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to compress"
         },
         "ratio": {
          "type": "number",
          "description": "Target ratio 0.1-0.9 (default 0.5)"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/json-auto-repair": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_json_auto_repair",
    "summary": "Repair malformed JSON from LLM output",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Malformed JSON text"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/schema-enforcer": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_schema_enforcer",
    "summary": "Validate and coerce data to a JSON Schema",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "data": {
          "type": "object",
          "description": "Data to enforce"
         },
         "schema": {
          "type": "object",
          "description": "JSON Schema subset"
         }
        },
        "required": [
         "data",
         "schema"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/hallucination-diff": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_hallucination_diff",
    "summary": "Flag answer sentences unsupported by the source text",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "source": {
          "type": "string",
          "description": "Source / ground-truth text"
         },
         "answer": {
          "type": "string",
          "description": "Model answer to check"
         }
        },
        "required": [
         "source",
         "answer"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/citation-extractor": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_citation_extractor",
    "summary": "Extract URLs, DOIs, arXiv ids and author-year citations",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text containing citations"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/context-chunker": {
   "servers": [
    {
     "url": "https://agent.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "agent_context_chunker",
    "summary": "Split text into token-bounded overlapping chunks",
    "tags": [
     "Agent Safety"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to chunk"
         },
         "max_tokens": {
          "type": "integer",
          "description": "Max tokens per chunk (default 500)"
         },
         "overlap": {
          "type": "integer",
          "description": "Overlap tokens (default 50)"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/domain-trust-composite": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_domain_trust_composite",
    "summary": "Domain trust report: SPF/DMARC grade + security headers + certificate history + overall trust score",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Domain name, e.g. example.com",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/entity-kyb-composite": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "compliance_entity_kyb_composite",
    "summary": "Entity KYB screen: sanctions fuzzy match + VAT/EIN + IBAN/BIC + email disposable check with risk verdict",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string",
          "description": "Legal entity name"
         },
         "vat": {
          "type": "string",
          "description": "VAT number incl. country prefix, or US EIN"
         },
         "iban": {
          "type": "string",
          "description": "IBAN"
         },
         "bic": {
          "type": "string",
          "description": "BIC/SWIFT code"
         },
         "email": {
          "type": "string",
          "description": "Contact email"
         },
         "watchlist": {
          "type": "array",
          "description": "Optional extra names to screen against"
         }
        },
        "required": [
         "name"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/spf-dmarc-grader": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_spf_dmarc_grader",
    "summary": "Grade SPF and DMARC DNS records (A-F)",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Domain name",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/ssl-cert-inspector": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_ssl_cert_inspector",
    "summary": "Inspect certificate issuance history via Certificate Transparency",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Domain name",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/ip-asn-reputation": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_ip_asn_reputation",
    "summary": "ASN lookup and reserved/private range classification for an IP",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "ip",
      "in": "query",
      "required": true,
      "description": "IPv4 or IPv6 address",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/disposable-email-db": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_disposable_email_db",
    "summary": "Detect disposable / throwaway email domains and role accounts",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "email",
      "in": "query",
      "required": true,
      "description": "Email address or domain",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/iban-bic-validator": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_iban_bic_validator",
    "summary": "Validate IBAN (mod-97, country length) and BIC/SWIFT format",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "iban",
      "in": "query",
      "required": false,
      "description": "IBAN",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "bic",
      "in": "query",
      "required": false,
      "description": "BIC/SWIFT code",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/vat-ein-checkdigit": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_vat_ein_checkdigit",
    "summary": "Validate EU VAT number check digits and US EIN format",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "number",
      "in": "query",
      "required": true,
      "description": "VAT number with country prefix, or US EIN (NN-NNNNNNN)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/sanctions-fuzzy-screen": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "compliance_sanctions_fuzzy_screen",
    "summary": "Fuzzy-match a name against a built-in seed list plus a caller-supplied watchlist",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "name": {
          "type": "string",
          "description": "Name to screen"
         },
         "watchlist": {
          "type": "array",
          "description": "Extra names to screen against"
         },
         "threshold": {
          "type": "number",
          "description": "Match threshold 0.5-1 (default 0.85)"
         }
        },
        "required": [
         "name"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/security-headers-audit": {
   "servers": [
    {
     "url": "https://compliance.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "compliance_security_headers_audit",
    "summary": "Fetch a URL and grade its HTTP security headers",
    "tags": [
     "Compliance & Trust"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "URL or hostname to audit",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/product-intel-composite": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "ecom_product_intel_composite",
    "summary": "Product page intelligence: JSON-LD product, GTIN validation, SKU normalization, review sentiment, ad pixels and price signals",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Product page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/storefront-xray-composite": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "ecom_storefront_xray_composite",
    "summary": "Storefront X-ray: platform, ad/analytics stack, payment options, structured data and Shopify catalog sample",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Storefront URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/jsonld-product-parser": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "ecom_jsonld_product_parser",
    "summary": "Extract schema.org Product data (offers, ratings, reviews) from a page",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string",
          "description": "Page URL (or supply html)"
         },
         "html": {
          "type": "string",
          "description": "Raw HTML (or supply url)"
         }
        },
        "required": []
       }
      }
     }
    }
   }
  },
  "/v1/shopify-feed-extractor": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "ecom_shopify_feed_extractor",
    "summary": "Extract the public Shopify products.json catalog with pricing and stock summary",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Shopify store URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Products per page 1-250 (default 30)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "page",
      "in": "query",
      "required": false,
      "description": "Page number (default 1)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/gtin-upc-validator": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "ecom_gtin_upc_validator",
    "summary": "Validate GTIN-8/12/13/14 (UPC/EAN) check digits and convert formats",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "code",
      "in": "query",
      "required": true,
      "description": "Barcode digits",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/price-drop-comparator": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "ecom_price_drop_comparator",
    "summary": "Compare a price series (or old/new price) and flag drops, lows and target hits",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "prices": {
          "type": "array",
          "description": "Price history, oldest first (numbers or {price,date})"
         },
         "old_price": {
          "type": "number",
          "description": "Previous price"
         },
         "new_price": {
          "type": "number",
          "description": "Current price"
         },
         "threshold_pct": {
          "type": "number",
          "description": "Drop/increase threshold percent (default 10)"
         },
         "target_price": {
          "type": "number",
          "description": "Target buy price"
         }
        },
        "required": []
       }
      }
     }
    }
   }
  },
  "/v1/ad-pixel-detector": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "ecom_ad_pixel_detector",
    "summary": "Detect ad, analytics and marketing pixels (Meta, TikTok, GA4, GTM, Pinterest, etc.) with tag IDs",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string",
          "description": "Page URL (or supply html)"
         },
         "html": {
          "type": "string",
          "description": "Raw HTML (or supply url)"
         }
        },
        "required": []
       }
      }
     }
    }
   }
  },
  "/v1/currency-margin-calc": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "ecom_currency_margin_calc",
    "summary": "Margin, markup, breakeven and target price with FX rate, fees, shipping and tax",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "cost",
      "in": "query",
      "required": true,
      "description": "Unit cost",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "price",
      "in": "query",
      "required": true,
      "description": "Selling price",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "fx_rate",
      "in": "query",
      "required": false,
      "description": "FX multiplier cost currency to price currency (default 1)",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "fee_pct",
      "in": "query",
      "required": false,
      "description": "Marketplace/payment fee percent",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "fixed_fee",
      "in": "query",
      "required": false,
      "description": "Fixed fee per order",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "shipping_cost",
      "in": "query",
      "required": false,
      "description": "Shipping cost in price currency",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "tax_pct",
      "in": "query",
      "required": false,
      "description": "Tax percent included in price",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "target_margin_pct",
      "in": "query",
      "required": false,
      "description": "Desired margin percent for suggested price",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "cost_currency",
      "in": "query",
      "required": false,
      "description": "Cost currency code",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "price_currency",
      "in": "query",
      "required": false,
      "description": "Price currency code",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/review-sentiment-parser": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "ecom_review_sentiment_parser",
    "summary": "Score review sentiment with aspect breakdown (quality, price, shipping, fit, service)",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "reviews": {
          "type": "array",
          "description": "Array of review strings or {text, rating}"
         },
         "text": {
          "type": "string",
          "description": "Newline-separated reviews"
         }
        },
        "required": []
       }
      }
     }
    }
   }
  },
  "/v1/sku-normalizer": {
   "servers": [
    {
     "url": "https://ecom.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "ecom_sku_normalizer",
    "summary": "Normalize SKUs into canonical, compact and match-key forms",
    "tags": [
     "E-Commerce Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "skus": {
          "type": "array",
          "description": "Array of SKU strings"
         },
         "sku": {
          "type": "string",
          "description": "Single SKU string"
         }
        },
        "required": []
       }
      }
     }
    }
   }
  },
  "/v1/geo-readiness-composite": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_geo_readiness_composite",
    "summary": "Generative-engine readiness score: llms.txt + AI crawler access + structured data + content clarity",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL to assess",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/technical-seo-composite": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_technical_seo_composite",
    "summary": "Technical SEO audit: redirects, meta, canonical, headings, hreflang, schema, robots.txt with scored issues",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL to audit",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/llms-txt-auditor": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_llms_txt_auditor",
    "summary": "Fetch and audit /llms.txt (and llms-full.txt) against the llms.txt format",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Any URL on the target site",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/ai-bot-robots-check": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_ai_bot_robots_check",
    "summary": "Check whether GPTBot, PerplexityBot, Google-Extended and other AI crawlers are allowed by robots.txt",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "URL (path is evaluated against robots.txt)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/redirect-chain-tracer": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_redirect_chain_tracer",
    "summary": "Trace a redirect chain hop by hop with loop detection and status issues",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Starting URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "max_hops",
      "in": "query",
      "required": false,
      "description": "Max hops 1-10 (default 10)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/schema-org-validator": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_schema_org_validator",
    "summary": "Extract and validate JSON-LD / microdata structured data on a page",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/serp-pixel-preview": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_serp_pixel_preview",
    "summary": "Pixel-width SERP snippet preview with truncation for desktop and mobile",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "title",
      "in": "query",
      "required": true,
      "description": "Page title",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "description",
      "in": "query",
      "required": false,
      "description": "Meta description",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "url",
      "in": "query",
      "required": false,
      "description": "Display URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/keyword-ngrams-extractor": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "seo_keyword_ngrams_extractor",
    "summary": "Extract top keyword unigrams, bigrams and trigrams with density",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to analyze"
         },
         "max_n": {
          "type": "integer",
          "description": "Largest n-gram size 1-3 (default 3)"
         },
         "top": {
          "type": "integer",
          "description": "Results per n-gram size (default 15)"
         },
         "include_stopwords": {
          "type": "boolean",
          "description": "Keep stopword-edged phrases"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/hreflang-validator": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_hreflang_validator",
    "summary": "Validate hreflang annotations: codes, x-default, self-reference and optional return links",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "check_return_links",
      "in": "query",
      "required": false,
      "description": "Verify reciprocal links on up to 5 alternates (true/false)",
      "schema": {
       "type": "boolean"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/broken-link-scanner": {
   "servers": [
    {
     "url": "https://seo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "seo_broken_link_scanner",
    "summary": "Check outbound and internal links on a page for 4xx/5xx and dead hosts",
    "tags": [
     "SEO & GEO Readiness"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Page URL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "max_links",
      "in": "query",
      "required": false,
      "description": "Max links to check 1-40 (default 25)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/invoice-json-composite": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_invoice_json_composite",
    "summary": "Convert raw invoice text into structured JSON: number, dates, currency, line items, totals and consistency checks",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Raw invoice text"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/universal-data-bridge": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_universal_data_bridge",
    "summary": "Convert data between CSV, XML and JSON with format auto-detection and type inference",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "data": {
          "type": "string",
          "description": "Input document (string) or JSON value"
         },
         "from": {
          "type": "string",
          "description": "Source format: auto|csv|xml|json (default auto)"
         },
         "to": {
          "type": "string",
          "description": "Target format: json|csv|xml"
         }
        },
        "required": [
         "data",
         "to"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/csv-to-typed-json": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_csv_to_typed_json",
    "summary": "Parse CSV into JSON rows with inferred number, boolean, null and date types",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "csv": {
          "type": "string",
          "description": "CSV text"
         },
         "delimiter": {
          "type": "string",
          "description": "Delimiter (auto-detected if omitted)"
         },
         "header": {
          "type": "boolean",
          "description": "First row is header (default true)"
         }
        },
        "required": [
         "csv"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/xml-to-json-clean": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_xml_to_json_clean",
    "summary": "Convert XML to clean JSON (attributes prefixed with @, repeated tags to arrays)",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "xml": {
          "type": "string",
          "description": "XML text"
         }
        },
        "required": [
         "xml"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/markdown-to-sanitized-html": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_markdown_to_sanitized_html",
    "summary": "Render markdown to HTML with all raw HTML escaped and unsafe URLs removed",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "markdown": {
          "type": "string",
          "description": "Markdown text"
         }
        },
        "required": [
         "markdown"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/html-to-clean-text": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_html_to_clean_text",
    "summary": "Strip HTML to readable plain text, dropping scripts, styles and tags",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "html": {
          "type": "string",
          "description": "HTML text"
         },
         "keep_links": {
          "type": "boolean",
          "description": "Append link URLs in brackets"
         }
        },
        "required": [
         "html"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/regex-entity-extractor": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_regex_entity_extractor",
    "summary": "Extract emails, URLs, phones, IPs, dates, money, hashtags, mentions and more from text",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "text": {
          "type": "string",
          "description": "Text to scan"
         },
         "types": {
          "type": "array",
          "description": "Entity types to extract (array of strings)"
         }
        },
        "required": [
         "text"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/address-normalizer": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_address_normalizer",
    "summary": "Normalize a postal address: casing, street/directional abbreviations, unit, ZIP and state",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string",
          "description": "Free-form address"
         }
        },
        "required": [
         "address"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/phone-e164-formatter": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_phone_e164_formatter",
    "summary": "Format a phone number to E.164 with country detection and validity check",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "phone": {
          "type": "string",
          "description": "Phone number"
         },
         "country": {
          "type": "string",
          "description": "Default ISO-2 country code, e.g. US"
         }
        },
        "required": [
         "phone"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/dedupe-fuzzy-matcher": {
   "servers": [
    {
     "url": "https://docs.caelaralabs.com"
    }
   ],
   "post": {
    "operationId": "docs_dedupe_fuzzy_matcher",
    "summary": "Cluster near-duplicate strings using Jaro-Winkler and token similarity",
    "tags": [
     "Document Utilities"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "items": {
          "type": "array",
          "description": "Array of strings"
         },
         "threshold": {
          "type": "number",
          "description": "Similarity threshold 0.5-1 (default 0.88)"
         }
        },
        "required": [
         "items"
        ]
       }
      }
     }
    }
   }
  },
  "/v1/token-safety-composite": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_token_safety_composite",
    "summary": "Safety score for an EVM or Solana token: contract/mint authority checks, holder concentration, on-chain liquidity depth, pool age and trade-flow flags",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "Token contract (0x...) or Solana mint address",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "Chain: base|ethereum|arbitrum|optimism (default base)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/wallet-portfolio-composite": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_wallet_portfolio_composite",
    "summary": "USD portfolio for an EVM or Solana wallet: native balance, major token balances, prices and allocation",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "Wallet address (0x... or Solana)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "Chain: base|ethereum|arbitrum|optimism (EVM, default base). Solana is auto-detected from the address format",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/solana-mint-auditor": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_solana_mint_auditor",
    "summary": "Audit a Solana SPL mint: mint/freeze authority, supply, decimals, Token-2022 extensions and top-holder concentration",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "mint",
      "in": "query",
      "required": true,
      "description": "Solana mint address",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/base-erc20-inspector": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_base_erc20_inspector",
    "summary": "Inspect an ERC-20 on Base or another EVM chain: name, symbol, decimals, supply, owner, proxy slot and risky function selectors",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "Token contract address",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "Chain: base|ethereum|arbitrum|optimism (default base)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/dex-liquidity-depth": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_dex_liquidity_depth",
    "summary": "On-chain liquidity pools for a token with liquidity, volume, and estimated price impact for $100 to $100k trades",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "token",
      "in": "query",
      "required": true,
      "description": "Token address (EVM or Solana mint)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "DexScreener chain id filter, e.g. base, solana, ethereum",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/stablecoin-depeg-monitor": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_stablecoin_depeg_monitor",
    "summary": "Peg deviation in basis points for major stablecoins from independent market data feeds",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "symbols",
      "in": "query",
      "required": false,
      "description": "Comma list from USDT,USDC,DAI (default all)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/gas-fee-estimator": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_gas_fee_estimator",
    "summary": "Live gas price and USD cost estimates for transfers, ERC-20 transfers and token-trade contract calls on EVM chains",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "Chain: base|ethereum|arbitrum|optimism (default base)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/tx-hash-decoder": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_tx_hash_decoder",
    "summary": "Decode an EVM transaction: status, fee, method selector, ERC-20 transfers and approvals",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "hash",
      "in": "query",
      "required": true,
      "description": "Transaction hash (0x + 64 hex)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "description": "Chain: base|ethereum|arbitrum|optimism (default base)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/address-checksum-validator": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_address_checksum_validator",
    "summary": "Validate an EVM address (EIP-55 checksum) or Solana address (base58, 32 bytes) and return the canonical form",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "Address to validate",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/token-price-aggregator": {
   "servers": [
    {
     "url": "https://crypto.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "crypto_token_price_aggregator",
    "summary": "Median USD price for a ticker across Coinbase, Kraken and Bitstamp with spread, plus on-chain pool price when a contract address is supplied",
    "tags": [
     "On-Chain Intelligence"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "symbol",
      "in": "query",
      "required": true,
      "description": "Ticker, e.g. ETH, BTC, SOL",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "address",
      "in": "query",
      "required": false,
      "description": "Optional token contract/mint for on-chain pool pricing",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/global-scheduling-composite": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_global_scheduling_composite",
    "summary": "Find meeting slots that fall inside working hours for every participant timezone, skipping weekends and public holidays, with per-participant local times",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "timezones",
      "in": "query",
      "required": true,
      "description": "Comma list of IANA timezones; the first is the organizer whose local day anchors the search",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "date",
      "in": "query",
      "required": false,
      "description": "Organizer-local date YYYY-MM-DD (default today)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "duration_minutes",
      "in": "query",
      "required": false,
      "description": "Meeting length in minutes (default 60)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "work_start",
      "in": "query",
      "required": false,
      "description": "Working day start HH:MM (default 09:00)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "work_end",
      "in": "query",
      "required": false,
      "description": "Working day end HH:MM (default 17:00)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "countries",
      "in": "query",
      "required": false,
      "description": "Comma list of ISO alpha-2 codes aligned with timezones, used to skip public holidays",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/cross-border-checkout-composite": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_cross_border_checkout_composite",
    "summary": "Cross-border checkout quote: FX conversion into the destination currency, VAT/GST, postal-code validation and EU reverse-charge eligibility",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "amount",
      "in": "query",
      "required": true,
      "description": "Order subtotal in the source currency",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "currency",
      "in": "query",
      "required": true,
      "description": "Source currency ISO 4217 code, e.g. USD",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "country",
      "in": "query",
      "required": true,
      "description": "Destination country (ISO alpha-2, e.g. DE)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "postal_code",
      "in": "query",
      "required": false,
      "description": "Destination postal code to validate",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "prices_include_tax",
      "in": "query",
      "required": false,
      "description": "true when the amount already includes tax",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "vat_id",
      "in": "query",
      "required": false,
      "description": "Buyer VAT ID for B2B reverse-charge screening (format only, not VIES-verified)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "origin_country",
      "in": "query",
      "required": false,
      "description": "Seller country (ISO alpha-2) for reverse-charge screening",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/timezone-converter": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_timezone_converter",
    "summary": "Convert a date-time between IANA timezones with offsets, abbreviations and DST flags",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "from",
      "in": "query",
      "required": true,
      "description": "Source IANA timezone, e.g. America/New_York",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "to",
      "in": "query",
      "required": true,
      "description": "Comma list of target IANA timezones",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "time",
      "in": "query",
      "required": false,
      "description": "ISO 8601 time; wall time is read in the source timezone (default now)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/business-hours-calc": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_business_hours_calc",
    "summary": "Is a location open right now (or at a given instant) and when does it next open or close",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "tz",
      "in": "query",
      "required": true,
      "description": "IANA timezone of the business",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "start",
      "in": "query",
      "required": false,
      "description": "Opening time HH:MM (default 09:00)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "end",
      "in": "query",
      "required": false,
      "description": "Closing time HH:MM (default 17:00)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "days",
      "in": "query",
      "required": false,
      "description": "Comma list of open weekdays, 0=Sunday..6=Saturday (default 1,2,3,4,5)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "at",
      "in": "query",
      "required": false,
      "description": "ISO 8601 instant to evaluate (default now)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/public-holiday-lookup": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_public_holiday_lookup",
    "summary": "Public holidays for a country and year, with an optional is-holiday check for one date",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "country",
      "in": "query",
      "required": true,
      "description": "ISO alpha-2 country code",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "year",
      "in": "query",
      "required": false,
      "description": "Year (default current)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "date",
      "in": "query",
      "required": false,
      "description": "Optional YYYY-MM-DD to test",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/live-fx-rates": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_live_fx_rates",
    "summary": "Live currency (FX) rates for a base currency with optional amount conversion",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "base",
      "in": "query",
      "required": false,
      "description": "Base currency ISO 4217 (default USD)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "symbols",
      "in": "query",
      "required": false,
      "description": "Comma list of target currencies (default major set)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "amount",
      "in": "query",
      "required": false,
      "description": "Amount of the base currency to convert",
      "schema": {
       "type": "number"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/vat-gst-rate-lookup": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_vat_gst_rate_lookup",
    "summary": "Standard and reduced VAT/GST rates for a country with optional tax amount calculation",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "country",
      "in": "query",
      "required": true,
      "description": "ISO alpha-2 country code",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "amount",
      "in": "query",
      "required": false,
      "description": "Net amount to compute tax on",
      "schema": {
       "type": "number"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/postal-code-validator": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_postal_code_validator",
    "summary": "Validate and normalize a postal code for a country",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "country",
      "in": "query",
      "required": true,
      "description": "ISO alpha-2 country code",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "code",
      "in": "query",
      "required": true,
      "description": "Postal code to validate",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/country-iso-enricher": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_country_iso_enricher",
    "summary": "Resolve a country name or ISO code to alpha-2/alpha-3/numeric codes, currency, calling code, region, capital and primary timezone",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "q",
      "in": "query",
      "required": true,
      "description": "Country name, alpha-2, alpha-3 or numeric code",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/distance-haversine-calc": {
   "servers": [
    {
     "url": "https://geo.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "geo_distance_haversine_calc",
    "summary": "Great-circle distance, initial bearing and midpoint between two coordinates",
    "tags": [
     "Global Locale"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "lat1",
      "in": "query",
      "required": true,
      "description": "Latitude of point A",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "lon1",
      "in": "query",
      "required": true,
      "description": "Longitude of point A",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "lat2",
      "in": "query",
      "required": true,
      "description": "Latitude of point B",
      "schema": {
       "type": "number"
      }
     },
     {
      "name": "lon2",
      "in": "query",
      "required": true,
      "description": "Longitude of point B",
      "schema": {
       "type": "number"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/brand-kit-composite": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_brand_kit_composite",
    "summary": "Build a brand kit from a domain: best-resolution icon, extracted palette with accessible text colors, initials avatar and badge assets",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Brand domain, e.g. stripe.com",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "name",
      "in": "query",
      "required": false,
      "description": "Brand display name (default derived from the domain)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "color",
      "in": "query",
      "required": false,
      "description": "Brand color override (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/dynamic-social-card-composite": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_dynamic_social_card_composite",
    "summary": "Generate a full social-card set (Open Graph, Twitter, square, story) as SVG with a QR code, meta tags and alt text",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "title",
      "in": "query",
      "required": true,
      "description": "Card headline",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "subtitle",
      "in": "query",
      "required": false,
      "description": "Supporting line",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "brand",
      "in": "query",
      "required": false,
      "description": "Brand label shown on the card",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "url",
      "in": "query",
      "required": false,
      "description": "Destination URL; adds a QR code and domain label",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "theme",
      "in": "query",
      "required": false,
      "description": "dark (default) or light",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "accent",
      "in": "query",
      "required": false,
      "description": "Accent color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "bg",
      "in": "query",
      "required": false,
      "description": "Background color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fg",
      "in": "query",
      "required": false,
      "description": "Text color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "composite",
    "x-caelara-price-usdc": "0.025"
   }
  },
  "/v1/edge-og-svg-generator": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_edge_og_svg_generator",
    "summary": "Render an Open Graph card (default 1200x630) as SVG",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "title",
      "in": "query",
      "required": true,
      "description": "Headline",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "subtitle",
      "in": "query",
      "required": false,
      "description": "Supporting line",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "brand",
      "in": "query",
      "required": false,
      "description": "Brand label",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "theme",
      "in": "query",
      "required": false,
      "description": "dark (default) or light",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "bg",
      "in": "query",
      "required": false,
      "description": "Background color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fg",
      "in": "query",
      "required": false,
      "description": "Text color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "accent",
      "in": "query",
      "required": false,
      "description": "Accent color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "width",
      "in": "query",
      "required": false,
      "description": "Width in px (200-4000, default 1200)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "height",
      "in": "query",
      "required": false,
      "description": "Height in px (200-4000, default 630)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "format",
      "in": "query",
      "required": false,
      "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/qr-code-svg-builder": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_qr_code_svg_builder",
    "summary": "Encode text or a URL as a scannable QR code SVG",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "text",
      "in": "query",
      "required": true,
      "description": "Text or URL to encode (max 1000 bytes)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "ecc",
      "in": "query",
      "required": false,
      "description": "Error correction: L, M (default), Q or H",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "size",
      "in": "query",
      "required": false,
      "description": "Rendered size in px (64-2048, default 256)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "margin",
      "in": "query",
      "required": false,
      "description": "Quiet zone in modules (0-16, default 4)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "fg",
      "in": "query",
      "required": false,
      "description": "Module color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "bg",
      "in": "query",
      "required": false,
      "description": "Background color (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "format",
      "in": "query",
      "required": false,
      "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/color-palette-extractor": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_color_palette_extractor",
    "summary": "Extract a dominant-color palette from a PNG or SVG image, or normalize a list of colors, with contrast ratios",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": false,
      "description": "Image URL (PNG or SVG are pixel/markup sampled)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "colors",
      "in": "query",
      "required": false,
      "description": "Comma list of hex colors to analyze instead of an image",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "count",
      "in": "query",
      "required": false,
      "description": "Number of colors (1-12, default 5)",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/favicon-hd-resolver": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_favicon_hd_resolver",
    "summary": "Find the highest-resolution icon a domain publishes (SVG, apple-touch, Android, favicon) with dimensions",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "domain",
      "in": "query",
      "required": true,
      "description": "Domain or URL, e.g. github.com",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/avatar-initials-svg": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_avatar_initials_svg",
    "summary": "Generate a deterministic initials avatar SVG with an accessible text color",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": true,
      "description": "Person or company name",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "size",
      "in": "query",
      "required": false,
      "description": "Size in px (24-1024, default 128)",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "shape",
      "in": "query",
      "required": false,
      "description": "circle (default), rounded or square",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "bg",
      "in": "query",
      "required": false,
      "description": "Background color (default derived from the name) (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fg",
      "in": "query",
      "required": false,
      "description": "Text color (default chosen for contrast) (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "format",
      "in": "query",
      "required": false,
      "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/badge-shield-generator": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_badge_shield_generator",
    "summary": "Generate a status badge SVG (label | message) in flat or flat-square style",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "label",
      "in": "query",
      "required": true,
      "description": "Left label",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "message",
      "in": "query",
      "required": true,
      "description": "Right message",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "color",
      "in": "query",
      "required": false,
      "description": "Message background color (default 2ea44f) (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "label_color",
      "in": "query",
      "required": false,
      "description": "Label background color (default 555555) (hex, with or without #)",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "style",
      "in": "query",
      "required": false,
      "description": "flat (default) or flat-square",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "format",
      "in": "query",
      "required": false,
      "description": "json (default, includes svg + data URI) or svg (raw image/svg+xml)",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/aspect-ratio-calc": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_aspect_ratio_calc",
    "summary": "Reduce dimensions to an aspect ratio, name the closest standard ratio, scale to a target and map to social-media presets",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "width",
      "in": "query",
      "required": true,
      "description": "Width",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "height",
      "in": "query",
      "required": true,
      "description": "Height",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "target_width",
      "in": "query",
      "required": false,
      "description": "Scale to this width",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "target_height",
      "in": "query",
      "required": false,
      "description": "Scale to this height",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  },
  "/v1/image-meta-inspector": {
   "servers": [
    {
     "url": "https://media.caelaralabs.com"
    }
   ],
   "get": {
    "operationId": "media_image_meta_inspector",
    "summary": "Inspect a remote image: format, dimensions, animation, alpha, size and content type from the file header",
    "tags": [
     "Dynamic Media"
    ],
    "security": [
     {
      "CaelaraKey": []
     },
     {
      "x402USDC": []
     }
    ],
    "parameters": [
     {
      "name": "url",
      "in": "query",
      "required": true,
      "description": "Image URL",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Success. partial:true is returned when an upstream source is unavailable.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "402": {
      "description": "Payment required: x402 USDC on Base, or send a key."
     }
    },
    "x-caelara-tier": "atomic",
    "x-caelara-price-usdc": "0.005"
   }
  }
 }
}
