{
  "id": "G12",
  "url": "https://cartforagents.com/guides/agent-friendly-ecommerce-api",
  "title": "Agent-friendly ecommerce: when you need an API and when the page is enough",
  "description": "Diagnose the failed retrieval route, compare faithful outputs and use a decision tree before adding an API or machine-readable endpoint.",
  "answer": "Before you build an API or a machine-readable endpoint, find which route the agent used and which field in that route lost the fact; most failures are fixed by putting the fact, with its condition, into the page text and the field that route already carries. Google says AI Overviews and AI Mode need no new machine-readable files or special markup, and Shopify says Shopify Catalog is the authoritative product feed for agentic channels. Build an API only when the answer changes per request or the agent must act, such as cart or checkout, and your platform doesn't already provide it.",
  "take": "Most agent-access problems are a missing field, not a missing API. Fix the field the agent's route already reads; it's cheaper than any new endpoint, and it's the copy the agent actually sees.",
  "summary": "When an agent gets your product wrong, the reflex is to build something new: an API, a JSON endpoint, an llms.txt. Usually the fact is already on your page and simply missing from the field the agent's route reads. Here is a decision tree for finding the smallest fix, and one real product whose specs sat on the page while every structured copy left them out.",
  "claims": [
    {
      "text": "Google says a page must be indexed and eligible to be shown in Search with a snippet to appear as a supporting link in AI Overviews or AI Mode, that there are no additional technical requirements, and that sites do not need to create new machine-readable files, AI text files or markup, or add special schema.org structured data.",
      "source_title": "Google Search Central: AI features and your website",
      "source_url": "https://developers.google.com/search/docs/appearance/ai-features",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Covers AI Overviews and AI Mode in Google Search, not other assistants."
    },
    {
      "text": "Google's list of SEO practices that remain worthwhile for AI features includes making important content available in textual form, making sure structured data matches the visible text on the page, and keeping Merchant Center and Business Profile information up to date.",
      "source_title": "Google Search Central: AI features and your website, SEO best practices",
      "source_url": "https://developers.google.com/search/docs/appearance/ai-features",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Best practices, not ranking factors with weights."
    },
    {
      "text": "Google Shopping help says product recommendations and insights are generated with the help of AI, supported by Google's Shopping data aggregated from brands, stores and other content providers, and that products are ranked based on relevance.",
      "source_title": "Google Shopping Help: Understand how shopping results are generated",
      "source_url": "https://support.google.com/googleshopping/answer/15456476?hl=en",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "High-level description; it does not list which fields are used."
    },
    {
      "text": "Google's Store Quality help says offer-level shipping data overrides account-level data and should include both shipping cost and transit time.",
      "source_title": "Google Merchant Center Help: About the Store Quality program",
      "source_url": "https://support.google.com/merchants/answer/14261098?hl=en",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "About a Merchant Center quality program, not AI features specifically."
    },
    {
      "text": "Shopify says Shopify Catalog is the primary method for agentic storefronts to receive product data, that blocking AI crawlers at robots.txt or the network layer affects only open-web discoverability, and that every store automatically serves /agents.md, /llms.txt and /llms-full.txt, which are separate from Shopify Catalog and do not replace any of its capabilities.",
      "source_title": "Shopify Help Center: Shopify Catalog and product discovery for agentic storefronts",
      "source_url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/products",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Shopify's channels only."
    },
    {
      "text": "Shopify says that if product data such as title and description is stored in custom fields, merchants can use Shopify Catalog Mapping to source that data correctly for agentic storefronts.",
      "source_title": "Shopify Help Center: Shopify Catalog and product discovery for agentic storefronts, product data mapping",
      "source_url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/products",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "We have not seen the Shopify Catalog Mapping screen."
    },
    {
      "text": "Shopify marks the Global Catalog description, technical specifications, top features and unique selling points as Inferred: generated or enriched by Shopify, possibly inaccurate, and to be treated as discovery signals rather than merchant-authored text.",
      "source_title": "Shopify: Global Catalog MCP, Inferred response fields",
      "source_url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Does not say how assistants use these fields."
    },
    {
      "text": "OpenAI's merchant page says a product feed is not required if ChatGPT already crawls a site, but that feeds give merchants greater control over how products appear.",
      "source_title": "OpenAI: ChatGPT merchants, FAQ",
      "source_url": "https://chatgpt.com/merchants/",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Direct feeds are by application; Shopify and Etsy catalogs are already integrated."
    },
    {
      "text": "OpenAI says ChatGPT may generate simplified product titles and descriptions based on information it receives from third-party providers.",
      "source_title": "OpenAI Help Center: Shopping with ChatGPT Search",
      "source_url": "https://help.openai.com/en/articles/11128490-shopping-with-chatgpt-search",
      "source_date": "2026-10-27",
      "method": "documented",
      "limitation": "Does not say which facts are kept."
    },
    {
      "text": "For position 6 of our humidifier catalog search, the product page's visible text stated \"as low as 26dB\", \"215-430 ft2\" and \"Up to 60 hours on low mist setting\", while the page's JSON-LD description, the store's product JSON and the catalog description carried the same two-sentence text with none of those figures.",
      "source_title": "Cart for Agents: four-route check, October 27, 2026 (How we checked, this page)",
      "source_url": "https://cartforagents.com/guides/agent-friendly-ecommerce-api#how-we-checked",
      "source_date": "2026-10-27",
      "method": "observed",
      "limitation": "One product. The catalog record is from October 26 and the page from October 27."
    },
    {
      "text": "Position 6's Shopify-generated spec list gave \"Coverage Area: Up to 430 sq ft\", \"Noise Level: As low as 26 dB\" and \"Runtime: Up to 60 hours\", dropping the page's lower room bound and the low-mist condition on runtime.",
      "source_title": "Cart for Agents: Shopify agent-catalog snapshot, Oct 26, 2026 (How we checked, this page)",
      "source_url": "https://cartforagents.com/guides/agent-friendly-ecommerce-api#how-we-checked",
      "source_date": "2026-10-26",
      "method": "observed",
      "limitation": "We cannot see what Shopify generated these values from."
    },
    {
      "text": "A decibel figure appeared in the description of 4 of the 10 humidifier listings (positions 2, 3, 5 and 7), and in the description or Shopify-generated metadata of 6 of 10 (adding positions 6 and 9); no title had one.",
      "source_title": "Cart for Agents: Receipts cited by our guides (Shopify agent-catalog snapshot, Oct 26, 2026)",
      "source_url": "https://cartforagents.com/research/agent-shopping-research#receipts-cited-by-our-guides",
      "source_date": "2026-10-26",
      "method": "observed",
      "limitation": "One unpersonalized search; six of the ten results came from one seller."
    },
    {
      "text": "In a supplied-snippet simulation, an invented humidifier with vague copy was picked in 3 of 180 Claude sessions, 0 of 60 on GPT-6.1-Sol, 6 of 60 on Gemini 3.8 Flash and 3 of 54 on Gemini 3.1 Pro, against a 25% random baseline; with its facts as a spec line it was picked in 134 of 180, 20 of 60, 19 of 59 and 15 of 55, and on the GPT and Gemini models every time the shopper's brief asked for what it stated.",
      "source_title": "Cart for Agents: Vague vs specific product facts, simulated picks by Claude, GPT and Gemini models",
      "source_url": "https://cartforagents.com/research/vague-specific-product-facts-simulation",
      "source_date": "2026-10-27",
      "method": "controlled-simulation",
      "limitation": "Models chose from snippets we supplied; API models, not live ChatGPT or Gemini shopping."
    }
  ],
  "sources": [
    {
      "title": "Google Search Central: AI features and your website",
      "url": "https://developers.google.com/search/docs/appearance/ai-features",
      "accessed": "2026-10-27"
    },
    {
      "title": "Google Shopping Help: Understand how shopping results are generated",
      "url": "https://support.google.com/googleshopping/answer/15456476?hl=en",
      "accessed": "2026-10-27"
    },
    {
      "title": "Google Merchant Center Help: About the Store Quality program",
      "url": "https://support.google.com/merchants/answer/14261098?hl=en",
      "accessed": "2026-10-27"
    },
    {
      "title": "Shopify Help Center: Shopify Catalog and product discovery for agentic storefronts",
      "url": "https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/products",
      "accessed": "2026-10-27"
    },
    {
      "title": "Shopify: Global Catalog MCP",
      "url": "https://shopify.dev/docs/agents/catalog/global-catalog",
      "accessed": "2026-10-27"
    },
    {
      "title": "OpenAI: ChatGPT merchants",
      "url": "https://chatgpt.com/merchants/",
      "accessed": "2026-10-27"
    },
    {
      "title": "OpenAI Help Center: Shopping with ChatGPT Search",
      "url": "https://help.openai.com/en/articles/11128490-shopping-with-chatgpt-search",
      "accessed": "2026-10-27"
    },
    {
      "title": "Cart for Agents: Receipts cited by our guides",
      "url": "https://cartforagents.com/research/agent-shopping-research#receipts-cited-by-our-guides",
      "accessed": "2026-10-27"
    },
    {
      "title": "Cart for Agents: Vague vs specific product facts, simulated picks by Claude, GPT and Gemini models",
      "url": "https://cartforagents.com/research/vague-specific-product-facts-simulation",
      "accessed": "2026-10-27"
    }
  ],
  "limitations": [
    "Checked on 2026-10-27; re-check before acting. Platform statements about crawling, feeds and discovery files change.",
    "The decision tree is our proposal. It is not an industry standard, and we have not measured whether any fix changes picks, rank or sales in any assistant.",
    "The worked example is one product from one unpersonalized Shopify Catalog search. We fetched its page without running JavaScript; a browser-rendering agent may see more.",
    "We do not see what any assistant retrieves or shows shoppers. \"Route\" here means a documented data path, not an observed assistant request.",
    "Store and brand names are withheld."
  ],
  "related": [
    "https://cartforagents.com/guides/agent-commerce-optimization",
    "https://cartforagents.com/guides/machine-readable-product-data",
    "https://cartforagents.com/guides/product-data-freshness-for-ai",
    "https://cartforagents.com/guides/product-evidence-graph",
    "https://cartforagents.com/guides/agent-ready-product-data",
    "https://cartforagents.com/guides/product-constraint-coverage"
  ],
  "published": "2026-10-27",
  "updated": "2026-10-27",
  "checked": "2026-10-27",
  "kind": "guide"
}