{
  "slug": "how-to-get-your-api-discovered-by-ai-agents",
  "title": "How do I get my API discovered by AI agents?",
  "description": "Agents search indexes rather than browse websites, so an API is found through Coinbase's Bazaar, x402scan and directories, and through a description that names the task.",
  "lead": "Agents do not browse websites. They search indexes, so discovery means being in the indexes agents query and describing the endpoint in the words they search for.",
  "reviewed": "2026-10-29",
  "next_step": "The pages below go deeper on this question.",
  "primary_label": "Check Bazaar retrieval for your endpoint",
  "primary_path": "/tools/coinbase-bazaar-readiness?utm_content=discovery_guide",
  "secondary_label": "Publish an Ontario service profile",
  "secondary_path": "/guides/publish-x402-api-profile-readiness-badge?utm_content=discovery_guide",
  "sections": [
    {
      "heading": "1. Coinbase Bazaar",
      "paragraphs": [
        "Coinbase's Bazaar is the catalog of x402 endpoints discovered by the CDP facilitator. It is exposed through CDP APIs, the Bazaar MCP server and Amazon Bedrock AgentCore, and browsable by people on agentic.market. There is no registration form: a route built with the CDP SDK carries a Bazaar declaration, and the first paid call settled through the facilitator triggers indexing.",
        "Coinbase's POST /v2/x402/validate endpoint reports, for a given URL, whether it is reachable, returns a 402 and carries the Bazaar extension, and gives a simulated accept or reject decision. It performs no payment and does not index the resource, so a seller can see the result of the setup before the first paid call."
      ]
    },
    {
      "heading": "2. x402scan and directories",
      "paragraphs": [
        "x402scan indexes a domain's x402 endpoints from its OpenAPI file once the domain is registered there. agentic.market is the human view of the Bazaar. Directories such as nohumans.directory list endpoints and can run paid test calls against them. Each index is read by a different set of agents, so being in several of them widens the set that can find the endpoint."
      ]
    },
    {
      "heading": "3. Write the description for the search box",
      "paragraphs": [
        "Bazaar search is text matching on the listing's description. A description that starts with the task in plain words, such as 'Which x402 API should my agent call for this task?', matches queries that a brand name does not. Agents match on the words they type.",
        "Coinbase recommends explicit input schemas and output examples for any route that takes parameters; without them an agent can find the endpoint but cannot construct a valid call. The price and network are part of the description an agent reads."
      ]
    },
    {
      "heading": "A free way to see what agents see",
      "paragraphs": [
        "Ontario's Bazaar readiness check runs one public buyer task against the Bazaar search and reports whether the endpoint is returned for it, together with the observable blockers in its 402 response and metadata. It is free, it does not pay the endpoint, and its result is not Coinbase certification."
      ]
    }
  ],
  "sources": [
    {
      "label": "Coinbase: get discovered in the Bazaar",
      "url": "https://docs.cdp.coinbase.com/x402/seller/get-discovered"
    },
    {
      "label": "Coinbase: validate an x402 endpoint (API reference)",
      "url": "https://docs.cdp.coinbase.com/api-reference/v2/rest-api/x402-facilitator/validate-x402-endpoint"
    },
    {
      "label": "x402scan",
      "url": "https://www.x402scan.com/"
    },
    {
      "label": "Ontario: Bazaar buyer-intent gap checker",
      "url": "https://ontarioprotocol.com/tools/coinbase-bazaar-readiness"
    }
  ]
}