SuggestAPIDocumentation
Contact usOpen app
Agent Discovery

What Is Agent Discovery?

Learn how SuggestAPI makes a merchant domain and its content discoverable to agents without changing the existing commerce stack.

Copy page
Open in ChatGPTOpen with page contextOpen in ClaudeOpen with page context

Agent Discovery is a SuggestAPI capability, not an API. It makes a merchant domain and its published knowledge discoverable to agents while keeping the existing website, cart, checkout, and payment stack in place.

Agents use the published domain surface to understand what a merchant offers and to retrieve products, content, and policies. The individual gateway endpoints support that capability, but Agent Discovery itself is the publishing, discovery, and retrieval experience—not a standalone API product.

Architecture

Surface Role
https://api.suggestapi.com Core index management, ingestion, search, and ranking.
https://agent.suggestapi.com/oks/{domain} A domain-scoped knowledge surface for products, collections, content, policies, and plugin-style search.
https://agent.suggestapi.com/v1/agent/* Agent workflows that build on retrieval: answer-oriented search, product lookup, comparison, recommendations, and safe cart/checkout handoffs.
ARD catalog Capability discovery. It tells agents what a gateway or domain can do; it does not search a merchant’s inventory.

The domain is normally the merchant domain name. Start at GET /oks/{domain} to discover that domain’s available paths, capabilities, limits, and supported retrieval modes.

Two retrieval layers

Use the domain surface for straightforward retrieval:

  • GET /oks/{domain}/search searches products and other domain knowledge objects.
  • GET /oks/{domain}/products, /collections, /content, and /policies retrieve canonical domain objects.

Use /v1/agent/* when the task needs orchestration above retrieval, such as comparing selected products, generating a recommendation, or preparing a native commerce handoff. These endpoints return handoff metadata; they do not bypass or replace the merchant’s cart, checkout, or payment flow.

Start here

  1. Index the domain’s products and agent-relevant content in SuggestAPI.
  2. Verify GET https://agent.suggestapi.com/oks/{domain} returns the expected domain metadata.
  3. Call the domain search endpoint with mode=hybrid for the preferred full-result retrieval path.
  4. Publish the domain catalog link on the merchant origin so agents can discover its capabilities.

Continue with Make your content agent-discoverable, then consult the Agent Gateway and ARD and discovery manifests.