{
  "specVersion": "1.0",
  "host": {
    "displayName": "SuggestAPI Knowledge Gateway",
    "identifier": "did:web:agent.suggestapi.com",
    "documentationUrl": "https://agent.suggestapi.com/AGENTS.md",
    "logoUrl": "https://agent.suggestapi.com/favicon-96x96.png"
  },
  "entries": [
    {
      "identifier": "urn:air:agent.suggestapi.com:registry:knowledge-gateway",
      "displayName": "SuggestAPI Agent Registry",
      "type": "application/ai-registry+json",
      "url": "https://agent.suggestapi.com/ard/v1/",
      "description": "ARD registry for discovering SuggestAPI commerce search, compare, recommendation, and checkout handoff capabilities.",
      "tags": [
        "registry",
        "discovery",
        "commerce",
        "search"
      ],
      "capabilities": [
        "capability discovery",
        "search",
        "autocomplete",
        "semantic search",
        "product lookup",
        "knowledge retrieval",
        "compare",
        "recommend",
        "cart handoff",
        "checkout handoff"
      ],
      "representativeQueries": [
        "find a product search API for an existing storefront",
        "discover a tool that searches merchant products and content",
        "find a safe cart or checkout handoff capability"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-07-16T00:00:00.000Z",
      "metadata": {
        "authentication": "none",
        "ard": {
          "search": true,
          "explore": true,
          "list": false,
          "federationModes": [
            "none"
          ],
          "defaultFederation": "none"
        },
        "capabilityIds": [
          "capability_discovery",
          "search",
          "autocomplete",
          "semantic_search",
          "product_lookup",
          "knowledge_retrieval",
          "compare",
          "recommend",
          "cart_handoff",
          "checkout_handoff"
        ],
        "commerce_execution": {
          "cart_mode": "handoff_only",
          "checkout_mode": "platform_native",
          "payment_mode": "platform_native",
          "do_not_interfere": true
        },
        "mcpSupported": false,
        "skillsSupported": false,
        "ucpSupported": false
      }
    },
    {
      "identifier": "urn:air:agent.suggestapi.com:gateway:tenant-search",
      "displayName": "Tenant Search Surface",
      "type": "application/openapi+yaml",
      "url": "https://agent.suggestapi.com/openapi.yaml",
      "description": "Tenant-scoped product and content search via GET /oks/{tenant}/search with plugin-friendly retrieval modes.",
      "tags": [
        "search",
        "tenant",
        "products",
        "plugin"
      ],
      "capabilities": [
        "search",
        "autocomplete",
        "semantic search",
        "product lookup",
        "knowledge retrieval"
      ],
      "representativeQueries": [
        "find black boots under $200",
        "show all 55-inch Samsung TVs",
        "search products by SKU",
        "find manuals for a Bosch dishwasher",
        "find articles about SEO"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-07-16T00:00:00.000Z",
      "metadata": {
        "operationId": "searchTenantSurface",
        "method": "GET",
        "path": "/oks/{tenant}/search",
        "capabilityIds": [
          "search",
          "autocomplete",
          "semantic_search",
          "product_lookup",
          "knowledge_retrieval"
        ]
      }
    },
    {
      "identifier": "urn:air:agent.suggestapi.com:gateway:agent-search",
      "displayName": "Agent Search Orchestration",
      "type": "application/openapi+yaml",
      "url": "https://agent.suggestapi.com/openapi.yaml",
      "description": "Higher-level search orchestration for assistants, including retrieval, answer synthesis, and policy-aware reasoning.",
      "tags": [
        "agent",
        "search",
        "orchestration",
        "answers"
      ],
      "capabilities": [
        "search",
        "semantic search",
        "product lookup",
        "knowledge retrieval",
        "compare",
        "recommend"
      ],
      "representativeQueries": [
        "find black boots under $200 and explain the best match",
        "show all 55-inch Samsung TVs and compare them",
        "search products by SKU and retrieve the canonical product record",
        "find manuals for a Bosch dishwasher and cite the source",
        "find articles about SEO and summarize the guidance"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-07-16T00:00:00.000Z",
      "metadata": {
        "operationId": "agentSearch",
        "method": "POST",
        "path": "/v1/agent/search",
        "capabilityIds": [
          "search",
          "semantic_search",
          "product_lookup",
          "knowledge_retrieval",
          "compare",
          "recommend"
        ]
      }
    },
    {
      "identifier": "urn:air:agent.suggestapi.com:gateway:agent-cart",
      "displayName": "Agent Cart Handoff",
      "type": "application/openapi+yaml",
      "url": "https://agent.suggestapi.com/openapi.yaml",
      "description": "Accepts line items and returns links to the merchant's existing product, cart, and checkout resources without binding to a specific commerce platform.",
      "tags": [
        "cart",
        "checkout",
        "commerce",
        "handoff"
      ],
      "capabilities": [
        "cart",
        "cart_handoff",
        "checkout_handoff"
      ],
      "representativeQueries": [
        "prepare a cart handoff for these products",
        "find a commerce tool that points me to the existing cart flow"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-07-16T00:00:00.000Z",
      "metadata": {
        "operationId": "agentCart",
        "method": "POST",
        "path": "/v1/agent/cart",
        "executesCheckout": false,
        "executesAddToCart": false,
        "capabilityIds": [
          "cart_handoff",
          "checkout_handoff"
        ],
        "commerce_execution": {
          "cart_mode": "handoff_only",
          "checkout_mode": "platform_native",
          "payment_mode": "platform_native",
          "do_not_interfere": true
        }
      }
    },
    {
      "identifier": "urn:air:agent.suggestapi.com:gateway:guided-checkout",
      "displayName": "Guided Checkout Handoff",
      "type": "application/openapi+yaml",
      "url": "https://agent.suggestapi.com/openapi.yaml",
      "description": "Builds a safe checkout handoff plan for selected items. This surface does not execute add-to-cart or checkout directly.",
      "tags": [
        "checkout",
        "handoff",
        "commerce",
        "cart"
      ],
      "capabilities": [
        "handoff"
      ],
      "representativeQueries": [
        "prepare a checkout handoff for these items",
        "find a commerce tool that can guide checkout without placing the order"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-07-16T00:00:00.000Z",
      "metadata": {
        "operationId": "agentGuidedCheckout",
        "method": "POST",
        "path": "/v1/agent/checkout/guide",
        "executesCheckout": false,
        "executesAddToCart": false,
        "capabilityIds": [
          "guided_checkout",
          "checkout_handoff"
        ],
        "commerce_execution": {
          "cart_mode": "handoff_only",
          "checkout_mode": "platform_native",
          "payment_mode": "platform_native",
          "do_not_interfere": true
        }
      }
    }
  ]
}