List Shopify collection products
List the products in a Shopify collection with filters, sorting and cursor paging.
Headers
Get your API keyAPI key (`sfk_...`)
The collection 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.
`collection_default`, `best_selling`, `created`, `price` or `title`. A collection cannot be ordered by vendor or product type on Shopify; filter on them instead.
one of: collection_default, best_selling, created, price, title
Reverse the sort order.
Only products with an available variant.
Lowest price to include.
≥ 0 · ≤ 1000000000
Highest price to include.
≥ 0 · ≤ 1000000000
Product type.
max 255 chars
The product vendor to filter by.
max 255 chars
The product tag to filter by.
max 255 chars
Rows per page, 1 to 250. Default: 50.
≥ 1 · ≤ 250
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 4096 chars
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 collection when found; null otherwise.
Collection id.
Collection handle.
Collection title.
Products on this page.
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.
The collection's filter facets.
Filter id.
Label.
`LIST`, `PRICE_RANGE` or `BOOLEAN`.
How the store presents it, e.g. `TEXT`.
Facet values.
Filter value id.
Label.
Matching products.
The store's own filter input as JSON, e.g. `{"available":true}`.
Colour swatch where given.
Hex colour.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
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/collections/general-clothes-example-products/products?store=000000band.myshopify.com" \
-H "x-api-key: YOUR_API_KEY"Responses
Shopify collection products with filter facets.