{
  "name": "Aastik Product Intelligence",
  "description": "Merchant-neutral product intelligence and commerce interfaces for AI shopping agents. Discover, understand, compare and evaluate products, then retrieve normalized purchase options.",
  "version": "1.0.0",
  "api_version": "v1",
  "base_path": "/api/public/agent/v1",
  "protocol_neutral": true,
  "openapi": "https://aastik.club/api/public/agent/v1/openapi",
  "feeds": {
    "products_json": "https://aastik.club/api/public/feed/products",
    "products_csv": "https://aastik.club/api/public/feed/products?format=csv"
  },
  "capabilities": [
    {
      "name": "search",
      "method": "GET|POST",
      "path": "/api/public/agent/v1/search",
      "description": "Natural-language product search with extracted constraints and ranked, explained results."
    },
    {
      "name": "products",
      "method": "GET",
      "path": "/api/public/agent/v1/products",
      "description": "List and filter the catalog with limit/offset pagination."
    },
    {
      "name": "product",
      "method": "GET",
      "path": "/api/public/agent/v1/products/{id}",
      "description": "Full product intelligence for one product, including provenance."
    },
    {
      "name": "compare",
      "method": "GET",
      "path": "/api/public/agent/v1/compare",
      "description": "Side-by-side attribute matrix for 2-6 products."
    },
    {
      "name": "categories",
      "method": "GET",
      "path": "/api/public/agent/v1/categories",
      "description": "Category taxonomy."
    },
    {
      "name": "offers",
      "method": "GET",
      "path": "/api/public/agent/v1/offers",
      "description": "Prices, currency, availability and verification time."
    },
    {
      "name": "purchase_options",
      "method": "GET",
      "path": "/api/public/agent/v1/purchase-options",
      "description": "Normalized purchase options with merchant, purchase type and destination."
    },
    {
      "name": "checkout",
      "method": "POST",
      "path": "/api/public/agent/v1/checkout",
      "description": "First-party checkout for owned digital products. Currently not connected."
    }
  ],
  "purchase_types": [
    "external_affiliate",
    "external_direct",
    "first_party_checkout"
  ],
  "rate_limit": {
    "requests": 120,
    "window_seconds": 60,
    "scope": "per_ip"
  },
  "authentication": {
    "required": false,
    "note": "Public read access requires no key. An API-key field is reserved for future commercial tiers."
  },
  "disclosure": "Independent product research. External purchases complete on merchant sites and may earn Aastik a commission. Amazon and other merchants do not sponsor, endorse, operate or officially partner with Aastik.",
  "data_policy": "Only verified stored values are returned. Absent or expired prices, ratings and availability are returned as null rather than estimated."
}