Get several Shopify products
Get up to 25 Shopify products by handle in one call.
Headers
Get your API keyAPI key (`sfk_...`)
The store's domain, for example `allbirds.com`, `www.allbirds.com` or `weareallbirds.myshopify.com`. A full URL is accepted and reduced to its host. Only public storefront hosts are accepted.
Product handles, comma-separated, 1 to 25. Duplicates are dropped and order is kept.
ISO 3166-1 alpha-2 country used for prices, currency and language, e.g. `GB`. Default: the store's own market.
Two-letter language code, e.g. `EN`. Default: the store's own language.
Endpoint-specific response payload.
`found` on success; `not_found` when it does not exist or is not a Shopify store; `private` when the storefront is password-protected; `restricted` when the store is paused or frozen.
one of: found, not_found, private, restricted
The store host that was requested.
One entry per requested handle, in request order.
The requested handle.
Whether that handle resolved.
one of: found, not_found
The product when found; null otherwise.
Numeric product id as a string.
The store's global product id; null when the store does not publish it for this row.
Product handle.
Product page URL.
Product title.
Vendor.
Product type.
Tags.
Whether any variant is available.
Last update, ISO 8601 UTC.
Lowest and highest variant price.
An amount and its currency.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
An amount and its currency.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
Lowest and highest compare-at price.
An amount and its currency.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
An amount and its currency.
The amount as a decimal number.
ISO 4217 currency code, e.g. `USD`.
The main image; null when the product has none.
Image id; null when the store does not publish it for this row.
Image URL.
Alt text the merchant set.
Pixel width.
Pixel height.
Variants the image belongs to; empty when not given.
Counts for this batch.
Handles requested.
Handles that resolved.
Handles that did not.
Notes about the answer, e.g. a requested market the store does not price in and the market it used instead.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/shopify/products/batch?store=www.allbirds.com&handles=mens-wool-runners,mens-tree-runners" \
-H "x-api-key: YOUR_API_KEY"Responses
Shopify products by handle with a found and not-found summary.