# Babajaga.sk

> Babajaga.sk is an OpenCart store. This file describes the machine-readable API
> available for AI agents and crawlers. Use the structured JSON endpoints below
> instead of scraping HTML pages for better accuracy and efficiency.

## AI API Endpoints

- [Store Info](https://babajaga.sk/ecomaibridge/ai/store.json): Store metadata — name, currency, platform, product count, and capabilities.
- [Product Catalog](https://babajaga.sk/ecomaibridge/ai/products.json): Full product listing. Supports ?limit=, ?offset=, ?category=, ?mode=compact|summary|full.
- [Search Products](https://babajaga.sk/ecomaibridge/ai/products.json?search={query}): Search products by name, description, or SKU.
- [Categories](https://babajaga.sk/ecomaibridge/ai/categories.json): Full product category tree.
- [Tool Definitions](https://babajaga.sk/ecomaibridge/ai/tools.json): JSON Schema tool definitions for AI agents (Anthropic/OpenAI tool-use compatible).
- [Discovery Manifest](https://babajaga.sk/.well-known/ai-bridge.json): Full machine-readable manifest — endpoints, authentication, capabilities, and response modes.
- [API Status](https://babajaga.sk/ecomaibridge/ai/status.json): Live status check — platform, version, cache state.

## Authentication

Read endpoints (products, categories, store info, search) require no authentication.
Write/action endpoints require an API key via the X-API-Key header.

## Response Modes

All product endpoints support a ?mode= parameter:
- compact: Minimal fields, most token-efficient. Recommended for AI agents.
- summary: Key fields — title, price, availability, URL.
- full: All product data including images, description, SKU, and attributes.

## Notes

- All responses are JSON.
- This API is served by EcomAIBridge for OpenCart — an AI middleware layer.
- For full tool-use schemas consumable by Claude, GPT, or other agents, fetch: https://babajaga.sk/ecomaibridge/ai/tools.json