SuggestAPISuggestAPIDocumentation
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 Agent content in the app, then Make your content agent-discoverable, then consult the Agent Gateway and ARD and discovery manifests.