Shopify Public Catalog Search
Search a live public Shopify storefront and return current public products, variants, prices, availability, images, and declared agent-commerce capabilities.
Preview request
The preview path is rate-limited and does not charge. It executes the live source and returns the paid response shape while withholding decision-ready values. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.
curl --request GET \ "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/shopify_store_lookup?preview=true&domain=smallcrewmerch.com&query=custom+logo+shirt&limit=5"
Input contract
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Domain name of the Shopify store. |
query | string | No | Optional product search query. |
limit | integer | No | Maximum matching products to return, from 1 to 20. |
Example deliverable
This is the documented response shape, not a promise that live values will match the example. The paid request returns current or declared-source results using the same contract.
{
"success": true,
"source": [
"public Shopify products.json",
"public storefront metadata"
],
"fetched_at": "2026-08-07T07:32:36.237Z",
"domain": "smallcrewmerch.com",
"query": "custom logo shirt",
"products_scanned": 6,
"scan_truncated": false,
"matches_returned": 2,
"currency": "USD",
"agent_commerce": {
"available": true,
"version": "2026-04-08",
"services": [
"dev.ucp.shopping"
],
"capabilities": [
"dev.ucp.shopping.checkout",
"dev.ucp.shopping.fulfillment"
],
"payment_handlers": [
"com.google.pay",
"dev.shopify.card"
]
},
"products": [
{
"id": "10357626175768",
"title": "Custom Logo T-Shirt - Your Logo, No Minimum",
"handle": "custom-logo-t-shirt-your-logo-no-minimum",
"url": "https://smallcrewmerch.com/products/custom-logo-t-shirt-your-logo-no-minimum",
"vendor": "Small Crew",
"product_type": "Custom Apparel",
"tags": [
"b2b",
"business apparel"
],
"description": "Soft, heavyweight cotton tee printed with your business logo. Order one or a hundred - the price per shirt doesn't change. Why shops order from us: No minimum order and no screen setup fee Free digital proof before we print anything Free US shipping on every order Reorder a single shirt for a new hi...",
"published_at": "2026-07-27T19:30:16-07:00",
"updated_at": "2026-08-07T00:32:35-07:00",
"currency": "USD",
"price_min": "28.00",
"price_max": "30.00",
"variants_total": 5,
"variants_available": 5,
"variants": [
{
"id": "52449485783320",
"title": "S",
"sku": "SC-TEE-S",
"price": "28.00",
"compare_at_price": null,
"available": true,
"options": [
"S"
]
},
{
"id": "52449485816088",
"title": "M",
"sku": "SC-TEE-M",
"price": "28.00",
"compare_at_price": null,
"available": true,
"options": [
"M"
]
}
],
"variants_truncated": false,
"images": [
{
"url": "https://cdn.shopify.com/s/files/1/0989/1708/9560/files/66d952e50dea28254a0d1543.png?v=1785205723",
"width": 2048,
"height": 2048
},
{
"url": "https://cdn.shopify.com/s/files/1/0989/1708/9560/files/688c5eb775e87e8cd604de32.png?v=1785205723",
"width": 2048,
"height": 2048
}
]
},
{
"id": "10357626372376",
"title": "Custom Logo Crewneck Sweatshirt",
"handle": "custom-logo-crewneck-sweatshirt",
"url": "https://smallcrewmerch.com/products/custom-logo-crewneck-sweatshirt",
"vendor": "Small Crew",
"product_type": "Custom Apparel",
"tags": [
"b2b",
"business apparel"
],
"description": "Classic crewneck sweatshirt with your logo. Warmer than a tee, less bulky than a hoodie, and it photographs well for your own marketing. Why shops order from us: No minimum order and no screen setup fee Free digital proof before we print anything Free US shipping on every order Reorder anytime at th...",
"published_at": "2026-07-27T19:30:17-07:00",
"updated_at": "2026-08-07T00:32:35-07:00",
"currency": "USD",
"price_min": "56.00",
"price_max": "62.00",
"variants_total": 5,
"variants_available": 5,
"variants": [
{
"id": "52449486373144",
"title": "S",
"sku": "SC-CREW-S",
"price": "56.00",
"compare_at_price": null,
"available": true,
"options": [
"S"
]
},
{
"id": "52449486405912",
"title": "M",
"sku": "SC-CREW-M",
"price": "56.00",
"compare_at_price": null,
"available": true,
"options": [
"M"
]
}
],
"variants_truncated": false,
"images": [
{
"url": "https://cdn.shopify.com/s/files/1/0989/1708/9560/files/66cdb7192e67fb0f8a044613.png?v=1785205724",
"width": 2048,
"height": 2048
},
{
"url": "https://cdn.shopify.com/s/files/1/0989/1708/9560/files/66cdb71d0c3dcef30909e194.png?v=1785205724",
"width": 2048,
"height": 2048
}
]
}
],
"source_urls": {
"catalog": "https://smallcrewmerch.com/products.json?limit=100",
"storefront": "https://smallcrewmerch.com/",
"ucp_profile": "https://smallcrewmerch.com/.well-known/ucp"
},
"caveat": "This product returns public storefront catalog data only. It does not estimate private traffic, revenue, sales, installed apps, or theme details.",
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "public Shopify products.json, storefront metadata, and UCP merchant profile"
}
}Purchase decision
Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.01 USDC is within the buyer's authorized per-request limit.
Skip when: a cached result is sufficient, the source or fields do not satisfy the task, or the buyer has not authorized payment. Do not bypass wallet, budget, or user-approval policy.
Guaranteed response metadata
Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract. The preview proves the live source and field types without returning the paid values.
{
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "public Shopify products.json, storefront metadata, and UCP merchant profile"
}
}Agent payment flow
Fast path: install the public MCP package, configure a dedicated low-balance Base buyer wallet and a maximum per-request spend, then call this tool with auto_pay: true. The client handles the challenge, local signature, settlement, and retry in one tool call.
npx -y dopaminedesk-ai-data-marketplace-mcp
X402_AUTO_PAY=true
X402_EVM_PRIVATE_KEY=<dedicated buyer wallet key>
X402_MAX_PAYMENT_USDC=0.25
tool input: { "auto_pay": true }Manual path: request the product, read the base64 PAYMENT-REQUIRED challenge, sign with any compatible x402 v2 client, and retry with PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.