Shopify

List Shopify store products

List a Shopify store's products with the store's own query syntax, sorting and cursor paging.

GET/v1/shopify/products
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
11
storestringrequiredquery

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.

querystringoptionalquery

The store's own product query, e.g. `product_type:Shoes AND tag:sale`.

max 1024 chars

sortstringoptionalquery

Order: `best_selling`, `created`, `updated`, `price`, `title`, `vendor`, `product_type` or `relevance`. `relevance` needs the `query` parameter. Default: the store's own order.

one of: best_selling, created, updated, price, title, vendor, product_type, relevance

reversebooleanoptionalquery

Reverse the sort order.

availablebooleanoptionalquery

Only products with an available variant.

createdAfterstringoptionalquery

Only products created at or after this time, as an ISO 8601 date or time (such as `2026-01-31`) or epoch seconds. A time with no zone is UTC.

createdBeforestringoptionalquery

Only products created before this time, as an ISO 8601 date or time (such as `2026-01-31`) or epoch seconds. A time with no zone is UTC.

limitintegeroptionalquery

Rows per page, 1 to 250. Default: 50.

≥ 1 · ≤ 250

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 4096 chars

countrystringoptionalquery

ISO 3166-1 alpha-2 country used for prices, currency and language, e.g. `GB`. Default: the store's own market.

languagestringoptionalquery

Two-letter language code, e.g. `EN`. Default: the store's own language.

Response fields
47

Endpoint-specific response payload.

datalookupStatus
string

`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

datastore
string

The store host that was requested.

Products on this page.

dataproducts[]id
string

Numeric product id as a string.

dataproducts[]gid
stringnullable

The store's global product id; null when the store does not publish it for this row.

dataproducts[]handle
string

Product handle.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]title
string

Product title.

dataproducts[]vendor
stringnullable

Vendor.

dataproducts[]productType
stringnullable

Product type.

Tags.

dataproducts[]tags[]
stringoptional
dataproducts[]availableForSale
booleannullable

Whether any variant is available.

dataproducts[]updatedAt
stringnullable

Last update, ISO 8601 UTC.

Lowest and highest variant price.

An amount and its currency.

dataproducts[]priceRangeminamount
numbernullable

The amount as a decimal number.

dataproducts[]priceRangemincurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

An amount and its currency.

dataproducts[]priceRangemaxamount
numbernullable

The amount as a decimal number.

dataproducts[]priceRangemaxcurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

Lowest and highest compare-at price.

An amount and its currency.

dataproducts[]compareAtPriceRangeminamount
numbernullable

The amount as a decimal number.

dataproducts[]compareAtPriceRangemincurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

An amount and its currency.

dataproducts[]compareAtPriceRangemaxamount
numbernullable

The amount as a decimal number.

dataproducts[]compareAtPriceRangemaxcurrency
stringnullable

ISO 4217 currency code, e.g. `USD`.

The main image; null when the product has none.

dataproducts[]featuredImageid
stringnullable

Image id; null when the store does not publish it for this row.

dataproducts[]featuredImageurl
stringnullable

Image URL.

dataproducts[]featuredImagealtText
stringnullable

Alt text the merchant set.

dataproducts[]featuredImagewidth
integernullable

Pixel width.

dataproducts[]featuredImageheight
integernullable

Pixel height.

Variants the image belongs to; empty when not given.

dataproducts[]featuredImagevariantIds[]
stringoptional

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

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.

datawarnings[]
stringoptional
datatruncated
boolean

True when the list stopped at the 25,000-item list limit. Use `createdBefore` to reach the rest.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/shopify/products?store=www.allbirds.com" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Shopify product summaries.