{"uid":"cap_Y3d91-Y01DRaPfZMXw9Du","slug":"annalist-commerce-store-directory-9387e7f6","name":"Annalist Commerce Store Directory","description":"Stores from our weekly census of 65,000 top sites, filtered by what a shopping agent needs: ships to a country, UCP agent checkout and its capabilities, payment handlers (Google Pay, Shop Pay), currency, return window. Facts from each store's own machine-readable files, never its policy pages. Most visited first. Signed.","url":"https://api.annalist.dev/v1/commerce/stores?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"number","description":"1 to 500, default 100"},"payment":{"type":"string","description":"payment handler, for example google.pay or shop_pay"},"currency":{"type":"string","description":"ISO currency code, for example USD"},"platform":{"type":"string","description":"shopify, magento, woocommerce..."},"ships_to":{"type":"string","description":"ISO country code the store ships to, for example US"},"capability":{"type":"string","description":"UCP capability, for example checkout, cart, discount, order, catalog"},"agent_checkout":{"type":"string","description":"ucp, acp or any: only stores with that agent checkout"},"min_return_days":{"type":"number","description":"only stores publishing a return window at least this long"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BcTlHeGp8fb7EoaaLqvf3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a filtered list of top e-commerce stores ranked by traffic, with machine-readable facts about agent checkout support, payment handlers, shipping destinations, currency, and return windows.","exampleAgentPrompt":"Find me the top 50 Shopify stores that ship to the US, support UCP agent checkout with cart and checkout capabilities, and accept Google Pay — I want stores with at least a 30-day return window.","exampleUseCases":[{"title":"Shopping agent store discovery","prompt":"I'm building a shopping agent that needs to check out autonomously — find me the top 100 stores that support UCP agent checkout with checkout capability, ship to the US, and accept USD."},{"title":"Google Pay compatible store list","prompt":"Which high-traffic e-commerce stores accept Google Pay, ship to the UK, and have a return window of at least 14 days? Give me up to 200 results."},{"title":"Platform-specific agent commerce audit","prompt":"Show me the top WooCommerce stores that have any kind of agent checkout support and ship to Canada, so I can figure out which ones my purchasing agent can work with autonomously."}],"resultDescription":"A ranked list (most-visited first) of e-commerce stores matching the requested filters, each record containing machine-readable facts: agent checkout type and UCP capabilities, supported payment handlers, accepted currencies, shipping destinations, return window in days, and e-commerce platform. All records are signed by Annalist.","failureModes":["Invalid ISO country code for ships_to returns empty results or validation error","Unknown payment handler string may return no matches","limit outside 1–500 range returns error","Querying capability or agent_checkout values not in the supported enum may return 0 results","Store data may be up to one week stale (weekly census)","Rate limiting or payment failure returns 402 if USDC payment not provided"],"whenToPreferThis":"Use this endpoint when an AI shopping agent needs to discover real e-commerce stores that are provably compatible with autonomous checkout, filtered by shipping region, payment method, or platform — especially when you need machine-verified facts from stores' own files rather than scraped policy pages. Prefer this over generic store directories when agent checkout compatibility (UCP/ACP) is a hard requirement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:41:48.085Z","isFirstParty":false,"canonicalSlug":"annalist-commerce-store-directory-9387e7f6"}