Index onlineMerchant portal
Api Endpoint

Annalist

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.

Open interactive test console

Offering

Provider
api.annalist.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Business And Commerce
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.annalist.dev/v1/commerce/stores
MIME type
application/json
First seen
2026-10-16T13:31:51.689Z
Last seen
Tags
agentic-commerce, ucp, shopping-agents, merchants, checkout

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.01 USDC
Atomic price: 10000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0xDE4805678438b6bfBbFE047fFF305C928653Fe17"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10000",
    "payTo": "8j7NNmuxmobnZh7s4Mn9vsSF1BiiGFDpBHZ2XQxz2TME"
  }
]

Observed health

Status
Healthy
Latest latency
216 ms
Average latency
559 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "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"
        },
        "payment": {
          "type": "string",
          "description": "payment handler, for example google.pay or shop_pay"
        },
        "currency": {
          "type": "string",
          "description": "ISO currency code, for example USD"
        },
        "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"
        },
        "platform": {
          "type": "string",
          "description": "shopify, magento, woocommerce..."
        },
        "limit": {
          "type": "number",
          "description": "1 to 500, default 100"
        }
      }
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "agent_checkout": {
              "description": "ucp, acp or any: only stores with that agent checkout",
              "type": "string"
            },
            "capability": {
              "description": "UCP capability, for example checkout, cart, discount, order, catalog",
              "type": "string"
            },
            "currency": {
              "description": "ISO currency code, for example USD",
              "type": "string"
            },
            "limit": {
              "description": "1 to 500, default 100",
              "type": "number"
            },
            "min_return_days": {
              "description": "only stores publishing a return window at least this long",
              "type": "number"
            },
            "payment": {
              "description": "payment handler, for example google.pay or shop_pay",
              "type": "string"
            },
            "platform": {
              "description": "shopify, magento, woocommerce...",
              "type": "string"
            },
            "ships_to": {
              "description": "ISO country code the store ships to, for example US",
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}