Shopify 搜索 API
Search one public Shopify store's products by keyword with the store's own search and get its top matches with title, vendor, type, tags, price range, sale price, stock and images. A domain that is not a public Shopify store comes back not found.
价格
Shopify 搜索 API 价格
试一试
一个请求获取 Shopify 搜索
{
"data": {
"items": [
{
"currency": "USD",
"handle": "alex_rivera",
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"inStock": true,
"listPrice": 19.99,
"onSale": true,
"price": 19.99,
"priceMax": 19.99,
"productId": "a1b2c3d4",
"productType": "general",
"tags": [
"example"
],
"title": "Example title",
"url": "https://example.com/page",
"vendor": "example"
}
]
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-10-25 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- querystring
wool
Search keywords, e.g. "wool" or "hoodie".
- storestring
allbirds.com
Domain or URL of a public Shopify store, e.g. allbirds.com or https://kith.com. A store on its own domain is addressed by that domain.
响应
JSON，每个字段一个示例值。
The store's top matches for the query, in its own order; Shopify's store search returns at most 10. Populated whenever the provider has data for the entity.
- currencystring
Price currency code, e.g. "USD", or null when the store does not state it.
- handlestring
Product handle, the slug after /products/ in the product URL; pass it to the Shopify Product SKU for the full product. Populated whenever the provider has data for the entity.
- imagestring
Main product image URL, or null when the product has no image. Populated whenever the provider has data for the entity.
- imagesstring[]
All product image URLs, main image first; empty when the product has none. Populated whenever the provider has data for the entity.
- inStockboolean
True when at least one variant can be bought now. Populated whenever the provider has data for the entity.
- listPricenumber
Lowest regular (compare-at) price when the product is on sale, or null when it is not discounted.
- onSaleboolean
True when at least one variant is priced below its regular price. Populated whenever the provider has data for the entity.
- pricenumber
Lowest variant price in the store's currency. Populated whenever the provider has data for the entity.
- priceMaxnumber
Highest variant price in the store's currency; equals price when every variant costs the same. Populated whenever the provider has data for the entity.
- productIdstring
Shopify product id. Populated whenever the provider has data for the entity.
- productTypestring
Product type the store assigns, e.g. "Shoes", or null when it sets none.
- tagsstring[]
Tags the store attaches to the product, as the store writes them; empty when it has none. Populated whenever the provider has data for the entity.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
Product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
- vendorstring
Vendor (brand) the store lists the product under, or null when it sets none. Populated whenever the provider has data for the entity.
- foundboolean
True when results were found.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 Shopify 搜索 API
AnyAPI 的 Shopify 搜索 API 只需一次 POST 请求 /v1/run/shopify.search，就以统一格式的 JSON 返回 Shopify 数据。Search one public Shopify store's products by keyword with the store's own search and get its top matches with title, vendor, type, tags, price range, sale price, stock and images. A domain that is not a public Shopify store comes back not found.无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$0.85 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Shopify 搜索 API 调用中有 100.0% 成功，响应时间中位数为 1.8 秒，共测量 1 次调用。