Get Shopify product recommendations
Get the products a Shopify store recommends beside one product, related or complementary.
Headers
Get your API keyAPI key (`sfk_...`)
The product handle, as it appears in its URL.
min 1 chars · max 255 chars · pattern: ^[^\s/?#]+$
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.
`related` (default) or `complementary`.
one of: related, complementary
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.
The requested product handle.
The recommendation intent of this result.
one of: related, complementary
Recommended products.
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.
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/mens-wool-runners/recommendations?store=www.allbirds.com" \
-H "x-api-key: YOUR_API_KEY"Responses
Products the store recommends beside one product.